# @beisen-phoenix/select

> ## 概述

Latest version **3.3.55** (published 2019-11-25) · ISC license · 0 weekly downloads

## Install

```sh
npm install @beisen-phoenix/select
pnpm add @beisen-phoenix/select
yarn add @beisen-phoenix/select
bun add @beisen-phoenix/select
```

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 3.3.55 |
| Published | 2019-11-25 |
| First published | 2019-02-27 |
| Weekly downloads | 0 |
| License | ISC |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 6 |
| Unpacked size | 117.6 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Maintainers | beisencorp |

## Links

- npm: https://www.npmjs.com/package/@beisen-phoenix/select
- npm.io page: https://npm.io/package/@beisen-phoenix/select

## Dependencies (6)

- [@beisen-phoenix/icon](https://npm.io/package/@beisen-phoenix/icon.md) ^3.2.54
- [@beisen-phoenix/tooltip](https://npm.io/package/@beisen-phoenix/tooltip.md) ^3.3.55
- [@beisen-phoenix/container](https://npm.io/package/@beisen-phoenix/container.md) ^3.3.55
- [@beisen-phoenix/style-token](https://npm.io/package/@beisen-phoenix/style-token.md) ^3.3.55
- [@beisen-phoenix/common-utils](https://npm.io/package/@beisen-phoenix/common-utils.md) ^3.3.55
- [@beisen-phoenix/unmodeled-layer](https://npm.io/package/@beisen-phoenix/unmodeled-layer.md) ^3.3.55

## Recent versions

- 3.3.55 (latest) — 2019-11-25
- 3.2.44-rc.1 (rc) — 2019-10-24
- 3.3.54 — 2019-11-25
- 3.3.53 — 2019-11-25
- 3.3.52 — 2019-11-24
- 3.3.51 — 2019-11-23
- 3.3.50 — 2019-11-22
- 3.3.49 — 2019-11-22
- 3.3.48 — 2019-11-22
- 3.3.47 — 2019-11-22
- 3.3.46 — 2019-11-22
- 3.3.45 — 2019-11-21
- 3.3.43 — 2019-11-21
- 3.3.42 — 2019-11-21
- 3.3.41-beta.1 — 2019-11-21
- … 427 more at https://npm.io/package/@beisen-phoenix/select/versions

## README

#Select

## 概述

select 下拉选择框

## API

| 参数          | 说明                                                                    | 类型                  | 默认值   | 必须 |
| ------------- | ----------------------------------------------------------------------- | --------------------- | -------- | ---- |
| size          | 选择框的大小，选项（small, normal, large）                              | String                | normal   | No   |
| isSearch      | 是否开启搜索功能（是否可输入）                                          | Boolean               | false    | No   |
| value         | 当前选择框中显示的选项                                                  | String 或 Array<Item> | 无       | No   |
| showDelete    | 单选模式下是否显示清空图标                                              | Boolean               | true     | No   |
| isMultiSelect | 是否为多选选择器                                                        | Boolean               | false    | No   |
| readOnly      | 是否只读                                                                | Boolean               | false    | No   |
| isActive      | 是否处于边框高亮状态                                                    | Boolean               | false    | No   |
| placeHolder   | 选择框的占位符                                                          | String                | ‘请输入’ | No   |
| disabled      | 是否禁用选择器                                                          | boolean               | false    | No   |
| error         | 校验错误                                                                | boolean               | false    | No   |
| onChange      | 选择框的值发生变化后的回调，返回值 （value, searchWord）                | Function              | 无       | No   |
| onDelete      | 删除选项后的回调，返回值 （value）                                      | Function              | 无       | No   |
| onSearch      | 可搜索情况下，输入框的值变化后的回调，返回值 （searchWord）             | Function              | 无       | No   |
| extraCls      | 自定义组件容器 class,一般用于覆盖组件默认样式使用 (2019-09-11 新增 api) | string                | 无       | 否   |
| onClick       | 点击选择器回调                                                          | Function ，返回值(e)  | 无       | No   |
| suffix        | 后缀元素，用于替换下拉箭头                                              | React.ReactNode       | -        | 否   |
| lang          | 当前语言环境(zh_CN,en_US,zh_TW)                                         | string                | zh_CN    | 否   |

## item

传人的数据是数组，每一项的结构如下：

| 参数     | 说明           | 类型    | 默认值 | 必须 |
| -------- | -------------- | ------- | ------ | ---- |
| label    | 实际显示的文案 | String  | 无     | Yes  |
| value    | 选项的实际值   | String  | 无     | Yes  |
| disabled | 禁止该选项     | boolean | false  | No   |

## 多语言

| 参数        | 说明                        | 类型                  | 默认值                  | 必须 |
| ----------- | --------------------------- | --------------------- | ----------------------- | ---- |
| translation | 语言包 用于翻译组件内置常量 | {placeHolder: string} | {placeHolder: '请选择'} | NO   |

### 2019-08-27

1. 修改交互，单选可输入选择器，激活输入框时，当前选中项变为提示文字 http://nature.beisen.co/NaturedesignSpec/Naturedesign3.0/NaturedesignSpec-PC/preview/%5bPC%5dNaturedesign3.0.5/4DataEntry-05-Selector/
2. 修改交互，单选可输入选择器，激活输入框时,点击清空，输入框保持激活
3. 添加 showDelete，是否显示清空图标

### 2019-11-19

> 新增 lang 属性，用于表示当前的语言环境，取值范围为“zh_CN,zh_TW,en_US”内部新增中文简体、英文、中文繁体语言包。

### 2019-09-26

需要外部控制激活态【边框高亮】，除点击可输入框激活时会高亮外，内部不处理可输入及不可输入激活失焦问题
| isActive | 是否处于边框高亮状态 | Boolean | false | No |

### 2019-09-17

新增
| suffix | 后缀元素，用于替换下拉箭头 | React.ReactNode | - | 否 |

---
_Source: https://npm.io/package/@beisen-phoenix/select · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
