一、bootstrap-suggest

这是一个基于 bootstrap 按钮式下拉菜单组件的搜索建议插件，必须使用于按钮式下拉菜单组件上。
示例地址：http://lzw.me/pages/demo/bootstrap-suggest-plugin/demo/
插件源码：https://github.com/veenter/bootstrap-suggest-plugin

1.1 功能说明

搜索方式：从 data.value 的有效字段数据中查询 keyword 的出现，或字段数据包含于 keyword 中
支持单关键字、多关键字的输入搜索建议，多关键字可自定义分隔符
支持按 data 数组数据搜索、按 URL 请求搜索和按首次请求URL数据并缓存搜索三种方式
单关键字会设置 data-id 和输入框内容两个值，以 indexId/idField 和 indexKey/idFiled 取值 data 的数据为准；多关键字只设置输入框值

1.2 实现效果：

1.3 方法调用

1、禁用提示： $("input#test").bsSuggest("disable");
2、启用提示： $("input#test").bsSuggest("enable");
3、销毁插件： $("input#test").bsSuggest("destroy");
4、查看版本：$("input#test").bsSuggest("version");

1.4 事件监听

1、onDataRequestSuccess: 当 AJAX 请求数据成功时触发，并传回结果到第二个参数
2、onSetSelectValue：当从下拉菜单选取值时触发，并传回设置的数据到第二个参数
3、onUnsetSelectValue：当设置了 idField，且自由输入内容时触发（与背景警告色显示同步）
4、onShowDropdown：下拉菜单显示时触发
5、onHideDropdown：下拉菜单隐藏式触发

1.5 完整代码实现：

1、引入 jQuery、bootstrap.min.css、bootstrap.min.js
2、引入插件js: bootstrap-suggest.min.js

1.5.1 前端关键代码：

   <label class="col-sm-2 control-label">油井编号(插件测试):</label><div class="col-sm-4 controls"><div class="input-group"><input type="text" class="form-control" id="wellId_test" name="wellInfo.wellId"><div class="input-group-btn"><button type="button" class="btn btn-white dropdown-toggle"data-toggle="dropdown"><span class="caret"></span></button><ul class="dropdown-menu dropdown-menu-right" role="menu"></ul></div></div></div>

1.5.2 js代码：

//bootstrap-suggest插件根据用户身份加载油井$("#wellId_test").bsSuggest('init',{clearable:true,   //是否可清除已输入的内容url:"/opms/wellInfo/getAllWellId",showBtn:true,          //是否显示可下拉按钮ignorecase:true,        //前端搜索匹配时，忽略大小写hideOnSelect:true,      //鼠标从列表单击选择了值时，是否隐藏选择列表listAlign:'auto',        //提示列表对齐位置，left/right/autoidField:"wellId",           //每组数据的哪个字段作为 data-id，优先级高于 indexId 设置（推荐）keyField :"wellId",           //每组数据的哪个字段作为输入框内容，优先级高于 indexKey 设置（推荐）effectiveFields: ["wellId","wellType","abandonWell"],// 有效显示于列表中的字段，非有效字段都会过滤，默认全部有效。effectiveFieldsAlias: {"wellId":"井编号","wellType":"井类型","abandonWell":"是否报废"},}).on("onSetSelectValue",function (e,keyword) {// alert($('#wellId_test').val());// $('#wellId_test').val(keyword.wellId);// wellId_add=keyword.wellId;}).on("onUnsetSelectValue",function (e) {// wellId_add = '';});

1.5.3 Controller层：

