layui/package/document-component/src/document/zh-CN/components/select.md

::: anchor :::

::: title 基本介绍 :::

::: describe 用于代替原生的选择器，或者需要一个更优雅的多选器时。支持关键词查询 :::

::: title 基础使用 :::

::: demo 使用 lay-select 标签, 创建下拉选择框

:::

::: title 数据联动 :::

::: demo

切换-当前值 : {{value2}}

:::

::: title 选择禁用 :::

::: demo

:::

::: title 关键词变化事件，可作为远程搜索处理算法 :::

::: demo

:::

::: title 选择项自定义搜索内容，可以在keyword属性中传入拼音用于支持拼音搜索 :::

::: demo

:::

::: title 传入items属性进行选项渲染 :::

::: demo

:::

::: title 传入create属性和接收create事件用于开启创建子项功能 :::

::: demo

当前元素: {{items.map(o=>o.label).join()}}

:::

::: title 海量数据 :::

::: demo

:::

::: title 多选使用 :::

::: demo

点击切换(当前值:{{mvalue.join()}})

:::

::: title Select 属性 :::

::: table

属性	描述	类型	可选值	默认值
v-model	选中值	string/number/Array	-	-
name	原生 name 属性	string	-	-
placeholder	默认空提示语	string	-	请选择
disabled	是否禁用	boolean	true false	false
showEmpty	是否增加空提示选项	boolean	true false	true
multiple	是否为多选	boolean	true false	false
create	是否允许创建	boolean	true false	false
size	尺寸	string	lg md sm xs	md

:::

::: title Select 事件 :::

::: table

属性	描述	接收值
change	切换事件	value
search	关键词变化事件	用户输入的关键词 string
create	允许创建情况下的创建回调事件	用户输入的关键词 string

:::

::: title Select Option 属性 :::

::: table

::: table

属性	描述	类型	可选值	默认值
label	标签值(必填)	string	-	-
value	值	string / number	-	-
keyword	用于匹配关键词的数据，传入文本+拼音可以支持拼音搜索	string	-	-
disabled	是否禁用	boolean	true false	false

:::

::: title Select Option 插槽 :::

::: table

属性	描述	接收值
default	默认(label)	-

:::

::: contributor select :::

::: previousNext select :::