From 02ce67d44c0d1fcfb9ad570700b4004415c5327c Mon Sep 17 00:00:00 2001 From: ddcat1115 Date: Thu, 19 May 2016 13:44:08 +0800 Subject: [PATCH 1/2] fix #1695 add demo & doc --- components/select/demo/label-in-value.md | 24 ++++++++++++++++++++++++ components/select/index.md | 7 ++++--- 2 files changed, 28 insertions(+), 3 deletions(-) create mode 100644 components/select/demo/label-in-value.md 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 From 25acdfd29a69869f63227a16627bdb28d48fdb75 Mon Sep 17 00:00:00 2001 From: Leon Shi Date: Thu, 19 May 2016 15:28:45 +0800 Subject: [PATCH 2/2] Update Changelog (#1770) --- CHANGELOG.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 813720dd09..dda67dff39 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -75,8 +75,9 @@ timeline: true - 完全移除了 `0.12` 中废弃的 Validation 组件，可以直接 import [rc-form-validation](https://github.com/react-component/form-validation) 用以代替。[#1096](https://github.com/ant-design/ant-design/issues/1096) - Breadcrumb.Item 的 `href` 属性被移除，请直接用 `a` 标签包裹可点击的内容。 -- Modal 移除 了`align` 属性，现在可以使用 `style` 属性调整位置。 +- Modal 移除了 `align` 属性，现在可以使用 `style` 属性调整位置。 - `Modal.confirm` 等方法的配置项 `iconClassName` 重命名为 `iconType`。 +- Select 移除了 `onChange` 中的 `label` 参数，新增了 `labelInValue` 属性。[#1695](https://github.com/ant-design/ant-design/issues/1695) #### 有兼容提示的改动