# @core-rc/rc-select 中文文档

规范地址：https://npmcn.com/package/%40core-rc/rc-select/

版本：0\.1\.4
npm 元数据更新时间：2025-08-14T02:09:55.924Z
中文译文更新时间：2026-11-10T18:51:01.719Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40core-rc/rc-select
原文对照：https://npmcn.com/package/%40core-rc/rc-select/?lang=original

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：287 kB，155 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=8\.x
- 运行依赖：12 个
- peer 依赖：react \>=16\.9\.0，react-dom \>=16\.9\.0
- 首次发布：2024-12-04T07:15:39.300Z
- 最新版本发布：2025-08-14T02:09:55.703Z
- 近 30 天下载量：4190（2026-10-11 至 2026-11-09，npm 官方下载统计）
- 已发布版本数：13（近 12 个月 0 个）

## 中文简介

反应选择

## 安装

```sh
npm install @core-rc/rc-select
```

也可以使用：`pnpm add @core-rc/rc-select`、`yarn add @core-rc/rc-select`、`bun add @core-rc/rc-select`

## README

# @ core-rc/ rc- 选择

* * *

反应 选择组件 .

## 特性

-   支持 IE11+、Chrome、Firefox、Safari 软件

### 键盘

-   打开选择(焦点输入QQ焦点并点击)
-   导航菜单的键下/ 键上/ 键入

## 安装

```
yarn add @core-rc/rc-select

```

或者说

```
npm install @core-rc/rc-select

```

## 使用量

### 基本用途

```jsx
import Select, { Option } from '@core-rc/rc-select';
import '@core-rc/rc-select/assets/index.css';

export default () => (
  <Select>
    <Option value="jack">jack</Option>
    <Option value="lucy">lucy</Option>
    <Option value="yiminghe">yiminghe</Option>
  </Select>
);
```

## API 密码

### 选择道具

