---
title: Select 选择器 (done)
order: 7
group: 
  path: /components
nav: 
  title: 组件
  path: /components
---

## 使用
下拉选择器，弹出一个下拉菜单给用户选择操作。

### 基本用法
```jsx
import React from 'react';
import { Select, Row, Col } from 'baas-ui';

export default () => (
  <div>
    <Row>
      <Col span={8}>
        <Select defaultValue="开放平台部" style={{ width: 160 }}>
          <Select.Option value="开放平台部">开放平台部</Select.Option>
          <Select.Option value="基础平台部">基础平台部</Select.Option>
          <Select.Option value="先进技术实验室">先进技术实验室</Select.Option>
        </Select>
      </Col>
      <Col span={8}>
        <Select defaultValue="开放平台部" style={{ width: 160 }}>
          <Select.Option value="开放平台部">开放平台部</Select.Option>
          <Select.Option value="基础平台部">基础平台部</Select.Option>
          <Select.Option disabled value="先进技术实验室">先进技术实验室</Select.Option>
        </Select>
      </Col>
      <Col span={8}>
        <Select disabled defaultValue="开放平台部" style={{ width: 160 }}>
          <Select.Option value="开放平台部">开放平台部</Select.Option>
          <Select.Option value="基础平台部">基础平台部</Select.Option>
          <Select.Option value="先进技术实验室">先进技术实验室</Select.Option>
        </Select>
      </Col>
    </Row>
  </div>
);

```

### 多选
```jsx
import React from 'react';
import { Select, Row, Col } from 'baas-ui';

export default () => (
  <div>
    <Row>
      <Col span={12}>
        <Select
          mode="multiple"
          defaultValue={['开放平台部', '财政部']}
          style={{ width: 320 }}
        >
          <Select.Option value="开放平台部">开放平台部</Select.Option>
          <Select.Option value="基础平台部">基础平台部</Select.Option>
          <Select.Option value="先进技术实验室">先进技术实验室</Select.Option>
          <Select.Option value="人力资源部">人力资源部</Select.Option>
          <Select.Option value="法务部">法务部</Select.Option>
          <Select.Option value="财政部">财政部</Select.Option>
        </Select>
      </Col>
      <Col span={12}>
        <Select
          mode="tags"
          defaultValue={['开放平台部', '财政部']}
          style={{ width: 320 }}
        >
          <Select.Option value="开放平台部">开放平台部</Select.Option>
          <Select.Option value="基础平台部">基础平台部</Select.Option>
          <Select.Option value="先进技术实验室">先进技术实验室</Select.Option>
          <Select.Option value="人力资源部">人力资源部</Select.Option>
          <Select.Option value="法务部">法务部</Select.Option>
          <Select.Option value="财政部">财政部</Select.Option>
        </Select>
      </Col>
    </Row>
  </div>
);

```

### 搜索
```jsx
import React from 'react';
import { Select } from 'baas-ui';

export default () => (
  <Select
    showSearch
    optionFilterProp="children"
    placeholder="请选择部门"
    style={{ width: 320 }}
  >
    <Select.Option value="开放平台部">开放平台部</Select.Option>
    <Select.Option value="基础平台部">基础平台部</Select.Option>
    <Select.Option value="先进技术实验室">先进技术实验室</Select.Option>
    <Select.Option value="人力资源部">人力资源部</Select.Option>
    <Select.Option value="法务部">法务部</Select.Option>
    <Select.Option value="财政部">财政部</Select.Option>
  </Select>
);
```