//根据用户身份获取油井编号@RequestMapping(value = "/getAllWellId",method = {RequestMethod.GET,RequestMethod.POST})@ResponseBodypublic Map<String,Object> getAllWellId(HttpServletRequest req, HttpServletResponse res)throws Exception{//先从session中取出存进去的用户对象UserInfo ui= (UserInfo) req.getSession().getAttribute("USERINFO");//根据身份获取油井信息，管理员可查看全部油井，操作员只能查看所属作业区的油井List<WellInfo> wellInfos= wellInfoService.getAllOilWellByRoleId(ui);
/*            for(WellInfo wellInfo:wellInfos){System.out.println(wellInfo);}*/int count=0;if(wellInfos!=null&&wellInfos.size()>0){count=wellInfos.size();}//创建result对象，保存返回结果Map<String,Object> result=new HashMap<>(2);result.put("count",count);result.put("value",wellInfos);return result;}

后面Service层和Dao层的代码就不写了，你看到Controller层这里应该就会了

配置参数如下:

var defaultOptions = {url: null,                      //请求数据的 URL 地址jsonp: null,                    //设置此参数名，将开启jsonp功能，否则使用json数据结构data: {value: []},                              //提示所用的数据，注意格式indexId: 0,                     //每组数据的第几个数据，作为input输入框的 data-id，设为 -1 且 idField 为空则不设置此值indexKey: 0,                    //每组数据的第几个数据，作为input输入框的内容idField: '',                    //每组数据的哪个字段作为 data-id，优先级高于 indexId 设置（推荐）keyField: '',                   //每组数据的哪个字段作为输入框内容，优先级高于 indexKey 设置（推荐）/* 搜索相关 */autoSelect: true,               // 键盘向上/下方向键时，是否自动选择值allowNoKeyword: TRUE,           // 是否允许无关键字时请求数据getDataMethod: 'firstByUrl',    // 获取数据的方式，url：一直从url请求；data：从 options.data 获取；firstByUrl：第一次从Url获取全部数据，之后从options.data获取delayUntilKeyup: false,         // 获取数据的方式 为 firstByUrl 时，是否延迟到有输入时才请求数据ignorecase: false,              // 前端搜索匹配时，是否忽略大小写effectiveFields: [],            // 有效显示于列表中的字段，非有效字段都会过滤，默认全部有效。effectiveFieldsAlias: {},       // 有效字段的别名对象，用于 header 的显示searchFields: [],               // 有效搜索字段，从前端搜索过滤数据时使用，但不一定显示在列表中。effectiveFields 配置字段也会用于搜索过滤twoWayMatch: true,              // 是否双向匹配搜索。为 true 即输入关键字包含或包含于匹配字段均认为匹配成功，为 false 则输入关键字包含于匹配字段认为匹配成功multiWord: false,               // 以分隔符号分割的多关键字支持separator: ',',                 // 多关键字支持时的分隔符，默认为半角逗号delay: 300,                     // 搜索触发的延时时间间隔，单位毫秒emptyTip: '',                   // 查询为空时显示的内容，可为 htmlsearchingTip: '搜索中...',       // ajax 搜索时显示的提示内容，当搜索时间较长时给出正在搜索的提示hideOnSelect: false,            // 鼠标从列表单击选择了值时，是否隐藏选择列表/* UI */autoDropup: false,              //选择菜单是否自动判断向上展开。设为 true，则当下拉菜单高度超过窗体，且向上方向不会被窗体覆盖，则选择菜单向上弹出autoMinWidth: false,            //是否自动最小宽度，设为 false 则最小宽度不小于输入框宽度showHeader: false,              //是否显示选择列表的 header。为 true 时，有效字段大于一列则显示表头showBtn: true,                  //是否显示下拉按钮inputBgColor: '',               //输入框背景色，当与容器背景色不同时，可能需要该项的配置inputWarnColor: 'rgba(255,0,0,.1)', //输入框内容不是下拉列表选择时的警告色listStyle: {'padding-top': 0,'max-height': '375px','max-width': '800px','overflow': 'auto','width': 'auto','transition': '0.3s','-webkit-transition': '0.3s','-moz-transition': '0.3s','-o-transition': '0.3s'},                              //列表的样式控制listAlign: 'left',              //提示列表对齐位置，left/right/autolistHoverStyle: 'background: #07d; color:#fff', //提示框列表鼠标悬浮的样式listHoverCSS: 'jhover',         //提示框列表鼠标悬浮的样式名称clearable: false,               // 是否可清除已输入的内容/* key */keyLeft: 37,                    //向左方向键，不同的操作系统可能会有差别，则自行定义keyUp: 38,                      //向上方向键keyRight: 39,                   //向右方向键keyDown: 40,                    //向下方向键keyEnter: 13,                   //回车键/* methods */fnProcessData: processData,     //格式化数据的方法，返回数据格式参考 data 参数fnGetData: getData,             //获取数据的方法，无特殊需求一般不作设置fnAdjustAjaxParam: null,        //调整 ajax 请求参数方法，用于更多的请求配置需求。如对请求关键字作进一步处理、修改超时时间等fnPreprocessKeyword: null       //搜索过滤数据前，对输入关键字作进一步处理方法。注意，应返回字符串
};