| 名称 | 说明 | 类型 | 默认 |
| --- | --- | --- | --- |
| 编号 | html id 设置在组件包装上 | 字符串 | '' |
| 类Name | 根多姆节点的额外 cs 类 | 字符串 | '' |
| 数据\* | html 数据属性设置在组件包上 | 字符串 | '' |
| 前缀 Cls | 前缀类 | 字符串 | '' |
| 动画 | 倒下动画名. 现在只支持幻灯片 | 字符串 | '' |
| 过渡Name | 放下 css 动画名称 | 字符串 | '' |
| 选项转换Name | css 多模式所选项目的动画名称 | 字符串 | '' |
| 下拉Match 选择窗口 | 所选的下拉宽度是否相同 | 布尔 | 真实 |
| 降级Name | 适用于下拉的附加类Name | 字符串 | \- 说吧 |
| 下拉时尚 | 用于下拉的附加样式 | 反应 CSS 财产 | {} |
| 下拉对齐 | 用于下拉的额外对齐 | [对齐键](https://github.com/react-component/trigger/blob/728d7e92394aa4b3214650f743fc47e1382dfa68/src/interface.ts#L25-L80) | {} |
| 滴下梅努施蒂尔 | 用于下拉菜单的其他样式 | 对象 | 反应 CSS 财产 |
| 非目标 | 指定没有结果匹配时要显示的内容. | 反应节点 | "没有找到" |
| 符号分隔符 | 用于标记/ 多模式上的标识符 | 弦乐? |  |
| 打开 | 控件选择打开 | 布尔 |  |
| 默认打开 | 控件选择默认打开 | 布尔 |  |
| 占位符 | 选择占位符 | 反应节点 |  |
| 显示搜索 | 是否以单一模式显示搜索输入 | 布尔 | 真实 |
| 允许清除 | 是否允许清除 | 布尔 | {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}请回答 {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}请回答 |
| 标记 | 当标记被启用时,用户可以从原有的选项中选择,或者通过选择第一个选项来创建新的标签,这就是用户迄今为止输入搜索框的内容. | 布尔 | 虚假 |
| 标签渲染器 | 制作自定义标签. | (道具:自定义塔克道具) . 反应节点 | \- 说吧 |
| 最大标签文本Length | 要显示的最大标签文本长度 | 编号 | \- 说吧 |
| 最大标签 | 要显示的最大标签数 | 编号 | \- 说吧 |
| 最大标签定位符 | 省略值的占位符 | 反应节点/功能( 允许值) | \- 说吧 |
| 组合框 | 启用组合框模式( 无法同时设置多个) | 布尔 | 虚假 |
| 多个 | 是否选择多个 | 布尔 | 虚假 |
| 已禁用 | 是否选择禁用 | 布尔 | 虚假 |
| 筛选选项 | 是否通过输入值过滤选项。 选项的默认过滤器FilterProp 道具的值 | 布尔 | 真/ 功能( 输入值: 字符串, 选项: 选项) |
| 选项FilterProp | 如果过滤选项是真实的, 选择选项的prof值将被用于过滤 | 字符串 | "价值" |
| 过滤系统 | 排序搜索选项排序的函数,参见 [阵列. sort](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/sort)'比较功能. | 函数( 选项A: 选项B: 选项) | \- 说吧 |
| 选项标签 | 将选项值或选项子作为选中的内容 | 字符串 : “ 值 ” / “ 儿童 ” | "价值" |
| 默认值 | 初始选项 | 字符串 QQ 字符串 \[\] | \- 说吧 |
| 价值 | 当前选中选项 | 字符串 QQ 字符串 \[\] { key: string, 标签: react. 节点 {键:String, 标签: react. \[ | \- 说吧 |
| 标签 Invalue | 是否在值中嵌入标签,参见以上值类型。 不支持 `combobox` 模式 | 布尔 | 虚假 |
| 返回补充 | 是否回填选择搜索输入的选项( 仅以单一和组合框模式工作) | 布尔 | 虚假 |
| 变化 | 当选择选项或输入值变化时( combobox) 调用 | 函数( 值, 选项: 备选 QQ 选项\[\]) | \- 说吧 |
| 搜索 | 输入更改时调用 | 函数 | \- 说吧 |
| 布莱尔 | 模糊时调用 | 函数 | \- 说吧 |
| 焦点 | 焦点时调用 | 函数 | \- 说吧 |
| opup 滚动 | 滚动菜单时调用 | 函数 | \- 说吧 |
| 选择 | 选项时调用。 param 是选项的值和选项实例 | 函数( 值, 选项: 选项) | \- 说吧 |
| 取消选择 | 当一个选项被取消时调用。 param 是选项的值 。 只呼叫多个或标记 | 函数( 值, 选项: 选项) | \- 说吧 |
| 输入密钥下 | 输入时调用密钥 | 函数( 事件) | \- 说吧 |
| 默认首选项 | 默认是否启用第一个选项 | 布尔 | 真实 |
| 获取 Popup 容器 | 弹出时选择菜单的容器 | 函数( 触发: 节点): 节点 | 函数 (){返回文档.body;} |
| 获取输入元素 | 自定义输入元素 | 函数 (): 元素 | \- 说吧 |
| 显示动作 | 动作触发下拉以显示 | 弦乐? | \- 说吧 |
| 自动聚焦 | 挂载后选择焦点 | 布尔 | \- 说吧 |
| 自动清除搜索值 | 当选择多个选择时自动清除搜索输入值 | 布尔 | 真实 |
| 前缀 | 指定选中的前缀图标或文本 | 反应节点 | \- 说吧 |
| 后缀Icon | 指定选定的箭头图标 | 反应节点 | \- 说吧 |
| 清关 | 指定清晰的图标 | 反应节点 | \- 说吧 |
| 删除Icon | 指定删除图标 | 反应节点 | \- 说吧 |
| 菜单项目选中的Icon | 指定选中的项目图标 | 回放节点QQ(道具:菜单项目Props)QQ 反应节点 | \- 说吧 |
| 降温器 | 制作自定义下拉菜单 | (菜单:反应. (节点) 反应节点 | \- 说吧 |
| 装入 | 在箭头中显示装入图标 | 布尔 | 虚假 |
| 虚拟 | 禁用虚拟滚动 | 布尔 | 真实 |
| 方向 | 下降方向 | 'ltr' '' 'tl' 'tl' 'tl' 'tl' 't' 't' 't 'tl' '' 't' 't' 't' ''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' | '尔' |
| 选项 | 自定义渲染选项 | (或可选:平可选Data <Base可选Type > ,信息:{索引:编号}}}} 反应 反应节点 | \- 说吧 |
| 标签 | 自定义渲染标签 | (道具:LabelInValueType) =>. 反应 反应节点 | \- 说吧 |
| 最大数 | 可选择项目的最大数量 | 编号 | \- 说吧 |

### 方法

| 名称 | 说明 | 参数 | 返回时 |
| --- | --- | --- | --- |
| 焦点 | 焦点选择可编程 | \- 说吧 | \- 说吧 |
| 模糊 | 程序模糊选择 | \- 说吧 | \- 说吧 |

### 选项道具

| 名称 | 说明 | 类型 | 默认 |
| --- | --- | --- | --- |
| 类Name | 选项的额外类别 | 字符串 | '' |
| 已禁用 | 此项目的点击或按键没有效果 | 布尔 | 虚假 |
| 键 | 如果想要您设置密钥, 那么密钥与值相同, 您可以省略值 | 字符串/数字 | \- 说吧 |
| 价值 | 由此属性默认过滤 。 如果想要您设置密钥, 那么密钥与值相同, 您可以省略值 | 字符串/数字 | \- 说吧 |
| 标题 | 如果您对自动生成不满意 `title` 在选定值上徘徊时显示的,您可以用此属性自定义 | 字符串 | \- 说吧 |

### OptGroup 道具

| 名称 | 说明 | 类型 | 默认 |
| --- | --- | --- | --- |
| 标签 | 组标签 | 弦/反应. 元素 | \- 说吧 |
| 键 | \- 说吧 | 字符串 | \- 说吧 |
| 价值 | 由此属性默认过滤 。 如果想要您设置密钥, 那么密钥与值相同, 您可以省略值 | 字符串 | \- 说吧 |
| 类Name | 与 `Option props` | 字符串 | '' |
| 标题 | 与 `Option props` | 字符串 | \- 说吧 |

## 发展

```
npm install
npm start
```

## 示例

当地的例子:http://localhost:9001/

在线实例 : [http://select.react-communications.now.sh/ 页面存档备份,存于互联网档案馆](http://select.react-component.now.sh/)

## 测试大小写

```
npm test
```

## 覆盖范围

```
npm run coverage
```

## 许可证

@core-rc/rc-select 根据麻省理工学院的许可发布.

## 常见问题

### @core-rc/rc-select 是什么？

反应选择

### 如何安装 @core-rc/rc-select？

在项目目录运行 npm install @core-rc/rc-select，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react（\>=16\.9\.0）、react-dom（\>=16\.9\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @core-rc/rc-select 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @core-rc/rc-select 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @core-rc/rc-select 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=8\.x。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @core-rc/rc-select 可以商用吗？

@core-rc/rc-select 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @core-rc/rc-select 的下载量有多少？

根据 npm 官方下载统计，@core-rc/rc-select 在 2026/10/11 – 2026/11/09 这 30 天内被下载 4,190 次，日均约 140 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @core-rc/rc-select 还在维护吗？

最新版本 0\.1\.4 发布于 2025/08/14（1\.2 年前）；至今共发布 13 个版本，其中过去 12 个月发布了 0 个；首次发布于 2024/12/04。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。