选项

这是所有 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 一个接收搜索参数和paramsdata对象的回调函数。 处理自定义搜索匹配.
maximumInputLength 整数 0 可以为搜索词输入的最大字符数。 that may be provided for a search term.
maximumSelectionLength 整数 0 多选控件中可选项目的最大数量。如果此选项的值小于 1,则选中项的数量将不受限制。
minimumInputLength 整数 0 开始搜索所需的最小字符数。
minimumResultsForSearch 整数 0 所需的最少结果数量才能显示搜索框.
multiple 布尔值 false 此选项启用多选(药丸盒)模式。Select2 在初始化期间会自动将multipleHTML 属性的值映射到此选项。
placeholder 字符串或对象 null 指定控件的占位符占位符文本。
resultsAdapter ResultsAdapter 用于覆盖内置的ResultsAdapter.
selectionAdapter SingleSelectionMultipleSelection,具体取决于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 添加了一个可配置选项,可在两种期望的行为之间切换。

无噪 Logo
无噪文档
25 年 6 月翻译
版本号 4.0.13
文档源↗