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

发布时间 - 2026-01-11 00:21:27    点击率:

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

首先下载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    //搜索过滤数据前,对输入关键字作进一步处理方法。注意,应返回字符串
};


至此结束。

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


# bootstrap  # suggest  # 搜索建议插件  # JS控件bootstrap suggest plugin使用方法详解  # Bootstrap Search Suggest使用例子  # Bootstrap select多选下拉框实现代码  # Bootstrap select实现下拉框多选效果  # BootStrap中关于Select下拉框选择触发事件及扩展  # BootStrap下拉框在firefox浏览器界面不友好的解决方案  # Bootstrap框架下下拉框select搜索功能  # Bootstrap模块dropdown实现下拉框响应  # 自定义Angular指令与jQuery实现的Bootstrap风格数据双向绑定的单选与多选下拉框  # bootstrap suggest下拉框使用详解  # 输入框  # 方向键  # 设为  # 每组  # 鼠标  # 输入关键字  # 二个  # 时才  # 到第  # 列表中  # 背景色  # 的是  # 这是  # 会有  # 半角  # 看了  # 也会  # 均为  # 回车键  # 数据结构 


相关栏目: 【 网站优化151355 】 【 网络推广146373 】 【 网络技术251813 】 【 AI营销90571


相关推荐: 韩国代理服务器如何选?解析IP设置技巧与跨境访问优化指南  哪家制作企业网站好,开办像阿里巴巴那样的网络公司和网站要怎么做?  Win11怎样安装网易有道词典_Win11安装词典教程【步骤】  手机钓鱼网站怎么制作视频,怎样拦截钓鱼网站。怎么办?  Python函数文档自动校验_规范解析【教程】  Bootstrap整体框架之JavaScript插件架构  Android中Textview和图片同行显示(文字超出用省略号,图片自动靠右边)  郑州企业网站制作公司,郑州招聘网站有哪些?  如何快速搭建高效WAP手机网站?  Laravel API资源类怎么用_Laravel API Resource数据转换  Laravel如何正确地在控制器和模型之间分配逻辑_Laravel代码职责分离与架构建议  Laravel如何实现本地化和多语言支持_Laravel多语言配置与翻译文件管理  百度输入法全感官ai怎么关 百度输入法全感官皮肤关闭  b2c电商网站制作流程,b2c水平综合的电商平台?  制作无缝贴图网站有哪些,3dmax无缝贴图怎么调?  如何挑选最适合建站的高性能VPS主机?  Laravel Telescope怎么调试_使用Laravel Telescope进行应用监控与调试  Win11怎么设置默认图片查看器_Windows11照片应用关联设置  如何确保西部建站助手FTP传输的安全性?  Laravel怎么实现微信登录_Laravel Socialite第三方登录集成  Laravel如何实现全文搜索_Laravel Scout集成Algolia或Meilisearch教程  Laravel如何使用Gate和Policy进行授权?(权限控制)  网站制作报价单模板图片,小松挖机官方网站报价?  如何在阿里云完成域名注册与建站?  Laravel distinct去重查询_Laravel Eloquent去重方法  高性能网站服务器部署指南:稳定运行与安全配置优化方案  HTML透明颜色代码怎么让图片透明_给img元素加透明色的技巧【方法】  东莞专业网站制作公司有哪些,东莞招聘网站哪个好?  北京网站制作的公司有哪些,北京白云观官方网站?  laravel怎么实现图片的压缩和裁剪_laravel图片压缩与裁剪方法  canvas 画布在主流浏览器中的尺寸限制详细介绍  如何批量查询域名的建站时间记录?  Laravel如何使用Spatie Media Library_Laravel图片上传管理与缩略图生成【步骤】  如何快速搭建支持数据库操作的智能建站平台?  Win11关机界面怎么改_Win11自定义关机画面设置【工具】  小视频制作网站有哪些,有什么看国内小视频的网站,求推荐?  Laravel怎么发送邮件_Laravel Mail类SMTP配置教程  网站页面设计需要考虑到这些问题  JavaScript数据类型有哪些_如何准确判断一个变量的类型  香港服务器WordPress建站指南:SEO优化与高效部署策略  开心动漫网站制作软件下载,十分开心动画为何停播?  什么是JavaScript解构赋值_解构赋值有哪些实用技巧  浅谈Javascript中的Label语句  Laravel Session怎么存储_Laravel Session驱动配置详解  Java垃圾回收器的方法和原理总结  微信小程序 五星评分(包括半颗星评分)实例代码  打造顶配客厅影院,这份100寸电视推荐名单请查收  Windows10如何删除恢复分区_Win10 Diskpart命令强制删除分区  如何在建站宝盒中设置产品搜索功能?  如何获取免费开源的自助建站系统源码?