### 尺寸大小
```jsx
import React from 'react';
import { Select, Row, Col, Radio } from 'baas-ui';

class SelectSize extends React.Component {
  constructor() {
    super();
    this.state = {
      size: 'default',
    };
  }

  render() {
    const { size } = this.state;
    const handleSizeChange = (e) => {
      this.setState({ size: e.target.value });
    }
    return (
      <div>
        <div>
          <Radio.Group value={size} onChange={handleSizeChange}>
            <Radio.Button value="large">Large</Radio.Button>
            <Radio.Button value="default">Default</Radio.Button>
            <Radio.Button value="small">Small</Radio.Button>
          </Radio.Group>
        </div>
        <br />
        <Row>
          <Col span={8}>
            <Select size={size} defaultValue="开放平台部" style={{ width: 160 }}>
              <Select.Option value="开放平台部">开放平台部</Select.Option>
              <Select.Option value="基础平台部">基础平台部</Select.Option>
              <Select.Option value="先进技术实验室">先进技术实验室</Select.Option>
            </Select>
          </Col>
          <Col span={8}>
            <Select size={size} mode="multiple" defaultValue="开放平台部" style={{ width: 160 }}>
              <Select.Option value="开放平台部">开放平台部</Select.Option>
              <Select.Option value="基础平台部">基础平台部</Select.Option>
              <Select.Option disabled value="先进技术实验室">先进技术实验室</Select.Option>
            </Select>
          </Col>
          <Col span={8}>
            <Select size={size} mode="tags" disabled defaultValue="开放平台部" style={{ width: 160 }}>
              <Select.Option value="开放平台部">开放平台部</Select.Option>
              <Select.Option value="基础平台部">基础平台部</Select.Option>
              <Select.Option value="先进技术实验室">先进技术实验室</Select.Option>
            </Select>
          </Col>
        </Row>
      </div>
    );
  }
};

export default SelectSize;
```

## API

### Select props

