这是所有 Select2 配置选项的列表。
选项 | 类型 | 默认值 | 描述 |
---|---|---|---|
ajax |
对象 | null |
提供对以下项的支持:AJAX 数据源. |
allowClear |
布尔值 | false |
提供对以下项的支持:可清除的选择. |
amdLanguageBase |
字符串 | ./i18n/ |
参见在 AMD 或 CommonJS 加载器中使用 Select2. |
closeOnSelect |
布尔值 | true |
控制在做出选择后下拉菜单是否被关闭. |
data |
对象数组 | null |
允许从以下内容渲染下拉选项:数组. |
dataAdapter |
SelectAdapter |
用于覆盖内置的DataAdapter. | |
debug |
布尔值 | false |
在浏览器控制台中启用调试信息。 |
dir |
字符串 | ltr |
设置选择框和下拉容器上的dir 属性,以指示文本方向。 |
disabled |
布尔值 | false |
当设置为true ,则选择控件将被禁用。 |
dropdownAdapter |
DropdownAdapter |
用于覆盖内置的DropdownAdapter | |
dropdownAutoWidth |
布尔值 | false |
|
dropdownCssClass |
字符串 | '' |
向下拉容器添加额外的 CSS 类。辅助类:all: 可用于添加原始元素上存在的所有 CSS 类<select> 元素上。 |
dropdownParent |
jQuery 选择器或 DOM 节点 | $(document.body) |
允许您自定义下拉位置的下拉菜单。 |
escapeMarkup |
回调函数 | Utils.escapeMarkup |
处理由自定义模板渲染的内容的自动转义. |
language |
字符串或对象 | EnglishTranslation |
指定 Select2 使用的消息所使用的语言. |
matcher |
一个接收搜索参数和params 和data 对象的回调函数。 |
处理自定义搜索匹配. | |
maximumInputLength |
整数 | 0 |
可以为搜索词输入的最大字符数。 that may be provided for a search term. |
maximumSelectionLength |
整数 | 0 |
多选控件中可选项目的最大数量。如果此选项的值小于 1,则选中项的数量将不受限制。 |
minimumInputLength |
整数 | 0 |
开始搜索所需的最小字符数。 |
minimumResultsForSearch |
整数 | 0 |
所需的最少结果数量才能显示搜索框. |
multiple |
布尔值 | false |
此选项启用多选(药丸盒)模式。Select2 在初始化期间会自动将multiple HTML 属性的值映射到此选项。 |
placeholder |
字符串或对象 | null |
指定控件的占位符占位符文本。 |
resultsAdapter |
ResultsAdapter |
用于覆盖内置的ResultsAdapter. | |
selectionAdapter |
SingleSelection 或MultipleSelection ,具体取决于multiple . |
用于覆盖内置的SelectionAdapter. | |
selectionCssClass |
字符串 | '' |
向选择容器添加额外的 CSS 类。辅助类:all: 可用于添加原始元素上存在的所有 CSS 类<select> 元素上。 |
selectOnClose |
布尔值 | false |
实现在下拉菜单关闭时自动选择清除搜索字段中的输入。 |
sorter |
回调函数 | ||
tags |
布尔值 / 对象数组 | false |
用于启用自由文本响应. |
templateResult |
回调函数 | 自定义选择项的渲染方式. | |
templateSelection |
回调函数 | 自定义选择项的渲染方式. | |
theme |
字符串 | default |
允许您设置主题. |
tokenizer |
回调函数 | 一个处理自由文本输入自动分词的回调函数. | |
tokenSeparators |
数组 | null |
应该作为分词条分隔符使用的字符列表。 |
width |
字符串 | resolve |
支持自定义容器宽度. |
scrollAfterSelect |
布尔值 | false |
如果true ,解决使用closeOnSelect: false 时出现的问题,该问题会在每次选择/取消选择之后将结果列表滚动到第一个选中项(参见 https://github.com/select2/select2/pull/5150)。这个行为原本是为了处理无限滚动 UI 问题(如果您需要此行为,请设置false ),但它在固定长度的多选下拉框中引发了一个问题。此 pull request 添加了一个可配置选项,可在两种期望的行为之间切换。 |