# @easepick/core 中文文档

规范地址：https://npmcn.com/package/%40easepick/core/

版本：1\.2\.1
npm 元数据更新时间：2023-02-22T18:20:40.544Z
中文译文更新时间：2026-11-13T03:39:03.930Z
软件包许可：GPL-2\.0-or-later

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

原始 npm 页面：https://www.npmjs.com/package/%40easepick/core
原文对照：https://npmcn.com/package/%40easepick/core/?lang=original
项目主页：https://easepick.com/
源码仓库：https://github.com/easepick/easepick

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

- 包体积（解压后）：48.6 kB，11 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：1 个
- 首次发布：2022-01-24T10:42:31.534Z
- 最新版本发布：2023-02-22T18:20:40.409Z
- 近 30 天下载量：70976（2026-10-13 至 2026-11-11，npm 官方下载统计）
- 已发布版本数：22（近 12 个月 0 个）

## 中文简介

调味品的核心.

## 安装

```sh
npm install @easepick/core
```

也可以使用：`pnpm add @easepick/core`、`yarn add @easepick/core`、`bun add @easepick/core`

## README

# @ access/ core (帮助)

[![npm version](https://badge.fury.io/js/@easepick%2Fcore.svg)](https://www.npmjs.com/package/@easepick/core)

> 如果您正在使用此软件包, 此软件包不需要安装 [@ access/ bundle](https://easepick.com/packages/bundle)。 。 。 .

主包的调味品.

## 文档

[https://eserpick.com/packages/core (中文(简体) )](https://easepick.com/packages/core)

## 选项

| 名称 | 类型 | 默认 | 说明 |
| --- | --- | :-: | --- |
| 元素 | HTML 元素  
字符串 | 无效 | 将取枣者绑入元素。 也可以绑定任何元素(不是输入),例如,需要内置日历. |
| 医生 | 文档  
阴影旋转 | 文档 | 如果需要通过ShadowRoot,则可能需要. |
| 密码 | 字符串  
数组  
函数 | \[ | 传出CSS文件给拾取者. 不要混合类型, 如果您正在使用 Css 链接, 那么数组应该只包含链接 . |
| 第一天 | 编号 | 1个 | 开行周日. (0 - 星期日, 1 - 星期一, 2 - 星期二等. ) |
| 朗语 | 字符串 | 页:1 美国 | 语言.  
此选项会影响日名, 月名通过 [日期. prototype.to localeString () (中文(简体) )](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/toLocaleString) 并影响通过 [内通. 多元规则](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/PluralRules)。 。 。 . |
| 日期 | 日期  
字符串  
编号 | 无效 | 预选日期.  
日期对象或Unix时间戳(有毫秒)或字符串(必须等于选项格式). |
| 格式 | 字符串 | YYY-MM-DD (英语) | 默认输出格式 .  
见 [符号格式](https://easepick.com/packages/datetime#tokens-format)。 。 。 . |
| 网格 | 编号 | 1个 | 日历列数. |
| 日历 | 编号 | 1个 | 可见月数. |
| 只读 | 布尔 | 真实 | 添加 `readonly` 属性为 `element`。 。 。 . |
| 自动向上 | 布尔 | 真实 | 隐藏应用程序并取消按钮,一旦点击了两个日期,就自动应用新的日期范围. |
| zindex 数据 | 编号 | 无效 | zindex的拾取者. |
| 内入 | 布尔 | 虚假 | 显示日历内行 . |
| 滚动到日期 | 布尔 | 真实 | 滚动到打开时选定的日期 . |
| 标题 | 布尔  
字符串  
HTML 元素 | 虚假 | 在日历中添加页眉 . |
| 语言 | 对象 | {  
下个月: '',  
前个月:\`',  
取消: “取消” ,  
应用 : “ pply ”  
{\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢 | 图标和文本用于按钮. |
| 文档点击 | 布尔  
函数 | 函数 | 点击外部拾取元素时隐藏拾取器 . |
| 设置 | 函数 | 无效 |  |
| 插件 | 数组 | \[ | 插件列表 . |

## 方法

| 名称 | 说明 |
| --- | --- |
| 版本 | 返回选择器的版本. |
| 显示( S) | 确定采取器是否可见 . |
| 显示 () | 显取取者. |
| 隐藏( c) | 藏取来者. |
| 清除( c) | 清除拾取者选择. |
| gotoDate( 日期) | 改变可见月. |
| 日期( 日期) | 确定日期. |
| 获取日期( C) | 获取选中的日期 . |
| 打开(类型、听众、选项) | 在容器元素中添加收听器 . |
| 关闭( 类型、 听取者、 选项) | 从容器元素中删除收听器 . |
| 触发( 类型, 细节) | 安排一个活动. |
| 折叠全部( ) | 重新绘制日历布局 . |
| 销毁() | 毁取者. |

#### 示例

```js
const picker = new easepick.create({
  element: document.getElementById('datepicker'),
  css: [
    'https://cdn.jsdelivr.net/npm/@easepick/core@[version.number]/dist/index.css',
  ],
});
// 
picker.setDate('2022-01-01');
```

## 活动

活动依据 [自定义事件 ()](https://developer.mozilla.org/en-US/docs/Web/API/CustomEvent/CustomEvent)。 。 。 .

| 名称 | 说明 |
| --- | --- |
| 提交 |  |
| 视图 |  |
| 预选 | 活动在选定的日期(提交选择之前)进行。 何时 `autoApply` 选项 `false`。 。 。 . |
| 选择 | 提交选题时,将召集活动. |

它还被允许使用默认事件,例如 `click`, (中文(简体) ), `keydown`等 (中文(简体) ).

#### 示例

```js
const picker = new easepick.create({
  element: document.getElementById('datepicker'),
  css: [
    'https://cdn.jsdelivr.net/npm/@easepick/core@[version.number]/dist/index.css',
  ],
  setup(picker) {
    picker.on('view', (e) => {
      const { view, date, target } = e.detail;
      // do something
    });
  },
});
```

## 插件管理器

`PluginManager` 允许您管理创建的拾取器插件.

#### 方法

| 名称 | 说明 |
| --- | --- |
| [获取Instance( 插件Name](https://npmcn.com/package/%40easepick/core/#readme-pluginManager-getInstance) | 返回插件实例 . `pluginName` 是字符串( 如: `RangePlugin`) (中文(简体) ). |
| [添加Instance( 插件Name](https://npmcn.com/package/%40easepick/core/#readme-pluginManager-addInstance) | 向拾取器添加插件。 返回添加的插件实例 . |
| [删除Instance( 插件Name](https://npmcn.com/package/%40easepick/core/#readme-pluginManager-removeInstance) | 从拾取器中删除插件。 返回布尔结果 . |
| [重新装入Instance( 插件Name](https://npmcn.com/package/%40easepick/core/#readme-pluginManager-reloadInstance) | 从拾取器中删除插件,然后再次添加。 返回添加的插件实例 . |

#### 示例

```js
// example use bundle version
const picker = new easepick.create({
  element: document.getElementById('datepicker'),
  css: [
    'https://cdn.jsdelivr.net/npm/@easepick/core@[version.number]/dist/index.css',
  ],
});

// add AmpPlugin to the picker
const ampPlugin = picker.PluginManager.addInstance('AmpPlugin');
// change plugin option
ampPlugin.options.resetButton = true;
```

## 常见问题

### @easepick/core 是什么？

调味品的核心\.

### 如何安装 @easepick/core？

在项目目录运行 npm install @easepick/core，或使用 pnpm add / yarn add / bun add。

### @easepick/core 支持 TypeScript 吗？

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

### @easepick/core 支持 ESM 还是 CommonJS？

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

### @easepick/core 可以商用吗？

@easepick/core 使用 GPL-2\.0-or-later 许可。强 Copyleft：分发包含该代码的软件时，整个作品需以兼容的 GPL 许可开源。仅在内部使用、不对外分发时不触发此义务。以上为概括，不构成法律意见，请以许可原文为准。

### @easepick/core 的下载量有多少？

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

### @easepick/core 还在维护吗？

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