• chosen.jquery.js 插件的使用和总结


    chosen.jquery.js 插件的使用及总结

    1. chosen插件简单的介绍:

    Chosen 是select下拉框美化插件,它能让丑陋的、很长的select选择框变的更好看、更方便。此外,还可以搜索查找下拉选项。它可对列表进行分组,同时也可禁用某些选择项。chosen.jquery.js 让你下拉框更简洁实用!

    chosen插件依赖于jQuery库或者prototype,使用chosen插件之前要先引入jQuery或者prototype;

    没有引入jquery,要先引入jquery(点击这里jquery线上引入以及下载链接

    chosen插件下载及使用教程:https://harvesthq.github.io/chosen/

    chosen插件的选项介绍:https://harvesthq.github.io/chosen/options.html

    chosen插件css线上cdn引入:

    <link href=”https://cdn.bootcss.com/chosen/1.5.1/chosen.min.css” rel=’stylesheet />
    
    • 1

    chosen插件线上cdn引入:

    <script src=’https://cdn.bootcss.com/chosen/1.5.1/chosen.jquery.js’>script>
    
    • 1

    引入jquery和chosen插件,对需要美化的下拉框执行chosen函数:$(selector).chosen(options);就可以把selector下拉框写成样式类,这样执行完chosen函数后,只要加上样式就可以了;

    部分效果示例如下:
    原单选下拉框:在这里插入图片描述
    使用chosen插件美化后的单选下拉框:

    在这里插入图片描述
    原多选下拉框:
    在这里插入图片描述
    使用chosen插件美化后的多选下拉框:
    在这里插入图片描述
    当然,chosen插件支持下拉框搜索:
    在这里插入图片描述

    2. chosen插件部分实用功能

    隐藏单选搜索(如果有n个或更少的选项,则可以指定该选项以隐藏单选时的搜索输入):

    $(".chosen-select").chosen({disable_search_threshold: 10});
    
    • 1

    无结果文本支持(设置本文支持,当搜索下拉框时没有搜索到内容时的提示信息):

    $(".chosen-select").chosen({no_results_text:"没有搜索结果"});
    
    • 1

    限制多选中的选定个数(该参数限制用户可以选择的选项数量):

    $(".chosen-select").chosen({max_select_options: 5});
    
    • 1

    如果已经达到最大限制再次选择会触发事件:

    $(".chosen-select").bind("chosen:maxselected",function(){·····});
    
    • 1

    允许在单选时取消选择(当前下拉框不是必选时,可以设置该元素取消选项,该配置只对第一个选项有空白文本时才有效):

    $(".chosen-select").chosen({allow_single_deselect: true});
    
    • 1

    支持下拉框从右到左的文本(默认为从左到右):

    $(.chosen-select”).chosen({rtl: true});
    
    • 1

    监听值的改变(监听改变,选择或取消选择时,都会触发改变事件):

    $("#form_field").chosen.change(······);
    
    • 1

    摧毁选择恢复初始:

    $("#form_field").chosen("destroy");
    
    • 1

    chosen自定义宽度:

    $(".chosen-select").chosen({width:"95%"})
    • 1

    3. chosen插件选项:

    选项默认描述
    allow_single_deselectfalse设置为true时有空白选项(值和文本都是空)的单选下拉框会显示清除选中的图标(X号)
    disable_searchfalse禁用下拉框搜索,设置为true时隐藏单选下拉框的搜索框
    disable_search_threshold0禁用搜索框的阈值,当选项数量少于这个阈值时会隐藏搜索框
    enable_split_word_searchtrue是否开启分词搜索,默认开启
    inherit_select_classesfalse是否继承select元素的class,如果设置为true,chosen将把select的class添加到列表上
    max_selected_optionsinfinity最多选项数,达到最大限制时会触发 chosen:maxselected事件
    no_result_text“No results match”没有搜索到匹配项时的提示文字
    placeholder_text_multiple“Select Some Options”多选框没有选中项时的占位文字
    placeholder_text_single“Select an Option”单选框没有选中项时的占位文字
    search_containsfalse模糊搜索,false表示从第一个字符开始匹配,true表示只要选项包含搜索词即可
    single_backstroke_deletetrue多选下拉框中使用一次退格键即可删除选中项目。为true,点击一次退格键即可删除。为false第一次按delete/backspace会高亮要删除的项目,再按一次delete/backspace会删除该选项
    group_searchtrue下拉框内分组是否可搜索。false不可搜索,true可搜索
    widthOriginal select widthChosen生成的选择框宽度,默认值和原select宽度一致,设置值后会覆盖原select的宽度,如果执行chosen函数时下拉框还是隐藏的,必须设置width,否则下拉框设置为可见时宽度为0
    display_disable_optionstrue是否显示仅禁止选择的项目
    display_selected_optionstrue多选下拉框是否在下拉列表中显示已经选中的项。为false时下拉列表不显示已经选中的选项,为true时下拉列表会显示选中的选项,但会用特殊的样式标识。这个配置对单选下拉框无效
    include_group_lable_in_selectedfalse选中选项是否显示选项分组。false不显示,true显示。默认为false
    max_shown_resultsinfinity搜索结果最大显示数量。数量设置的小,可以提高速度
    case_sensitive_searchfalse搜索大小写敏感。为false大小写不敏感,为true大小写敏感
    hide_result_on_selecttrue搜索结果隐藏已选中的选项,只对多选下拉框有效。为true表示隐藏,为false表示不隐藏
    rtlfalse文字方向是否改为从右向左。true表示文字方向从右向左,false表示从左向右

    3. chosen插件监听事件

    chosen会在源