# @dselmanovic/rc-picker 中文文档

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

版本：1\.0\.0
npm 元数据更新时间：2022-04-05T05:44:40.901Z
中文译文更新时间：2026-11-12T21:51:19.028Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40dselmanovic/rc-picker
原文对照：https://npmcn.com/package/%40dselmanovic/rc-picker/?lang=original
项目主页：https://react-component.github.io/picker
源码仓库：https://github.com/dselmanovic/picker

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

- 包体积（解压后）：626 kB，398 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：未声明
- Node.js 要求：\>=8\.x
- 运行依赖：5 个
- peer 依赖：dayjs ^1\.8\.18，react ^16\.0\.0，react-dom ^16\.0\.0
- 首次发布：2020-05-12T09:35:14.082Z
- 最新版本发布：2020-05-12T09:35:14.360Z
- 近 30 天下载量：4491（2026-10-13 至 2026-11-11，npm 官方下载统计）
- 已发布版本数：1（近 12 个月 0 个）

## 中文简介

反应日期和时间拾取器

## 安装

```sh
npm install @dselmanovic/rc-picker
```

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

## README

# 弧取器

[![NPM version](http://img.shields.io/npm/v/rc-picker.svg?style=flat-square)](http://npmjs.org/package/rc-picker) [![build status](https://img.shields.io/circleci/build/github/react-component/picker/master?style=flat-square)](https://circleci.com/gh/react-component/picker) [![Codecov](https://img.shields.io/codecov/c/github/react-component/picker/master.svg?style=flat-square)](https://codecov.io/gh/react-component/picker/branch/master) [![Dependencies](https://david-dm.org/react-component/picker/status.svg?style=flat-square)](https://david-dm.org/react-component/picker) [![DevDependencies](https://david-dm.org/react-component/picker/dev-status.svg?style=flat-square)](https://david-dm.org/react-component/picker?type=dev) [![npm download](https://img.shields.io/npm/dm/rc-picker.svg?style=flat-square)](https://npmjs.org/package/rc-picker) [![bundle size](https://badgen.net/bundlephobia/minzip/rc-picker)](https://bundlephobia.com/result?p=rc-picker)

## 现场直播

[https://react-community.github.io/ picker/ 页面存档备份,存于互联网档案馆](https://react-component.github.io/picker/)

## 安装

[![rc-picker](https://nodei.co/npm/rc-picker.png)](https://npmjs.org/package/rc-picker)

## 使用量

```js
import Picker from 'rc-picker';
import 'rc-picker/assets/index.css';
import { render } from 'react-dom';

render(<Picker />, mountNode);
```

## API 密码

### 拾取器

| 财产 | 类型 | 默认 | 说明 |
| --- | --- | --- | --- |
| 前缀 Cls | 字符串 | 弧取器 | 此组件的前缀Clus |
| 类Name | 字符串 | '' | 根多姆节点的额外 cs 类 |
| 样式 | 反应 CSS 财产 |  | root dom 节点的额外样式 |
| 降级Name | 字符串 | '' | 适用于下拉的附加类Name |
| 下拉对齐 | 对象: 对齐配置 [点对齐](https://github.com/yiminghe/dom-align) |  | 值将被合并到设置的下拉配置 |
| 弹出样式 | 反应 CSS 财产 |  | 自定义弹出样式 |
| 过渡Name | 字符串 | '' | css 动画类 |
| 语言 | 对象 | 从“ rc- pickers/lib/locale/en US” 导入 | 弧取取器语言 |
| 只读输入 | 布尔 | 虚假 | 设置只读的输入 |
| 允许清除 | 布尔 | 虚假 | 是否显示清晰的按钮 |
| 自动聚焦 | 布尔 | 虚假 | 是否自动聚焦 |
| 显示时间 | 布尔 QQ 对象 | [显示时间选项](https://npmcn.com/package/%40dselmanovic/rc-picker/#readme-showTime-options) | 以提供额外的时间选择 |
| 拾取器 | 时间 时间 日期 一周 月份 年份 |  | 控制显示哪类面板 |
| 格式 | 字符串 QQ 字符串 \[\] | 取决于您是否设置时间选择器和您的语言 | 用于格式/分隔日期(没有时间)值到/从输入。 当提供数组时, 所有值都用于解析和显示的第一个值 |
| 使用12 路由 | 布尔 | 虚假 | 12小时显示模式 |
| 价值 | 瞬间 |  | 输入值等当前值 |
| 默认值 | 瞬间 |  | 默认值像输入的默认值 |
| 打开 | 布尔 | 虚假 | 当前采取器的开放状态。 受控道具 |
| 后缀Icon | 反应节点 |  | 自定义后缀图标 |
| 清关 | 反应节点 |  | 自定义清晰图标 |
| 预置Icon | 反应节点 |  | 自定义预览图标 |
| 下一个Icon | 反应节点 |  | 下一个自定义图标 |
| 超级PrevIcon | 反应节点 |  | 自定义超级预览图标 |
| 超级下一个 | 反应节点 |  | 自定义超级下个图标 |
| 已禁用 | 布尔 | 虚假 | 拾取器是否已禁用 |
| 占位符 | 字符串 |  | picker 输入的占位符 |
| 获取 Popup 容器 | 函数( 触发) |  | 设置浮动层的容器,而默认的是在正文中创建一个 div 元素 |
| 变化 | 函数( 日期: 瞬间, 日期: 字符串) |  | 调用函数,当选定时间发生变化时可以执行 |
| 打开更改 | 函数( 打开: boolean) |  | 打开/ 关闭拾取器时调用 |
| 焦点 | (evnet:React.FocusEventHandler) 虚空 (英语) |  | 如输入在焦点上 |
| 布莱尔 | (evnet:React.FocusEventHandler) 虚空 (英语) |  | 像输入一样模糊 |
| 方向 | 字符串: ltr 或 rtl |  | 拾取器组件的布局方向,它也支持RTL方向. |

### 拾取板

| 财产 | 类型 | 默认 | 说明 |
| --- | --- | --- | --- |
| 前缀 Cls | 字符串 | 弧取器 | 此组件的前缀Clus |
| 类Name | 字符串 | '' | root dom 的额外 cs 类 |
| 样式 | 反应 CSS 财产 |  | root dom 节点的额外样式 |
| 语言 | 对象 | 从“ rc- pickers/lib/locale/en US” 导入 | 弧取取器语言 |
| 价值 | 瞬间 |  | 输入值等当前值 |
| 默认值 | 瞬间 |  | 默认值像输入的默认值 |
| 默认 PickerValue 选项 | 瞬间 |  | 设定默认显示取取取日期 |
| 模式 | 时间 日期 时间 时间 时间 时间 日期 时间 时间 时间 时间 时间 时间 日期 时间 时间 时间 时间 时间 时间 时间 时间 时间 日期 日期 时间 时间 时间 时间 时间 时间 时间 时间 日期 时间 时间 时间 时间 时间 时间 时间 日期 时间 时间 时间 时间 时间 时间 时间 时间 时间 时间 日期 时间 时间 时间 日期 时间 时间 日期 时间 时间 时间 时间 日期 时间 日期 时间 时间 日期 日期 时间 时间 时间 时间 时间 日期 日期 时间 日期 日期 时间 日期 日期 时间 时间 时间 日期 日期 日期 日期 日期 日期 日期 日期 日期 日期 日期 时间 时间 日期 日期 日期 日期 日期 日期 日期 日期 日期 日期 日期 日期 |  | 控制哪类面板 |
| 拾取器 | 时间 时间 日期 一周 月份 年份 |  | 控制哪类面板 |
| 选项卡索引 | 数目 | 0 个 | 视图 [选项卡索引](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/tabindex) |
| 显示时间 | 布尔 QQ 对象 | [显示时间选项](https://npmcn.com/package/%40dselmanovic/rc-picker/#readme-showTime-options) | 以提供额外的时间选择 |
| 今天显示 | 布尔 | 虚假 | 是否显示今天按钮 |
| 禁用日期 | 函数( 日期: 移动) QQ 布尔 |  | 是否禁用当前日期的选择 |
| 日期显示器 | 函数( 当前日期: 移动, 今天: 移动) QQ 反应 节点 |  | 日期单元格自定义渲染函数 |
| 月份计费器 | 函数( 当前 Date: moment, locale: Locale) QQ 反应 节点 |  | 自定义月单元格渲染方法 |
| 制作ExtraFooter | {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢? 反应 节点 |  | 额外页脚 |
| 选择 | 函数( 日期: 瞬间) |  | 调用函数,可以在选定时间执行 |
| 变相小组 | 函数( 值: 瞬间, 模式) |  | 选择面板模式时调用 |
| 移动下 | (evnet:React. MouseEventHandler) 虚空 (英语) |  | 在 MouseDown evnent 上执行时调用 |
| 方向 | 字符串: ltr 或 rtl |  | 拾取器组件的布局方向,它也支持RTL方向. |

### 范围选择器

| 财产 | 类型 | 默认 | 说明 |
| --- | --- | --- | --- |
| 前缀 Cls | 字符串 | 弧取器 | 此组件的前缀Clus |
| 类Name | 字符串 | '' | root dom 的额外 cs 类 |
| 样式 | 反应 CSS 财产 |  | root dom 节点的额外样式 |
| 语言 | 对象 | 从“ rc- pickers/lib/locale/en US” 导入 | 弧取取器语言 |
| 价值 | 瞬间 |  | 输入值等当前值 |
| 默认值 | 瞬间 |  | 默认值像输入的默认值 |
| 默认 PickerValue 选项 | 瞬间 |  | 设定默认显示取取取日期 |
| 分隔符 | 字符串 | '~' (法语) | 在输入之间设置分隔符 |
| 拾取器 | 时间 时间 日期 一周 月份 年份 |  | 控制哪类面板 |
| 占位符 | \[打,打. \] |  | 日期输入的占位符 |
| 显示时间 | 布尔 QQ 对象 | [显示时间选项](https://npmcn.com/package/%40dselmanovic/rc-picker/#readme-showTime-options) | 以提供额外的时间选择 |
| 显示时间。 默认值 | \[一分,一分\] |  | 设置选定日期的默认时间 |
| 使用12 路由 | 布尔 | 虚假 | 12小时显示模式 |
| 禁用时间 | 函数( 日期: 瞬间, 类型 : “ start' QQ' end ”) : 对象 |  |  |
| 范围 | {字符串}{ \[范围:字符串\]:分 {{{{{{{{{{{{{{{}}}{{{{{{{{}}}}}{{时间: |  | 用于快速选择的预设范围 |
| 格式 | 字符串 QQ 字符串 \[\] | 取决于您是否设置时间选择器和您的语言 | 用于格式/分隔日期(没有时间)值到/从输入。 当提供数组时, 所有值都用于解析和显示的第一个值 |
| 允许 | \[宝莲,布尔\] |  | 允许区域拾取器清除文本 |
| 可选择 | \[宝莲,布尔\] |  | 是否为所选的拾取器 |
| 已禁用 | 布尔 | 虚假 | 区域拾取器是否已禁用 |
| 变化 | 函数( 值: \[moment\], 格式化 String: \[字符串, 字符串\]) |  | 调用函数,当选定时间发生变化时可以执行 |
| 在卡伦达尔变化中 | 函数( 值: \[moment\], 格式化 String: \[字符串, 字符串\]) |  | 召回函数,可以在起始时间或结束时间变化时执行 |
| 方向 | 字符串: ltr 或 rtl |  | 拾取器组件的布局方向,它也支持RTL方向. |
| 顺序 | 布尔 | 真实 | (仅限时间选择) `false` 以禁用自动命令 |
| 顺序 | 布尔 | 真实 | (仅限时间选择) `false` 以禁用自动命令 |
| 已禁用 PickerStartDate 选项 | 函数( 启动时间: 瞬间 ): boolean |  | 禁用开始日期 |
| 已禁用 Picker EndDate 数据 | 函数( end Date: moment): 布尔 |  | 禁用结束日期 |

### 显示时间选项

| 财产 | 类型 | 默认 | 说明 |
| --- | --- | --- | --- |
| 格式 | 字符串 |  | 瞬间格式 |
| 显示路径 | 布尔 | 真实 | 是否显示时间 |
| 显示最小值 | 布尔 | 真实 | 是否显示分钟 |
| 显示第二 | 布尔 | 真实 | 是否显示第二个 |
| 使用12 路由 | 布尔 | 虚假 | 12小时显示模式 |
| 小时步骤 | 数目 | 1个 | 拾取器中的小时间隔 |
| 分钟步骤 | 数目 | 1个 | 拾取器的分数间隔 |
| 第二个步骤 | 数目 | 1个 | 拾取器中秒之间的间隔 |
| 隐藏已禁用选项 | 布尔 | 虚假 | 是否隐藏已禁用的选项 |
| 默认值 | 瞬间 | 无效 | 默认初始值 |

## 发展

```
npm install
npm start
```

## 许可证

根据麻省理工学院颁发的许可证,可释放rc-pickers.

## 常见问题

### @dselmanovic/rc-picker 是什么？

反应日期和时间拾取器

### 如何安装 @dselmanovic/rc-picker？

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

### @dselmanovic/rc-picker 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/dselmanovic\_\_rc-picker 是否存在。

### @dselmanovic/rc-picker 支持 ESM 还是 CommonJS？

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

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

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

### @dselmanovic/rc-picker 可以商用吗？

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

### @dselmanovic/rc-picker 的下载量有多少？

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

### @dselmanovic/rc-picker 还在维护吗？

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