diff --git a/components/select/demo/label-in-value.md b/components/select/demo/label-in-value.md new file mode 100644 index 0000000000..ee217219ce --- /dev/null +++ b/components/select/demo/label-in-value.md @@ -0,0 +1,24 @@ +--- +order: 10 +title: 获取 label +--- + +使用 `labelInValue` 属性,Option 的每项 label 会被包装到 value 中传递给 onChange 等函数,此时 Select 的 value 是一个对象。 + +````jsx +import { Select } from 'antd'; +const Option = Select.Option; + +function handleChange(value) { + console.log(value); +} + +ReactDOM.render( +
+ +
+, mountNode); +```` diff --git a/components/select/index.md b/components/select/index.md index 8d78603e15..eb83380327 100644 --- a/components/select/index.md +++ b/components/select/index.md @@ -23,15 +23,15 @@ english: Select | 参数 | 说明 | 类型 | 默认值 | |----------|----------------|----------|--------------| -| value | 指定当前选中的条目 | string/Array | 无 | -| defaultValue | 指定默认选中的条目 | string/Array | 无 | +| value | 指定当前选中的条目 | String/Array/{key: String, label: React.Node}/Array<{key, label}> | 无 | +| defaultValue | 指定默认选中的条目 | String/Array/{key: String, label: React.Node}/Array<{key, label}> | 无 | | multiple | 支持多选 | boolean | false | | allowClear | 支持清除, 单选模式有效 | boolean | false | | filterOption | 是否根据输入项进行筛选。当其为一个函数时,会接收 `inputValue` `option` 两个参数,当 `option` 符合筛选条件时,应返回 `true`,反之则返回 `false`。 | boolean or function(inputValue, option) | true | | tags | 可以把随意输入的条目作为 tag,输入项不需要与下拉选项匹配 | boolean |false | | onSelect | 被选中时调用,参数为选中项的 value 值 | function(value, option) | 无 | | onDeselect | 取消选中时调用,参数为选中项的 option value 值,仅在 multiple 或 tags 模式下生效 | function(value) | 无 | -| onChange | 选中option,或input的value变化(combobox 模式下)时,调用此函数 | function(value, label) | 无 | +| onChange | 选中 option,或 input 的 value 变化(combobox 模式下)时,调用此函数 | function(value) | 无 | | onSearch | 文本框值变化时回调 | function(value: String) | | | placeholder | 选择框默认文字 | string | 无 | | notFoundContent | 当下拉列表为空时显示的内容 | string | 'Not Found' | @@ -43,6 +43,7 @@ english: Select | showSearch | 在选择框中显示搜索框 | boolean | false | | disabled | 是否禁用 | boolean | false | | getPopupContainer | 菜单渲染父节点。默认渲染到 body 上,如果你遇到菜单滚动定位问题,试试修改为滚动的区域,并相对其定位。[示例](http://codepen.io/anon/pen/xVBOVQ?editors=001) | Function(triggerNode) | () => document.body | +| labelInValue | 是否把每个选项的 label 包装到 value 中,决定 Select 的 value 类型。 | boolean | false | ### Option props