leaves note

write by a programer

 


dom.chosen('destroy') ; 销毁实例




以下参数在实例化的时候通过参数设置。

$('.my_select_box').chosen({
  disable_search_threshold: 10,
  no_results_text: 'Oops, nothing found!',
  width: '95%'});

配置项

选项默认值描述
allow_single_deselectfalse非必选的单选框是否显示清除选中图标
disable_searchfalse是否隐藏单选框的搜索框
disable_search_threshold0少于n项时隐藏搜索框
enable_split_word_searchtrue是否开启分词搜索
inherit_select_classesfalse是否继承 select 元素的 class,如果设为 true,Chosen 将把 select 的 class 添加到容器上












选项默认值描述
allow_single_deselectfalse设置为 true 时非必选的单选框会显示清除选中项图标
disable_searchfalse设置为 true 隐藏单选框的搜索框
disable_search_threshold0少于 n 项时隐藏搜索框
enable_split_word_searchtrue是否开启分词搜索,默认开启
inherit_select_classesfalse是否继承 select 元素的 class,如果设为 true,Chosen 将把 select 的 class 添加到容器上
max_selected_optionsInfinity最多选择项数,达到最大限制时会触发 chosen:maxselected 事件
no_results_text"No results match"没有搜索到匹配项时显示的文字
placeholder_text_multiple"Select Some Options"多选框没有选中项时显示的占位文字
placeholder_text_single"Select an Option"单选框没有选中项时显示的占位文字
search_containsfalse搜素包含项,默认从第一个字符开始匹配
single_backstroke_deletetrue多选框中使用退格键删除选中项目,如果设为 false,第一次按 delete/backspace 会高亮最好一个选中项目,再按会删除该项
widthOriginal select width.Chosen 生成的选择框宽度,默认为和原 select 宽度保持一致
display_disabled_optionstrue是否显示禁止选择的项目
display_selected_optionstrue多选框是否在下拉列表中显示已经选中的项

属性

可以通过在  上设置属性传递给 Chosen。

  Option 1  Option 2  Option 3
属性描述
data-placeholder占位符文字 
注意: 改属性会覆盖 placeholder_text_multiple 或 placeholder_text_single 选项。
multiple有此属性的 select 会渲染成可以多选的 Chosen 选框
selected, disabled设置选中、禁止状态,Chosen 会读取这些属性

触发事件

Chosen 会在源  元素上触发事件。

$('.my_select_box').on('change', function(e, params) {  do_something(e, params);
});
事件描述
changeChosen 触发标准的 change 事件,同时会传递 selected or deselected 参数, 方便用户获取改变的选项


chosen:readyChosen 实例化完成时触发
chosen:maxselected超过 max_selected_options 设置时触发
chosen:showing_dropdownChosen 下拉选框打开完成时触发
chosen:hiding_dropdownChosen 下拉选框关闭完成时触发
chosen:no_results搜索没有匹配项时触发

注意:所有 Chosen 自定义事件 都包含 Chosen 实例 chosen 对象作为参数。

Chosen 监听的事件

通过在  元素上触发特定事件可以调用 Chosen 的监听函数。

// tell Chosen that a select has changed$('.my_select_box').trigger('chosen:updated');
事件描述
chosen:updated通过 JS 改变 select 元素选项时应该触发此事件,以更新 Chosen 生成的选框
chosen:activate相当于 HTML focus 事件
chosen:open激活 Chosen 并显示搜索结果
chosen:close关闭 Chosen 并隐藏搜索结果