# @aligov/components-easy-select

> 基于fusion的select进行封装的业务组件

Latest version **1.0.1** (published 2020-03-04) · MIT license · 0 weekly downloads

## Install

```sh
npm install @aligov/components-easy-select
pnpm add @aligov/components-easy-select
yarn add @aligov/components-easy-select
bun add @aligov/components-easy-select
```

## Health

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

Positive: no vulnerabilities; popular repo.

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

Negative: abandoned.

## Facts

| | |
|---|---|
| Version | 1.0.1 |
| Published | 2020-03-04 |
| First published | 2019-08-08 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 3 |
| Unpacked size | 1013.4 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 18615 |
| Maintainers | abell123456, itrip, jerrywang12, liunian, mo.zhou, tao1991123, xiazhiqiang, zhousufa |
| Keywords | ice, react, component |

## Links

- npm: https://www.npmjs.com/package/@aligov/components-easy-select
- Repository: https://github.com/alibaba/ice
- Homepage: https://unpkg.com/@aligov/components-easy-select@1.0.1/build/index.html
- Issues: https://github.com/alibaba/ice/issues
- npm.io page: https://npm.io/package/@aligov/components-easy-select

## Dependencies (3)

- [prop-types](https://npm.io/package/prop-types.md) ^15.5.8
- [@alifd/next](https://npm.io/package/@alifd/next.md) ^1.16.6
- [lodash.omit](https://npm.io/package/lodash.omit.md) ^4.5.0

## Alternatives

- [mobx-react](https://npm.io/package/mobx-react.md) — 2.8M weekly downloads
- [rc-tree](https://npm.io/package/rc-tree.md) — 2.6M weekly downloads
- [@react-oauth/google](https://npm.io/package/@react-oauth/google.md) — 1.3M weekly downloads
- [@wagmi/connectors](https://npm.io/package/@wagmi/connectors.md) — 877.0K weekly downloads
- [vee-validate](https://npm.io/package/vee-validate.md) — 836.4K weekly downloads

## Recent versions

- 1.0.1 (latest) — 2020-03-04
- 1.0.0 — 2019-08-08

## README

# easySelect

@aligov/components-easy-select

简易下拉选择器

## 何时使用

相比 next 的 Select，功能上多了一个下拉数据自动请求，外部不用关注请求，只要获取选择结果即可

- 支持
  - 输入后，只能从下拉框选择；
  - 或者输入后，保留输入值，也可以从下拉框选择；💔**但这种情况从下拉框选择后显示的是 value，目前未解决这个问题**
- 可以结合 field 使用

## Install

```bash
tnpm install @alife/whale-easy-select --save
```

## API

**除有说明的属性，其他同 next 的 select**

| 成员                 | 说明                                                                                    | 类型     | 默认值    |
| -------------------- | --------------------------------------------------------------------------------------- | -------- | --------- |
| auto                 | 是否自动请求，在初始的时候就请求数据                                                    | Boolean  | false     |
| autoSearchValue      | 自动请求时的请求值，非 undefined 且 auto 为 true 时有效                                 | Any      | undefined |
| service              | 必填，请求服务<br>签名:<br>Function(value: String) => promise                           | Function | 无        |
| initDataSource       | 初始数据源，可以是静态的数组或函数（同步或异步函数），函数接受一个入参，来自初始化时 props 中的 value/autoSearchValue/defaultValue  | Array、Function    | []  |
| onlySelect           | 是否只能用下拉选择的值，不能使用自己输入的值，默认可以使用自己输入的值                  | Boolean  | false     |
| transformSearchValue | 用于搜索时把选择的值转换后再发送 NOTE::不建议使用，业务在 service 里转换即可         | Function | func.noop |
| isMultiFooter        | mode为multiple时是否有底部全选部分                                                      | Boolean  | true      |
| filterLocal          | 是否本地过滤，若开启，则搜索时仅从本地数据源过滤，不会再请求远程数据。（auto 还是有效） | Boolean  | false     |
|fetchWhenEmptySearch| 搜索为空时是否也触发请求，默认false，即默认 clear 时不会触发请求 | Boolean  | false     |


## 注意

当使用动态搜索时，需要将filterLocal设置为false.

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