Merge pull request #1767 from ddcat1115/fix#1695

fix #1695 add demo & doc

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(
+  <div>
+    <Select labelInValue defaultValue={{ key: 'lucy' }} style={{ width: 120 }} onChange={handleChange}>
+      <Option value="jack">Jack</Option>
+      <Option value="lucy">Lucy</Option>
+    </Select>
+  </div>
+, mountNode);
+````

components/select/index.md

@@ -23,15 +23,15 @@ english: Select
 
 | 参数     | 说明           | 类型     | 默认值       |
 |----------|----------------|----------|--------------|
-| value    | 指定当前选中的条目 | string/Array<String>   |  无  |
-| defaultValue | 指定默认选中的条目 | string/Array<String>   |  无  |
+| value    | 指定当前选中的条目 | String/Array<String>/{key: String, label: React.Node}/Array<{key, label}>   |  无  |
+| defaultValue | 指定默认选中的条目 | String/Array<String>/{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