bootstrap-suggest.js 40 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043
  1. /**
  2. * Bootstrap Search Suggest
  3. * @desc 这是一个基于 bootstrap 按钮式下拉菜单组件的搜索建议插件,必须使用于按钮式下拉菜单组件上。
  4. * @author renxia <lzwy0820#qq.com>
  5. * @github https://github.com/lzwme/bootstrap-suggest-plugin.git
  6. * @since 2014-10-09
  7. *===============================================================================
  8. * (c) Copyright 2014-2019 http://lzw.me All Rights Reserved.
  9. ********************************************************************************/
  10. (function (factory) {
  11. if (typeof define === "function" && define.amd) {
  12. define(['jquery'], factory);
  13. } else if (typeof exports === 'object' && typeof module === 'object') {
  14. factory(require('jquery'));
  15. } else if (window.jQuery) {
  16. factory(window.jQuery);
  17. } else {
  18. throw new Error('Not found jQuery.');
  19. }
  20. })(function($) {
  21. var VERSION = 'VERSION_PLACEHOLDER';
  22. var $window = $(window);
  23. var isIe = 'ActiveXObject' in window; // 用于对 IE 的兼容判断
  24. var inputLock; // 用于中文输入法输入时锁定搜索
  25. // ie 下和 chrome 51 以上浏览器版本,出现滚动条时不计算 padding
  26. var chromeVer = navigator.userAgent.match(/Chrome\/(\d+)/);
  27. if (chromeVer) {
  28. chromeVer = +chromeVer[1];
  29. }
  30. var notNeedCalcPadding = isIe || chromeVer > 51;
  31. // 一些常量
  32. var BSSUGGEST = 'bsSuggest';
  33. var onDataRequestSuccess = 'onDataRequestSuccess';
  34. var DISABLED = 'disabled';
  35. var TRUE = true;
  36. var FALSE = false;
  37. function isUndefined(val) {
  38. return val === void(0);
  39. }
  40. /**
  41. * 错误处理
  42. */
  43. function handleError(e1, e2) {
  44. if (!window.console || !window.console.trace) {
  45. return;
  46. }
  47. console.trace(e1);
  48. if (e2) {
  49. console.trace(e2);
  50. }
  51. }
  52. /**
  53. * 获取当前 tr 列的关键字数据
  54. */
  55. function getPointKeyword($list) {
  56. return $list.data();
  57. }
  58. /**
  59. * 设置或获取输入框的 alt 值
  60. */
  61. function setOrGetAlt($input, val) {
  62. return isUndefined(val) ? $input.attr('alt') : $input.attr('alt', val);
  63. }
  64. /**
  65. * 设置或获取输入框的 data-id 值
  66. */
  67. function setOrGetDataId($input, val) {
  68. return val !== (void 0) ? $input.attr('data-id', val) : $input.attr('data-id');
  69. }
  70. /**
  71. * 设置选中的值
  72. */
  73. function setValue($input, keywords, options) {
  74. if (!keywords || !keywords.key) {
  75. return;
  76. }
  77. var separator = options.separator || ',',
  78. inputValList,
  79. inputIdList,
  80. dataId = setOrGetDataId($input);
  81. if (options && options.multiWord) {
  82. inputValList = $input.val().split(separator);
  83. inputValList[inputValList.length - 1] = keywords.key;
  84. //多关键字检索支持设置id --- 存在 bug,不建议使用
  85. if (!dataId) {
  86. inputIdList = [keywords.id];
  87. } else {
  88. inputIdList = dataId.split(separator);
  89. inputIdList.push(keywords.id);
  90. }
  91. setOrGetDataId($input, inputIdList.join(separator))
  92. .val(inputValList.join(separator))
  93. .focus();
  94. } else {
  95. setOrGetDataId($input, keywords.id || '').val(keywords.key).focus();
  96. }
  97. $input.data('pre-val', $input.val())
  98. .trigger('onSetSelectValue', [keywords, (options.data.value || options._lastData.value)[keywords.index]]);
  99. }
  100. /**
  101. * 调整选择菜单位置
  102. * @param {Object} $input
  103. * @param {Object} $dropdownMenu
  104. * @param {Object} options
  105. */
  106. function adjustDropMenuPos($input, $dropdownMenu, options) {
  107. if (!$dropdownMenu.is(':visible')) {
  108. return;
  109. }
  110. var $parent = $input.parent();
  111. var parentHeight = $parent.height();
  112. var parentWidth = $parent.width();
  113. if (options.autoDropup) {
  114. setTimeout(function() {
  115. var offsetTop = $input.offset().top;
  116. var winScrollTop = $window.scrollTop();
  117. var menuHeight = $dropdownMenu.height();
  118. if ( // 自动判断菜单向上展开
  119. ($window.height() + winScrollTop - offsetTop) < menuHeight && // 假如向下会撑长页面
  120. offsetTop > (menuHeight + winScrollTop) // 而且向上不会撑到顶部
  121. ) {
  122. $parent.addClass('dropup');
  123. } else {
  124. $parent.removeClass('dropup');
  125. }
  126. }, 10);
  127. }
  128. // 列表对齐方式
  129. var dmcss = {};
  130. if (options.listAlign === 'left') {
  131. dmcss = {
  132. 'left': $input.siblings('div').width() - parentWidth,
  133. 'right': 'auto'
  134. };
  135. } else if (options.listAlign === 'right') {
  136. dmcss = {
  137. 'left': 'auto',
  138. 'right': 0
  139. };
  140. }
  141. // ie 下,不显示按钮时的 top/bottom
  142. if (isIe && !options.showBtn) {
  143. if (!$parent.hasClass('dropup')) {
  144. dmcss.top = parentHeight;
  145. dmcss.bottom = 'auto';
  146. } else {
  147. dmcss.top = 'auto';
  148. dmcss.bottom = parentHeight;
  149. }
  150. }
  151. // 是否自动最小宽度
  152. if (!options.autoMinWidth) {
  153. dmcss.minWidth = parentWidth;
  154. }
  155. /* else {
  156. dmcss['width'] = 'auto';
  157. }*/
  158. $dropdownMenu.css(dmcss);
  159. return $input;
  160. }
  161. /**
  162. * 设置输入框背景色
  163. * 当设置了 indexId,而输入框的 data-id 为空时,输入框加载警告色
  164. */
  165. function setBackground($input, options) {
  166. var inputbg, bg, warnbg;
  167. if ((options.indexId === -1 && !options.idField) || options.multiWord) {
  168. return $input;
  169. }
  170. bg = options.inputBgColor;
  171. warnbg = options.inputWarnColor;
  172. var curVal = $input.val();
  173. var preVal = $input.data('pre-val');
  174. if (setOrGetDataId($input) || !curVal) {
  175. $input.css('background', bg || '');
  176. if (!curVal && preVal) {
  177. $input.trigger('onUnsetSelectValue').data('pre-val', '');
  178. }
  179. return $input;
  180. }
  181. inputbg = $input.css('backgroundColor').replace(/ /g, '').split(',', 3).join(',');
  182. // 自由输入的内容,设置背景色
  183. if (!~warnbg.indexOf(inputbg)) {
  184. $input.trigger('onUnsetSelectValue') // 触发取消data-id事件
  185. .data('pre-val', '')
  186. .css('background', warnbg);
  187. }
  188. return $input;
  189. }
  190. /**
  191. * 调整滑动条
  192. */
  193. function adjustScroll($input, $dropdownMenu, options) {
  194. // 控制滑动条
  195. var $hover = $input.parent().find('tbody tr.' + options.listHoverCSS),
  196. pos, maxHeight;
  197. if ($hover.length) {
  198. pos = ($hover.index() + 3) * $hover.height();
  199. maxHeight = +$dropdownMenu.css('maxHeight').replace('px', '');
  200. if (pos > maxHeight || $dropdownMenu.scrollTop() > maxHeight) {
  201. pos = pos - maxHeight;
  202. } else {
  203. pos = 0;
  204. }
  205. $dropdownMenu.scrollTop(pos);
  206. }
  207. }
  208. /**
  209. * 解除所有列表 hover 样式
  210. */
  211. function unHoverAll($dropdownMenu, options) {
  212. $dropdownMenu.find('tr.' + options.listHoverCSS).removeClass(options.listHoverCSS);
  213. }
  214. /**
  215. * 验证 $input 对象是否符合条件
  216. * 1. 必须为 bootstrap 下拉式菜单
  217. * 2. 必须未初始化过
  218. */
  219. function checkInput($input, $dropdownMenu, options) {
  220. if (
  221. !$dropdownMenu.length || // 过滤非 bootstrap 下拉式菜单对象
  222. $input.data(BSSUGGEST) // 是否已经初始化的检测
  223. ) {
  224. return FALSE;
  225. }
  226. $input.data(BSSUGGEST, {
  227. options: options
  228. });
  229. return TRUE;
  230. }
  231. /**
  232. * 数据格式检测
  233. * 检测 ajax 返回成功数据或 data 参数数据是否有效
  234. * data 格式:{"value": [{}, {}...]}
  235. */
  236. function checkData(data) {
  237. var isEmpty = TRUE, o;
  238. for (o in data) {
  239. if (o === 'value') {
  240. isEmpty = FALSE;
  241. break;
  242. }
  243. }
  244. if (isEmpty) {
  245. handleError('返回数据格式错误!');
  246. return FALSE;
  247. }
  248. if (!data.value.length) {
  249. // handleError('返回数据为空!');
  250. return FALSE;
  251. }
  252. return data;
  253. }
  254. /**
  255. * 判断字段名是否在 options.effectiveFields 配置项中
  256. * @param {String} field 要判断的字段名
  257. * @param {Object} options
  258. * @return {Boolean} effectiveFields 为空时始终返回 true
  259. */
  260. function inEffectiveFields(field, options) {
  261. var effectiveFields = options.effectiveFields;
  262. return !(field === '__index' ||
  263. effectiveFields.length &&
  264. !~$.inArray(field, effectiveFields));
  265. }
  266. /**
  267. * 判断字段名是否在 options.searchFields 搜索字段配置中
  268. */
  269. function inSearchFields(field, options) {
  270. return ~$.inArray(field, options.searchFields);
  271. }
  272. /**
  273. * 通过下拉菜单显示提示文案
  274. */
  275. function showTip(tip, $input, $dropdownMenu, options) {
  276. $dropdownMenu.html('<div style="padding:10px 5px 5px">' + tip + '</div>').show();
  277. adjustDropMenuPos($input, $dropdownMenu, options);
  278. }
  279. /**
  280. * 显示下拉列表
  281. */
  282. function showDropMenu($input, options) {
  283. var $dropdownMenu = $input.parent().find('ul:eq(0)');
  284. if (!$dropdownMenu.is(':visible')) {
  285. // $dropdownMenu.css('display', 'block');
  286. $dropdownMenu.show();
  287. $input.trigger('onShowDropdown', [options ? options.data.value : []]);
  288. }
  289. }
  290. /**
  291. * 隐藏下拉列表
  292. */
  293. function hideDropMenu($input, options) {
  294. var $dropdownMenu = $input.parent().find('ul:eq(0)');
  295. if ($dropdownMenu.is(':visible')) {
  296. // $dropdownMenu.css('display', '');
  297. $dropdownMenu.hide();
  298. $input.trigger('onHideDropdown', [options ? options.data.value : []]);
  299. }
  300. }
  301. /**
  302. * 下拉列表刷新
  303. * 作为 fnGetData 的 callback 函数调用
  304. */
  305. function refreshDropMenu($input, data, options) {
  306. var $dropdownMenu = $input.parent().find('ul:eq(0)'),
  307. len, i, field, index = 0,
  308. tds,
  309. html = ['<table class="table table-condensed table-sm" style="margin:0">'],
  310. idValue, keyValue; // 作为输入框 data-id 和内容的字段值
  311. var dataList = data.value;
  312. if (!data || !(len = dataList.length)) {
  313. if (options.emptyTip) {
  314. showTip(options.emptyTip, $input, $dropdownMenu, options);
  315. } else {
  316. $dropdownMenu.empty();
  317. hideDropMenu($input, options);
  318. }
  319. return $input;
  320. }
  321. // 相同数据,不用继续渲染了
  322. if (
  323. options._lastData &&
  324. JSON.stringify(options._lastData) === JSON.stringify(data) &&
  325. $dropdownMenu.find('tr').length === len
  326. ) {
  327. showDropMenu($input, options);
  328. return adjustDropMenuPos($input, $dropdownMenu, options);
  329. }
  330. options._lastData = data;
  331. // 生成表头
  332. if (options.showHeader) {
  333. html.push('<thead><tr>');
  334. for (field in dataList[0]) {
  335. if (!inEffectiveFields(field, options)) {
  336. continue;
  337. }
  338. html.push('<th>', (options.effectiveFieldsAlias[field] || field),
  339. index === 0 ? ('(' + len + ')') : '' , // 表头第一列记录总数
  340. '</th>');
  341. index++;
  342. }
  343. html.push('</tr></thead>');
  344. }
  345. html.push('<tbody>');
  346. // console.log(data, len);
  347. // 按列加数据
  348. var dataI;
  349. for (i = 0; i < len; i++) {
  350. index = 0;
  351. tds = [];
  352. dataI = dataList[i];
  353. idValue = dataI[options.idField];
  354. keyValue = dataI[options.keyField];
  355. for (field in dataI) {
  356. // 标记作为 value 和 作为 id 的值
  357. if (isUndefined(keyValue) && options.indexKey === index) {
  358. keyValue = dataI[field];
  359. }
  360. if (isUndefined(idValue) && options.indexId === index) {
  361. idValue = dataI[field];
  362. }
  363. index++;
  364. // 列表中只显示有效的字段
  365. if (inEffectiveFields(field, options)) {
  366. tds.push('<td data-name="', field, '">', dataI[field], '</td>');
  367. }
  368. }
  369. html.push('<tr data-index="', (dataI.__index || i),
  370. '" data-id="', idValue,
  371. '" data-key="', keyValue, '">',
  372. tds.join(''), '</tr>');
  373. }
  374. html.push('</tbody></table>');
  375. $dropdownMenu.html(html.join(''));
  376. showDropMenu($input, options);
  377. //.show();
  378. // scrollbar 存在时,延时到动画结束时调整 padding
  379. setTimeout(function() {
  380. if (notNeedCalcPadding) {
  381. return;
  382. }
  383. var $table = $dropdownMenu.find('table:eq(0)'),
  384. pdr = 0,
  385. mgb = 0;
  386. if (
  387. $dropdownMenu.height() < $table.height() &&
  388. +$dropdownMenu.css('minWidth').replace('px', '') < $dropdownMenu.width()
  389. ) {
  390. pdr = 18;
  391. mgb = 20;
  392. }
  393. $dropdownMenu.css('paddingRight', pdr);
  394. $table.css('marginBottom', mgb);
  395. }, 301);
  396. adjustDropMenuPos($input, $dropdownMenu, options);
  397. return $input;
  398. }
  399. /**
  400. * ajax 获取数据
  401. * @param {Object} options
  402. * @return {Object} $.Deferred
  403. */
  404. function ajax(options, keyword) {
  405. keyword = keyword || '';
  406. var preAjax = options._preAjax;
  407. if (preAjax && preAjax.abort && preAjax.readyState !== 4) {
  408. // console.log('abort pre ajax');
  409. preAjax.abort();
  410. }
  411. var ajaxParam = {
  412. type: 'GET',
  413. dataType: options.jsonp ? 'jsonp' : 'json',
  414. timeout: 5000,
  415. };
  416. // jsonp
  417. if (options.jsonp) {
  418. ajaxParam.jsonp = options.jsonp;
  419. }
  420. // 自定义 ajax 请求参数生成方法
  421. var adjustAjaxParam,
  422. fnAdjustAjaxParam = options.fnAdjustAjaxParam;
  423. if ($.isFunction(fnAdjustAjaxParam)) {
  424. adjustAjaxParam = fnAdjustAjaxParam(keyword, options);
  425. // options.fnAdjustAjaxParam 返回false,则终止 ajax 请求
  426. if (FALSE === adjustAjaxParam) {
  427. return;
  428. }
  429. $.extend(ajaxParam, adjustAjaxParam);
  430. }
  431. // url 调整
  432. ajaxParam.url = function() {
  433. if (!keyword || ajaxParam.data) {
  434. return ajaxParam.url || options.url;
  435. }
  436. var type = '?';
  437. if (/=$/.test(options.url)) {
  438. type = '';
  439. } else if (/\?/.test(options.url)) {
  440. type = '&';
  441. }
  442. return options.url + type + encodeURIComponent(keyword);
  443. }();
  444. return options._preAjax = $.ajax(ajaxParam).done(function(result) {
  445. options.data = options.fnProcessData(result);
  446. }).fail(function(err) {
  447. if (options.fnAjaxFail) {
  448. options.fnAjaxFail(err, options);
  449. }
  450. });
  451. }
  452. /**
  453. * 检测 keyword 与 value 是否存在互相包含
  454. * @param {String} keyword 用户输入的关键字
  455. * @param {String} key 匹配字段的 key
  456. * @param {String} value key 字段对应的值
  457. * @param {Object} options
  458. * @return {Boolean} 包含/不包含
  459. */
  460. function isInWord(keyword, key, value, options) {
  461. value = $.trim(value);
  462. if (options.ignorecase) {
  463. keyword = keyword.toLocaleLowerCase();
  464. value = value.toLocaleLowerCase();
  465. }
  466. return value &&
  467. (inEffectiveFields(key, options) || inSearchFields(key, options)) && // 必须在有效的搜索字段中
  468. (
  469. ~value.indexOf(keyword) || // 匹配值包含关键字
  470. options.twoWayMatch && ~keyword.indexOf(value) // 关键字包含匹配值
  471. );
  472. }
  473. /**
  474. * 通过 ajax 或 json 参数获取数据
  475. */
  476. function getData(keyword, $input, callback, options) {
  477. var data, validData, filterData = {
  478. value: []
  479. },
  480. i, key, len,
  481. fnPreprocessKeyword = options.fnPreprocessKeyword;
  482. keyword = keyword || '';
  483. // 获取数据前对关键字预处理方法
  484. if ($.isFunction(fnPreprocessKeyword)) {
  485. keyword = fnPreprocessKeyword(keyword, options);
  486. }
  487. // 给了url参数,则从服务器 ajax 请求
  488. // console.log(options.url + keyword);
  489. if (options.url) {
  490. var timer;
  491. if (options.searchingTip) {
  492. timer = setTimeout(function() {
  493. showTip(options.searchingTip, $input, $input.parent().find('ul'), options);
  494. }, 600);
  495. }
  496. ajax(options, keyword).done(function(result) {
  497. callback($input, options.data, options); // 为 refreshDropMenu
  498. $input.trigger(onDataRequestSuccess, result);
  499. if (options.getDataMethod === 'firstByUrl') {
  500. options.url = null;
  501. }
  502. }).always(function() {
  503. timer && clearTimeout(timer);
  504. });
  505. } else {
  506. // 没有给出 url 参数,则从 data 参数获取
  507. data = options.data;
  508. validData = checkData(data);
  509. // 本地的 data 数据,则在本地过滤
  510. if (validData) {
  511. if (keyword) {
  512. // 输入不为空时则进行匹配
  513. len = data.value.length;
  514. for (i = 0; i < len; i++) {
  515. for (key in data.value[i]) {
  516. if (
  517. data.value[i][key] &&
  518. isInWord(keyword, key, data.value[i][key] + '', options)
  519. ) {
  520. filterData.value.push(data.value[i]);
  521. filterData.value[filterData.value.length - 1].__index = i;
  522. break;
  523. }
  524. }
  525. }
  526. } else {
  527. filterData = data;
  528. }
  529. }
  530. callback($input, filterData, options);
  531. } // else
  532. }
  533. /**
  534. * 数据处理
  535. * url 获取数据时,对数据的处理,作为 fnGetData 之后的回调处理
  536. */
  537. function processData(data) {
  538. return checkData(data);
  539. }
  540. /**
  541. * 取得 clearable 清除按钮
  542. */
  543. function getIClear($input, options) {
  544. var $iClear = $input.prev('i.clearable');
  545. // 是否可清除已输入的内容(添加清除按钮)
  546. if (options.clearable && !$iClear.length) {
  547. $iClear = $('<i class="clearable glyphicon glyphicon-remove fa fa-plus"></i>')
  548. .prependTo($input.parent());
  549. }
  550. return $iClear.css({
  551. position: 'absolute',
  552. top: 'calc(50% - 6px)',
  553. transform: 'rotate(45deg)',
  554. // right: options.showBtn ? Math.max($input.next('.input-group-btn').width(), 33) + 2 : 12,
  555. zIndex: 4,
  556. cursor: 'pointer',
  557. width: '14px',
  558. lineHeight: '14px',
  559. textAlign: 'center',
  560. fontSize: 12
  561. }).hide();
  562. }
  563. /**
  564. * 默认的配置选项
  565. * @type {Object}
  566. */
  567. var defaultOptions = {
  568. url: null, // 请求数据的 URL 地址
  569. jsonp: null, // 设置此参数名,将开启jsonp功能,否则使用json数据结构
  570. data: {
  571. value: []
  572. }, // 提示所用的数据,注意格式
  573. indexId: 0, // 每组数据的第几个数据,作为input输入框的 data-id,设为 -1 且 idField 为空则不设置此值
  574. indexKey: 0, // 每组数据的第几个数据,作为input输入框的内容
  575. idField: '', // 每组数据的哪个字段作为 data-id,优先级高于 indexId 设置(推荐)
  576. keyField: '', // 每组数据的哪个字段作为输入框内容,优先级高于 indexKey 设置(推荐)
  577. /* 搜索相关 */
  578. autoSelect: TRUE, // 键盘向上/下方向键时,是否自动选择值
  579. allowNoKeyword: TRUE, // 是否允许无关键字时请求数据
  580. getDataMethod: 'firstByUrl', // 获取数据的方式,url:一直从url请求;data:从 options.data 获取;firstByUrl:第一次从Url获取全部数据,之后从options.data获取
  581. delayUntilKeyup: FALSE, // 获取数据的方式 为 firstByUrl 时,是否延迟到有输入时才请求数据
  582. ignorecase: FALSE, // 前端搜索匹配时,是否忽略大小写
  583. effectiveFields: [], // 有效显示于列表中的字段,非有效字段都会过滤,默认全部有效。
  584. effectiveFieldsAlias: {}, // 有效字段的别名对象,用于 header 的显示
  585. searchFields: [], // 有效搜索字段,从前端搜索过滤数据时使用,但不一定显示在列表中。effectiveFields 配置字段也会用于搜索过滤
  586. twoWayMatch: TRUE, // 是否双向匹配搜索。为 true 即输入关键字包含或包含于匹配字段均认为匹配成功,为 false 则输入关键字包含于匹配字段认为匹配成功
  587. multiWord: FALSE, // 以分隔符号分割的多关键字支持
  588. separator: ',', // 多关键字支持时的分隔符,默认为半角逗号
  589. delay: 300, // 搜索触发的延时时间间隔,单位毫秒
  590. emptyTip: '', // 查询为空时显示的内容,可为 html
  591. searchingTip: '搜索中...', // ajax 搜索时显示的提示内容,当搜索时间较长时给出正在搜索的提示
  592. hideOnSelect: FALSE, // 鼠标从列表单击选择了值时,是否隐藏选择列表
  593. /* UI */
  594. autoDropup: FALSE, // 选择菜单是否自动判断向上展开。设为 true,则当下拉菜单高度超过窗体,且向上方向不会被窗体覆盖,则选择菜单向上弹出
  595. autoMinWidth: FALSE, // 是否自动最小宽度,设为 false 则最小宽度不小于输入框宽度
  596. showHeader: FALSE, // 是否显示选择列表的 header。为 true 时,有效字段大于一列则显示表头
  597. showBtn: TRUE, // 是否显示下拉按钮
  598. inputBgColor: '', // 输入框背景色,当与容器背景色不同时,可能需要该项的配置
  599. inputWarnColor: 'rgba(255,0,0,.1)', // 输入框内容不是下拉列表选择时的警告色
  600. listStyle: {
  601. 'padding-top': 0,
  602. 'max-height': '375px',
  603. 'max-width': '800px',
  604. 'overflow': 'auto',
  605. 'width': 'auto',
  606. 'transition': '0.3s',
  607. '-webkit-transition': '0.3s',
  608. '-moz-transition': '0.3s',
  609. '-o-transition': '0.3s',
  610. 'word-break': 'keep-all',
  611. 'white-space': 'nowrap'
  612. }, // 列表的样式控制
  613. listAlign: 'left', // 提示列表对齐位置,left/right/auto
  614. listHoverStyle: 'background: #07d; color:#fff', // 提示框列表鼠标悬浮的样式
  615. listHoverCSS: 'jhover', // 提示框列表鼠标悬浮的样式名称
  616. clearable: FALSE, // 是否可清除已输入的内容
  617. /* key */
  618. keyLeft: 37, // 向左方向键,不同的操作系统可能会有差别,则自行定义
  619. keyUp: 38, // 向上方向键
  620. keyRight: 39, // 向右方向键
  621. keyDown: 40, // 向下方向键
  622. keyEnter: 13, // 回车键
  623. /* methods */
  624. fnProcessData: processData, // 格式化数据的方法,返回数据格式参考 data 参数
  625. fnGetData: getData, // 获取数据的方法,无特殊需求一般不作设置
  626. fnAdjustAjaxParam: null, // 调整 ajax 请求参数方法,用于更多的请求配置需求。如对请求关键字作进一步处理、修改超时时间等
  627. fnPreprocessKeyword: null, // 搜索过滤数据前,对输入关键字作进一步处理方法。注意,应返回字符串
  628. fnAjaxFail: null, // ajax 失败时回调方法
  629. };
  630. var methods = {
  631. init: function(options) {
  632. // 参数设置
  633. var self = this;
  634. options = options || {};
  635. // 默认配置有效显示字段多于一个,则显示列表表头,否则不显示
  636. if (isUndefined(options.showHeader) && options.effectiveFields && options.effectiveFields.length > 1) {
  637. options.showHeader = TRUE;
  638. }
  639. options = $.extend(TRUE, {}, defaultOptions, options);
  640. // 旧的方法兼容
  641. if (options.processData) {
  642. options.fnProcessData = options.processData;
  643. }
  644. if (options.getData) {
  645. options.fnGetData = options.getData;
  646. }
  647. if (options.getDataMethod === 'firstByUrl' && options.url && !options.delayUntilKeyup) {
  648. ajax(options).done(function(result) {
  649. options.url = null;
  650. self.trigger(onDataRequestSuccess, result);
  651. });
  652. }
  653. // 鼠标滑动到条目样式
  654. if (!$('#' + BSSUGGEST).length) {
  655. $('head:eq(0)').append('<style id="' + BSSUGGEST + '">.' + options.listHoverCSS + '{' + options.listHoverStyle + '}</style>');
  656. }
  657. return self.each(function() {
  658. var $input = $(this),
  659. $parent = $input.parent(),
  660. $iClear = getIClear($input, options),
  661. isMouseenterMenu,
  662. keyupTimer, // keyup 与 input 事件延时定时器
  663. $dropdownMenu = $parent.find('ul:eq(0)');
  664. // 兼容 bs4
  665. $dropdownMenu.parent().css('position', 'relative');
  666. // 验证输入框对象是否符合条件
  667. if (!checkInput($input, $dropdownMenu, options)) {
  668. console.warn('不是一个标准的 bootstrap 下拉式菜单或已初始化:', $input);
  669. return;
  670. }
  671. // 是否显示 button 按钮
  672. if (!options.showBtn) {
  673. $input.css('borderRadius', 4);
  674. $parent.css('width', '100%')
  675. .find('.btn:eq(0)').hide();
  676. }
  677. // 移除 disabled 类,并禁用自动完成
  678. $input.removeClass(DISABLED).prop(DISABLED, FALSE).attr('autocomplete', 'off');
  679. // dropdown-menu 增加修饰
  680. $dropdownMenu.css(options.listStyle);
  681. // 默认背景色
  682. if (!options.inputBgColor) {
  683. options.inputBgColor = $input.css('backgroundColor');
  684. }
  685. // 开始事件处理
  686. $input.on('keydown', function(event) {
  687. var currentList, tipsKeyword; // 提示列表上被选中的关键字
  688. // 当提示层显示时才对键盘事件处理
  689. if (!$dropdownMenu.is(':visible')) {
  690. setOrGetDataId($input, '');
  691. return;
  692. }
  693. currentList = $dropdownMenu.find('.' + options.listHoverCSS);
  694. tipsKeyword = ''; // 提示列表上被选中的关键字
  695. unHoverAll($dropdownMenu, options);
  696. if (event.keyCode === options.keyDown) { // 如果按的是向下方向键
  697. if (!currentList.length) {
  698. // 如果提示列表没有一个被选中,则将列表第一个选中
  699. tipsKeyword = getPointKeyword($dropdownMenu.find('tbody tr:first').mouseover());
  700. } else if (!currentList.next().length) {
  701. // 如果是最后一个被选中,则取消选中,即可认为是输入框被选中,并恢复输入的值
  702. if (options.autoSelect) {
  703. setOrGetDataId($input, '').val(setOrGetAlt($input));
  704. }
  705. } else {
  706. // 选中下一行
  707. tipsKeyword = getPointKeyword(currentList.next().mouseover());
  708. }
  709. // 控制滑动条
  710. adjustScroll($input, $dropdownMenu, options);
  711. if (!options.autoSelect) {
  712. return;
  713. }
  714. } else if (event.keyCode === options.keyUp) { // 如果按的是向上方向键
  715. if (!currentList.length) {
  716. tipsKeyword = getPointKeyword($dropdownMenu.find('tbody tr:last').mouseover());
  717. } else if (!currentList.prev().length) {
  718. if (options.autoSelect) {
  719. setOrGetDataId($input, '').val(setOrGetAlt($input));
  720. }
  721. } else {
  722. // 选中前一行
  723. tipsKeyword = getPointKeyword(currentList.prev().mouseover());
  724. }
  725. // 控制滑动条
  726. adjustScroll($input, $dropdownMenu, options);
  727. if (!options.autoSelect) {
  728. return;
  729. }
  730. } else if (event.keyCode === options.keyEnter) {
  731. tipsKeyword = getPointKeyword(currentList);
  732. hideDropMenu($input, options);
  733. } else {
  734. setOrGetDataId($input, '');
  735. }
  736. // 设置值 tipsKeyword
  737. // console.log(tipsKeyword);
  738. setValue($input, tipsKeyword, options);
  739. }).on('compositionstart', function(event) {
  740. // 中文输入开始,锁定
  741. // console.log('compositionstart');
  742. inputLock = TRUE;
  743. }).on('compositionend', function(event) {
  744. // 中文输入结束,解除锁定
  745. // console.log('compositionend');
  746. inputLock = FALSE;
  747. }).on('keyup input paste', function(event) {
  748. var word;
  749. if (event.keyCode) {
  750. setBackground($input, options);
  751. }
  752. // 如果弹起的键是回车、向上或向下方向键则返回
  753. if (~$.inArray(event.keyCode, [options.keyDown, options.keyUp, options.keyEnter])) {
  754. $input.val($input.val()); // 让鼠标输入跳到最后
  755. return;
  756. }
  757. clearTimeout(keyupTimer);
  758. keyupTimer = setTimeout(function() {
  759. // console.log('input keyup', event);
  760. // 锁定状态,返回
  761. if (inputLock) {
  762. return;
  763. }
  764. word = $input.val();
  765. // 若输入框值没有改变则返回
  766. if ($.trim(word) && word === setOrGetAlt($input)) {
  767. return;
  768. }
  769. // 当按下键之前记录输入框值,以方便查看键弹起时值有没有变
  770. setOrGetAlt($input, word);
  771. if (options.multiWord) {
  772. word = word.split(options.separator).reverse()[0];
  773. }
  774. // 是否允许空数据查询
  775. if (!word.length && !options.allowNoKeyword) {
  776. return;
  777. }
  778. options.fnGetData($.trim(word), $input, refreshDropMenu, options);
  779. }, options.delay || 300);
  780. }).on('focus', function() {
  781. // console.log('input focus');
  782. adjustDropMenuPos($input, $dropdownMenu, options);
  783. }).on('blur', function() {
  784. if (!isMouseenterMenu) { // 不是进入下拉列表状态,则隐藏列表
  785. hideDropMenu($input, options);
  786. }
  787. }).on('click', function() {
  788. // console.log('input click');
  789. var word = $input.val();
  790. if (
  791. $.trim(word) &&
  792. word === setOrGetAlt($input) &&
  793. $dropdownMenu.find('table tr').length
  794. ) {
  795. return showDropMenu($input, options);
  796. }
  797. if ($dropdownMenu.is(':visible')) {
  798. return;
  799. }
  800. if (options.multiWord) {
  801. word = word.split(options.separator).reverse()[0];
  802. }
  803. // 是否允许空数据查询
  804. if (!word.length && !options.allowNoKeyword) {
  805. return;
  806. }
  807. // console.log('word', word);
  808. options.fnGetData($.trim(word), $input, refreshDropMenu, options);
  809. });
  810. // 下拉按钮点击时
  811. $parent.find('.btn:eq(0)').attr('data-toggle', '').click(function() {
  812. if (!$dropdownMenu.is(':visible')) {
  813. if (options.url) {
  814. $input.click().focus();
  815. if (!$dropdownMenu.find('tr').length) {
  816. return FALSE;
  817. }
  818. } else {
  819. // 不以 keyword 作为过滤,展示所有的数据
  820. refreshDropMenu($input, options.data, options);
  821. }
  822. showDropMenu($input, options);
  823. } else {
  824. hideDropMenu($input, options);
  825. }
  826. return FALSE;
  827. });
  828. // 列表中滑动时,输入框失去焦点
  829. $dropdownMenu.mouseenter(function() {
  830. // console.log('mouseenter')
  831. isMouseenterMenu = 1;
  832. $input.blur();
  833. }).mouseleave(function() {
  834. // console.log('mouseleave')
  835. isMouseenterMenu = 0;
  836. $input.focus();
  837. }).on('mouseenter', 'tbody tr', function() {
  838. // 行上的移动事件
  839. unHoverAll($dropdownMenu, options);
  840. $(this).addClass(options.listHoverCSS);
  841. return FALSE; // 阻止冒泡
  842. })
  843. .on('mousedown', 'tbody tr', function() {
  844. var keywords = getPointKeyword($(this));
  845. setValue($input, keywords, options);
  846. setOrGetAlt($input, keywords.key);
  847. setBackground($input, options);
  848. if (options.hideOnSelect) {
  849. hideDropMenu($input, options);
  850. }
  851. });
  852. // 存在清空按钮
  853. if ($iClear.length) {
  854. $iClear.click(function () {
  855. setOrGetDataId($input, '').val('');
  856. setBackground($input, options);
  857. });
  858. $parent.mouseenter(function() {
  859. if (!$input.prop(DISABLED)) {
  860. $iClear.css('right', options.showBtn ? Math.max($input.next().width(), 33) + 2 : 12)
  861. .show();
  862. }
  863. }).mouseleave(function() {
  864. $iClear.hide();
  865. });
  866. }
  867. });
  868. },
  869. show: function() {
  870. return this.each(function() {
  871. $(this).click();
  872. });
  873. },
  874. hide: function() {
  875. return this.each(function() {
  876. hideDropMenu($(this));
  877. });
  878. },
  879. disable: function() {
  880. return this.each(function() {
  881. $(this).attr(DISABLED, TRUE)
  882. .parent().find('.btn:eq(0)').prop(DISABLED, TRUE);
  883. });
  884. },
  885. enable: function() {
  886. return this.each(function() {
  887. $(this).attr(DISABLED, FALSE)
  888. .parent().find('.btn:eq(0)').prop(DISABLED, FALSE);
  889. });
  890. },
  891. destroy: function() {
  892. return this.each(function() {
  893. $(this).off().removeData(BSSUGGEST).removeAttr('style')
  894. .parent().find('.btn:eq(0)').off().show().attr('data-toggle', 'dropdown').prop(DISABLED, FALSE) // .addClass(DISABLED);
  895. .next().css('display', '').off();
  896. });
  897. },
  898. version: function() {
  899. return VERSION;
  900. }
  901. };
  902. $.fn[BSSUGGEST] = function(options) {
  903. // 方法判断
  904. if (typeof options === 'string' && methods[options]) {
  905. var inited = TRUE;
  906. this.each(function() {
  907. if (!$(this).data(BSSUGGEST)) {
  908. return inited = FALSE;
  909. }
  910. });
  911. // 只要有一个未初始化,则全部都不执行方法,除非是 init 或 version
  912. if (!inited && 'init' !== options && 'version' !== options) {
  913. return this;
  914. }
  915. // 如果是方法,则参数第一个为函数名,从第二个开始为函数参数
  916. return methods[options].apply(this, [].slice.call(arguments, 1));
  917. } else {
  918. // 调用初始化方法
  919. return methods.init.apply(this, arguments);
  920. }
  921. }
  922. });