ant-design/components/select/index.md
2015-11-05 18:18:21 +08:00

2.2 KiB
Raw Blame History

Select

  • category: Components
  • chinese: 选择器
  • type: 表单

类似 Select2 的选择器。

何时使用

弹出一个下拉菜单给用户选择操作,用于代替原生的选择器,或者需要一个更优雅的多选器时。

<Select>
  <Option value="lucy">lucy</Option>
</Select>

API

Select props

参数 说明 类型 默认值
value 指定当前选中的条目 string/Array
defaultValue 指定默认选中的条目 string/Array
multiple 支持多选 false
filterOption 是否根据输入项进行筛选 true
tags 可以把随意输入的条目作为tag输入项不需要与下拉选项匹配 false
onSelect 被选中时调用参数为选中的option value值 function(value, option)
onDeselect 取消选中时调用参数为选中的option value值仅在multiple或tags模式下生效 function(value, option)
onChange 选中option或input的value变化(combobox模式下)时,调用此函数 function(value, label)
allowClear 显示清除按钮 false
placeholder 选择框默认文字 string
searchPlaceholder 搜索框默认文字 string
optionFilterProp 输入项过滤对应的 option 属性 string value
combobox 输入框自动提示模式 false
size 选择框大小,可选 large small String default

Option props

参数 说明 类型 默认值
disabled 是否禁用 Boolean false
key 如果react需要你设置此项此项值与value的值相同然后可以省略value设置 String
value 默认根据此属性值进行筛选 String -

OptGroup props

参数 说明 类型 默认值
label 组名 String/React.Element
key String -