bootstrap-select,selectpicker 用法详细:通过官方文档翻译
用过selectpicker的都说好~但是网上中文的教程又找不到比较完整的用法,于是去官网看了下 顺便弄过来翻译一下:
选项可以通过数据属性或JavaScript传递。对于数据属性,附加选项名称data-
,如 data-style=""
或data-selected-text-format="count"
参数名 | 类型 | 默认值 | 描述 |
---|---|---|---|
actionsBox | bool | false |
当设置为 |
container | string| false | false |
当设置为一个字符string,追加选择一个特定的元素或选择器,例如 |
countSelectedText | string| function |
function |
设置当selectedTextFormat是显示文本的格式 当设定为一个函数,第一个参数是所选择的选项的数目,并且第二个是选项的总数。该函数必须返回一个字符string。 |
deselectAllText | string | 'Deselect All' |
当取消选择所有选项按钮上的文本 |
dropdownAlignRight | bool | 'auto' |
false |
对齐菜单,而不是左右。如果设置为 |
dropupAuto | bool | true |
进行检查以查看其具有更多的空间,上方或下方。如果dropup有足够的空间完全打开正常,但上面有更大的空间,在dropup仍能正常打开。否则,就变成了dropup。如果dropupAuto设置为false,dropups必须手动调用。 |
header | string | false |
增加了菜单的顶部的头部; 默认包含关闭按钮 |
hideDisabled | bool | false |
从菜单中删除禁用的选项和optgroups |
iconBase | string | 'glyphicon' |
将基地使用不同的图标字体代替Glyphicons。如果改变iconBase,你也可能要更改 |
liveSearch | bool | false |
当设置为 |
liveSearchNormalize | bool | false |
设置liveSearchNormalize以 |
liveSearchPlaceholder | string | null |
当设置为一个字符string,一个占位符属性等于该字符string将被添加到实况搜索输入。 |
liveSearchStyle | string | 'contains' |
当设置为 |
maxOptions | integer | false | false |
当设置为一个integer ,并在多选择,所选选项的数量不能超过给定值。 该选项还可以存在作为数据属性为 |
maxOptionsText | string| array | function | function |
启用maxOptions时所显示的文本,并为给定的方案选项的最大数量已被选定。 如果使用的功能,它必须返回一个数组。阵列[0]是当maxOptions被施加到整个选择元件使用的文本。阵列[1]是当maxOptions上的OPTGROUP用于使用的文本。如果使用字符string,相同的文字用于元素和OPTGROUP两者。 |
mobile | bool | false |
当设置为 |
multipleSeparator | string | ', ' |
坐落在分隔所选选项的按钮显示的字符。 |
noneSelectedText | string | 'Nothing selected' |
当多个选择时所显示的文本没有选择的选择。 |
selectAllText | string | 'Select All' |
当选择了所有选项,按钮上的文本 |
selectedTextFormat | 'values' | 'static' | 'count' | 'count > x' (其中,x是integer ) |
'values' |
指定选择如何显示有多个选择。
|
selectOnTab | bool | false |
当设置为 |
showContent | bool | true |
当设置为 |
showIcon | bool | true |
当设置为 |
showSubtext | bool | false |
当设置为 |
showTick | bool | false |
show(没有的项目上选择的选项勾选 |
size | 'auto' | integer | false |
'auto' |
当设置为 当设置为integer 时,菜单将显示项目的给定数量,即使下拉被切断。 当设置为 |
style | string| null | null |
当设置为一个字符string,添加值到该按钮的风格。 |
tickIcon | string | 'glyphicon-ok' |
设置要使用的图标旁边显示的“滴答”来选择的选项。 |
title | string| null | null |
对于selectpicker的默认标题。 |
width | 'auto' | 'fit' | css-width| false(其中css-width 是单位CSS的宽度,例如100px ) |
false |
当设置为 当设置为一个css-宽度,所述selectpicker的宽度内联强制为给定值。 当设置为 |
windowPadding | integer | array | 0 |
这是在该窗口中有一个下拉菜单中不应该涉及的领域情况下非常有用-例如一个固定的头。当设置为一个integer ,同样填充将被添加到四面八方。可替代地,一个integer 数组可以在格式来使用
|