| 参数 | 说明 | 类型 | 默认值 | 版本 |
| --- | --- | --- | --- | --- |
| allowClear | 支持清除 | boolean | false |  |
| autoClearSearchValue | 是否在选中项后清空搜索框，只在 `mode` 为 `multiple` 或 `tags` 时有效。 | boolean | true |  |
| autoFocus | 默认获取焦点 | boolean | false |  |
| defaultActiveFirstOption | 是否默认高亮第一个选项。 | boolean | true |  |
| defaultValue | 指定默认选中的条目 | string\|string\[]<br />number\|number\[]<br />LabeledValue\|LabeledValue[] | - |  |
| disabled | 是否禁用 | boolean | false |  |
| dropdownClassName | 下拉菜单的 className 属性 | string | - |  |
| dropdownMatchSelectWidth | 下拉菜单和选择器同宽。默认将设置 `min-width`。`false` 时会关闭虚拟滚动 | boolean \| number | true |  |
| dropdownRender | 自定义下拉框内容 | (menuNode: ReactNode, props) => ReactNode | - |  |
| dropdownStyle | 下拉菜单的 style 属性 | object | - |  |
| filterOption | 是否根据输入项进行筛选。当其为一个函数时，会接收 `inputValue` `option` 两个参数，当 `option` 符合筛选条件时，应返回 `true`，反之则返回 `false`。 | boolean or function(inputValue, option) | true |  |
| firstActiveValue | 默认高亮的选项 | string\|string\[] | - |  |
| getPopupContainer | 菜单渲染父节点。默认渲染到 body 上，如果你遇到菜单滚动定位问题，试试修改为滚动的区域，并相对其定位。[示例](https://codesandbox.io/s/4j168r7jw0) | Function(triggerNode) | () => document.body |  |
| labelInValue | 是否把每个选项的 label 包装到 value 中，会把 Select 的 value 类型从 `string` 变为 `{key: string, label: ReactNode}` 的格式 | boolean | false |  |
| maxTagCount | 最多显示多少个 tag | number | - |  |
| maxTagTextLength | 最大显示的 tag 文本长度 | number | - |  |
| maxTagPlaceholder | 隐藏 tag 时显示的内容 | ReactNode/function(omittedValues) | - |  |
| tagRender | 自定义 tag 内容 render | (props) => ReactNode | - |  |
| mode | 设置 Select 的模式为多选或标签 | `multiple` \| `tags` | - |  |
| notFoundContent | 当下拉列表为空时显示的内容 | string | 'Not Found' |  |
| optionFilterProp | 搜索时过滤对应的 option 属性，如设置为 children 表示对内嵌内容进行搜索。[示例](https://codesandbox.io/s/antd-reproduction-template-tk678) | string | value |  |
| optionLabelProp | 回填到选择框的 Option 的属性值，默认是 Option 的子元素。比如在子元素需要高亮效果时，此值可以设为 `value`。 | string | `children` （combobox 模式下为 `value`） |  |
| placeholder | 选择框默认文字 | string | - |  |
| showArrow | 是否显示下拉小箭头 | boolean | true |  |
| showSearch | 使单选模式可搜索 | boolean | false |  |
| size | 选择框大小 | `large` \| `middle` \| `small` | 无 |  |
| suffixIcon | 自定义的选择框后缀图标 | ReactNode | - |  |
| removeIcon | 自定义的多选框清除图标 | ReactNode | - |  |
| clearIcon | 自定义的多选框清空图标 | ReactNode | - |  |
| menuItemSelectedIcon | 自定义多选时当前选中的条目图标 | ReactNode | - |  |
| tokenSeparators | 在 tags 和 multiple 模式下自动分词的分隔符 | string\[] |  |  |
| value | 指定当前选中的条目 | string\|string\[]<br />number\|number\[]<br />LabeledValue\|LabeledValue[] | - |  |
| virtual | 设置 `false` 时关闭虚拟滚动 | boolean | - | 4.1.0 |
| onBlur | 失去焦点时回调 | function | - |  |
| onChange | 选中 option，或 input 的 value 变化（combobox 模式下）时，调用此函数 | function(value, option:Option/Array&lt;Option>) | - |  |
| onDeselect | 取消选中时调用，参数为选中项的 value (或 key) 值，仅在 multiple 或 tags 模式下生效 | function(string\|number\|LabeledValue) | - |  |
| onFocus | 获得焦点时回调 | function | - |  |
| onInputKeyDown | 按键按下时回调 | function | - |  |
| onMouseEnter | 鼠标移入时回调 | function | - |  |
| onMouseLeave | 鼠标移出时回调 | function | - |  |
| onPopupScroll | 下拉列表滚动时的回调 | function | - |  |
| onSearch | 文本框值变化时回调 | function(value: string) |  |  |
| onSelect | 被选中时调用，参数为选中项的 value (或 key) 值 | function(string\|number\|LabeledValue, option:Option) | - |  |
| defaultOpen | 是否默认展开下拉菜单 | boolean | - |  |
| open | 是否展开下拉菜单 | boolean | - |  |
| onDropdownVisibleChange | 展开下拉菜单的回调 | function(open) | - |  |
| loading | 加载中状态 | Boolean | false |  |
| bordered | 是否有边框 | Boolean | true |  |

> 注意，如果发现下拉菜单跟随页面滚动，或者需要在其他弹层中触发 Select，请尝试使用 `getPopupContainer={triggerNode => triggerNode.parentElement}` 将下拉弹层渲染节点固定在触发器的父元素中。

### Select Methods

| 名称    | 说明     | 版本 |
| ------- | -------- | ---- |
| blur()  | 取消焦点 |      |
| focus() | 获取焦点 |      |

### Option props

| 参数      | 说明                              | 类型           | 默认值 | 版本 |
| --------- | --------------------------------- | -------------- | ------ | ---- |
| disabled  | 是否禁用                          | boolean        | false  |      |
| title     | 选中该 Option 后，Select 的 title | string         | -      |      |
| value     | 默认根据此属性值进行筛选          | string\|number | -      |      |
| className | Option 器类名                     | string         | -      |      |

### OptGroup props

| 参数  | 说明 | 类型                  | 默认值 | 版本 |
| ----- | ---- | --------------------- | ------ | ---- |
| key   |      | string                | -      |      |
| label | 组名 | string\|React.Element | 无     |      |