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

## 使用

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

### 基本用法

```jsx
import React from 'react';
import { Select, Row, Col } from 'quanta-design';

export default () => (
  <div>
    <Row>
      <Col span={6}>
        <Select style={{ width: 160 }}></Select>
      </Col>
      <Col span={6}>
        <Select defaultValue="开放平台部" style={{ width: 160 }}>
          <Select.Option value="开放平台部">开放平台部</Select.Option>
          <Select.Option value="基础平台部">基础平台部</Select.Option>
          <Select.Option value="先进技术实验室">先进技术实验室</Select.Option>
        </Select>
      </Col>
      <Col span={6}>
        <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={6}>
        <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 'quanta-design';

export default () => (
  <div>
    <Row>
      <Col span={12}>
        <Select
          allowClear
          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 'quanta-design';

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 'quanta-design';

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 | 无     |      |