bootstrap suggest搜索建议插件使用详解

近日因工作需要看了下此插件。

首先下载bootstrap js包。添加此插件的引用。注意css样式要引用，不能忘记。

前台页面代码，因为楼主做的是选项卡切换查询不同的结果。

<tr>
  <th style="background: #fff;" width="30%">类型：</th>
       <td width="70%">
         <select class="selectpicker show-tick" id="slidetype">
           <option value="2">生活</option>
           <option value="1">首页</option>
           <option value="3">作品</option>
         </select>
       </td>
     </tr>
     <tr>
       <th style="background:#fff">标题：</th>
       <td>
 
         <div class="input-group" style="width:300px">
           <input type="text" class="form-control" id="title">
           <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>
           <!-- /btn-group -->
         </div>
       </td>
</tr>　

 //搜索建议框
      /* $('#title').keyup(function () {
         var obj = $('#slidetype').val();
         var txtname = $('#title').val().trim();
         $.post("/slide/loadselect", { index: obj, name: txtname }, function (data) {
           if (data != null) {
             data = json.parse(data);
             var testdatabssuggest = $("#title").bssuggest({
               indexid: 0,
               indexkey: 1,
               data: {
                 "value": data
               }
             }).on('onsetselectvalue', function (e, data) {
               var url = "";
               switch (obj) {
                 case "1": url = "";
                   break;
                 case "2": url = "homelife/homeknowledgedetails?infoguid=";
                   break;
                 case "3": url = "";
                   break;
                 default:

               }
               $("#url").val(url + data.id);
             });
           }
         });
       });*/

这是楼主根据不同的选项请求查询不同的数据，再在结果中搜索

下面说的就是第二种，是搜索插件内部的请求。

如下：

function getsuggest(obj) {
      var testbssuggest = $("#title").bssuggest({
        url: "/slide/loadselect?keyword=" + obj + "",
        getdatamethod: "firstbyurl",//获取数据的方式，url：一直从url请求；data：从 options.data 获取；firstbyurl：第一次从url获取全部数据，之后从options.data获取
        effectivefieldsalias: { title: "标题" },
        searchfields: ["title"],
        idfield: "infoguid",
        keyfield: "title",
        effectivefields: ["title"],
        showheader: true,//显示 header
        showbtn: true,   //不显示下拉按钮
        delayuntilkeyup: false, //获取数据的方式为 firstbyurl 时，延迟到有输入/获取到焦点时才请求数据
      }).on('onsetselectvalue', function (e, keyword) {
        var url = "";
        switch (obj) {
          case "1": url = "";
            break;
          case "2": url = urljump(keyword.id);
            break;
          case "3": url = "";
            break;
        }

        $("#url").val(url + keyword.id.substring(0, keyword.id.length - 1));
      });
    }

对应的后台代码：

最终页面显示的结果。

看看以下配置说明可以更改不同的需求。

####方法调用

禁用提示： $("input#test").bssuggest("disable");
启用提示： $("input#test").bssuggest("enable");
销毁插件： $("input#test").bssuggest("destroy");
查看版本：$("input#test").bssuggest("version");
####事件监听

ondatarequestsuccess: 当 ajax 请求数据成功时触发，并传回结果到第二个参数
onsetselectvalue：当从下拉菜单选取值时触发，并传回设置的数据到第二个参数
onunsetselectvalue：当设置了 idfield，且*输入内容时触发（与背景警告色显示同步）
$("#test")
  .on('ondatarequestsuccess', function (event, result) {
    console.log(result);
  })
  .on('onsetselectvalue', function (e, keyword) {
    console.log('onsetselectvalue: ', keyword);
  })
  .on('onunsetselectvalue', function (e) {
    console.log('onunsetselectvalue');
  });

配置参数

参数列表中的值均为插件默认值

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: ',',         //多关键字支持时的分隔符，默认为半角逗号

  /* 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/auto
  listhoverstyle: '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    //搜索过滤数据前，对输入关键字作进一步处理方法。注意，应返回字符串
};

至此结束。

以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持。