提示：在 bootstrap v4 下， clearable 为 true 时，应引入 font-awesome 图标库，该清除按钮使用了 fa-plus 图标。

使用bootstrap-suggest时的bug解决方案:

https://blog.csdn.net/qq_43753724/article/details/114884133?spm=1001.2014.3001.5501

bootstrap-suggest插件相关推荐

bootstrap select 插件两级联动
2019独角兽企业重金招聘Python工程师标准>>> bootstrap select 插件两级联动插件地址:http://silviomoreto.github.io/boot ...
Bootstrap 轮番插件Collapse 调用方式
调用方式 1.JavaScript调用 JavaScript调用轮番其实很简单,只需在脚本中调用 carousel() 方法即可.格式为: $('.carousel').carousel(); Boo ...
Bootstrap 轮番插件
轮番 Bootstrap轮番插件Carousel是一个灵活的.响应式的.无缝循环播放的幻灯片切换插件,它的内容可以是图片.视频.或者其他任何内容. Bootstrap轮番插件Carousel需要 bo ...
Bootstrap 折叠插件Collapse 选项
选项 Bootstrap折叠插件Collapse有2 个选项,一个是parent,一个是toggle,所有的选项都可以通过 data 属性或JavaScript进行设置.见表 5‑7. 表 5‑7 B ...
Bootstrap 折叠插件Collapse 调用方式
调用方式 Bootstrap折叠插件Collapse的结构相对复杂,但调用比较简单,可以通过data属性调用,也可以通过JavaScript调用. 1.data 属性调用要激活折叠插件的激活行为,首 ...
Bootstrap 折叠插件
折叠当列表菜单的条目特别多,而页面空间有限时,使用类似于手风琴的折叠菜单是不错的选择,因为它可以节约页面空间,方便用户浏览. 折叠插件需要 bootstrap-collapse.js 文件支持,在使 ...
Bootstrap 工具提示插件Tooltip 的选项
选项 Bootstrap为工具提示插件提供了 8 个选项,所有的选项都可以通过 data 属性或JavaScript进行设置.见表 5‑4: 表 5‑4 tooltip插件的选项名称类型默认值 ...
Bootstrap 工具提示插件
工具提示当鼠标移动到特定元素上时,显示相关的提示信息,比如给出链接说明或缩写词的全称等,是一个非常人性化的功能. HTML本身就支持这样的功能,只需给任何元素添加 title 属性,当鼠标悬停时,浏 ...
php 使用上传文件预览插件,bootstrap fileinput插件实现预览上传照片功能方法详解...
本文主要介绍了bootstrap fileinput插件实现预览上传照片功能,代码简单易懂,非常不错,具有参考借鉴价值,需要的朋友可以参考下,希望能帮助到大家. 效果图如下所示: 具体代码如下: cl ...
Bootstrap Bootstrap表格插件bootstrap-table配置与应用小结
Bootstrap表格插件bootstrap-table配置与应用小结 by:授客 QQ:1033553122 1. 测试环境 win7 JQuery-3.2.1.min.js 下载地址: h ...

bootstrap-suggest插件

文章目录