# @ebay/ui-core-react 中文文档

规范地址：https://npmcn.com/package/%40ebay/ui-core-react/

版本：9\.17\.1
npm 元数据更新时间：2026-10-30T20:55:58.660Z
中文译文更新时间：2026-11-13T04:29:39.980Z
软件包许可：ISC

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

原始 npm 页面：https://www.npmjs.com/package/%40ebay/ui-core-react
原文对照：https://npmcn.com/package/%40ebay/ui-core-react/?lang=original
项目主页：https://github.com/eBay/evo-web#readme
源码仓库：https://github.com/eBay/evo-web

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

- 包体积（解压后）：10.4 MB，4499 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- 运行依赖：12 个
- peer 依赖：react ^19，react-dom ^19，@ebay/skin ^19
- 首次发布：2022-07-22T21:24:03.473Z
- 最新版本发布：2026-10-30T20:55:58.312Z
- 近 30 天下载量：21071（2026-10-13 至 2026-11-11，npm 官方下载统计）
- 已发布版本数：255（近 12 个月 38 个）

## 中文简介

皮肤组件从 React 创建

## 安装

```sh
npm install @ebay/ui-core-react
```

也可以使用：`pnpm add @ebay/ui-core-react`、`yarn add @ebay/ui-core-react`、`bun add @ebay/ui-core-react`

## README

# ebayui 核心反应

eBayUI 反应组件

[演示](https://opensource.ebay.com/ebayui-core-react/main)

### 所需资源

-   [节点.js](https://nodejs.org/en/) (v20+) (中文(简体) )
-   [反应](https://reactjs.org/) (v18+,v16.8+为维护模式)
-   [eBay 皮肤](https://ebay.github.io/skin/) (v18+) (中文(简体) )

### eBayUI 组件

-   [ ] `ebay-3d-viewer`
-   [x] [ebay-accordion (英语)](https://npmcn.com/package/%40ebay/ui-core-react/src/ebay-accordion)
-   [x] [ebay- alert- 对话框](https://npmcn.com/package/%40ebay/ui-core-react/src/ebay-alert-dialog)
-   [ ] `ebay-area-chart`
-   [x] [`ebay-avatar`](https://npmcn.com/package/%40ebay/ui-core-react/src/ebay-avatar)
-   [x] [ebay- badge (英语)](https://npmcn.com/package/%40ebay/ui-core-react/src/ebay-badge)
-   [ ] `ebay-bar-chart`
-   [x] [ebay-面包屑](https://npmcn.com/package/%40ebay/ui-core-react/src/ebay-breadcrumbs)
-   [x] [ebay 按钮](https://npmcn.com/package/%40ebay/ui-core-react/src/ebay-button)
-   [x] [ebay 日历](https://npmcn.com/package/%40ebay/ui-core-react/src/ebay-calendar)
-   [x] [木卫一](https://npmcn.com/package/%40ebay/ui-core-react/src/ebay-carousel)
-   [x] [ebay ccd (英语)](https://npmcn.com/package/%40ebay/ui-core-react/src/ebay-ccd)
-   [ ] `ebay-character-count`
-   [ ] `ebay-chart-legend`
-   [x] [ebay 检查框](https://npmcn.com/package/%40ebay/ui-core-react/src/ebay-checkbox)
-   [x] [电子芯片](https://npmcn.com/package/%40ebay/ui-core-react/src/ebay-chip)
-   [x] [ebay-chips- 组合框](https://npmcn.com/package/%40ebay/ui-core-react/src/ebay-chips-combobox)
-   [x] [ebay-相框](https://npmcn.com/package/%40ebay/ui-core-react/src/ebay-combobox)
-   [x] [ebay-确认对话框](https://npmcn.com/package/%40ebay/ui-core-react/src/ebay-confirm-dialog)
-   [x] [ebay- cta- 按钮](https://npmcn.com/package/%40ebay/ui-core-react/src/ebay-cta-button)
-   [x] [ebay 日期文本框](https://npmcn.com/package/%40ebay/ui-core-react/src/ebay-date-textbox)
-   [x] [ebay 细节](https://npmcn.com/package/%40ebay/ui-core-react/src/ebay-details)
-   [ ] `ebay-donut-chart`
-   [x] [ebay-教育通知](https://npmcn.com/package/%40ebay/ui-core-react/src/ebay-education-notice)
-   [x] [ebay -eek (英语)](https://npmcn.com/package/%40ebay/ui-core-react/src/ebay-eek)
-   [x] [ebay-假链接](https://npmcn.com/package/%40ebay/ui-core-react/src/ebay-fake-link)
-   [x] [ebay 假菜单](https://npmcn.com/package/%40ebay/ui-core-react/src/ebay-fake-menu)
-   [x] [ebay- fake- 菜单按钮](https://npmcn.com/package/%40ebay/ui-core-react/src/ebay-fake-menu-button)
-   [x] [ebay - 假塔布](https://npmcn.com/package/%40ebay/ui-core-react/src/ebay-fake-tabs)
-   [x] [电子战地](https://npmcn.com/package/%40ebay/ui-core-react/src/ebay-field)
-   [x] [ebay 文件输入](https://npmcn.com/package/%40ebay/ui-core-react/src/ebay-file-input)
-   [x] [ebay 文件预览卡](https://npmcn.com/package/%40ebay/ui-core-react/src/ebay-file-preview-card)
-   [x] [ebay 文件预览卡组](https://npmcn.com/package/%40ebay/ui-core-react/src/ebay-file-preview-card-group)
-   [x] [过滤器](https://npmcn.com/package/%40ebay/ui-core-react/src/ebay-filter)
-   [x] [电子电影过滤菜单](https://npmcn.com/package/%40ebay/ui-core-react/src/ebay-filter-menu)
-   [x] [ebay- filter- 菜单按钮](https://npmcn.com/package/%40ebay/ui-core-react/src/ebay-filter-menu-button)
-   [ ] `ebay-flag`
-   [x] [ebay-icon 按钮](https://npmcn.com/package/%40ebay/ui-core-react/src/ebay-icon-button)
-   [x] [ebay- icon (英语)](https://npmcn.com/package/%40ebay/ui-core-react/src/ebay-icon)
-   [x] [ebay-图像占位符](https://npmcn.com/package/%40ebay/ui-core-react/src/ebay-image-placeholder)
-   [x] [ebay-信息提示](https://npmcn.com/package/%40ebay/ui-core-react/src/ebay-infotip)
-   [x] [ebay-inline 通知](https://npmcn.com/package/%40ebay/ui-core-react/src/ebay-inline-notice)
-   [x] [ebay 项片](https://npmcn.com/package/%40ebay/ui-core-react/src/ebay-item-tile)
-   [x] [ebay 项-平板组](https://npmcn.com/package/%40ebay/ui-core-react/src/ebay-item-tile-group)
-   [x] [ebay- lightbox- 对话框](https://npmcn.com/package/%40ebay/ui-core-react/src/ebay-lightbox-dialog)
-   [ ] `ebay-line-chart`
-   [x] [ebay 列表](https://npmcn.com/package/%40ebay/ui-core-react/src/ebay-list)
-   [x] [ebay 列表框按钮](https://npmcn.com/package/%40ebay/ui-core-react/src/ebay-listbox-button)
-   [x] [ebay 列表框](https://npmcn.com/package/%40ebay/ui-core-react/src/ebay-listbox)
-   [x] [电子菜单](https://npmcn.com/package/%40ebay/ui-core-react/src/ebay-menu)
-   [x] [电子菜单按钮](https://npmcn.com/package/%40ebay/ui-core-react/src/ebay-menu-button)
-   [x] [ebay 页面通知](https://npmcn.com/package/%40ebay/ui-core-react/src/ebay-page-notice)
-   [x] [ebay-pagination (英语)](https://npmcn.com/package/%40ebay/ui-core-react/src/ebay-pagination)
-   [x] [ebay-panel-对话框](https://npmcn.com/package/%40ebay/ui-core-react/src/ebay-panel-dialog)
-   [ ] `ebay-phone-input`
-   [x] [ebay 进度栏](https://npmcn.com/package/%40ebay/ui-core-react/src/ebay-progress-bar)
-   [x] [`ebay-progress-bar-expressive`](https://npmcn.com/package/%40ebay/ui-core-react/src/ebay-progress-bar-expressive)
-   [x] [ebay - 进步平分器](https://npmcn.com/package/%40ebay/ui-core-react/src/ebay-progress-spinner)
-   [x] [ebay - 进度步进器](https://npmcn.com/package/%40ebay/ui-core-react/src/ebay-progress-stepper)
-   [x] [电子广播](https://npmcn.com/package/%40ebay/ui-core-react/src/ebay-radio)
-   [x] [ebay 部分标题](https://npmcn.com/package/%40ebay/ui-core-react/src/ebay-section-title)
-   [x] [ebay 分区通知](https://npmcn.com/package/%40ebay/ui-core-react/src/ebay-section-notice)
-   [x] [ebay 组合按钮](https://npmcn.com/package/%40ebay/ui-core-react/src/ebay-segmented-buttons)
-   [x] [ebay 选择](https://npmcn.com/package/%40ebay/ui-core-react/src/ebay-select)
-   [x] [电子信号](https://npmcn.com/package/%40ebay/ui-core-react/src/ebay-signal)
-   [x] [埃巴伊-斯凯莱通](https://npmcn.com/package/%40ebay/ui-core-react/src/ebay-skeleton)
-   [x] [ebay-snackbar 对话框](https://npmcn.com/package/%40ebay/ui-core-react/src/ebay-snackbar-dialog)
-   [ ] `ebay-spark-line`
-   [x] [ebay- split- 按钮](https://npmcn.com/package/%40ebay/ui-core-react/src/ebay-split-button)
-   [x] [ebay- star- 评分](https://npmcn.com/package/%40ebay/ui-core-react/src/ebay-star-rating)
-   [x] [ebay-星级评选](https://npmcn.com/package/%40ebay/ui-core-react/src/ebay-star-rating-select)
-   [x] [ebay 开关](https://npmcn.com/package/%40ebay/ui-core-react/src/ebay-switch)
-   [x] [电子表格](https://npmcn.com/package/%40ebay/ui-core-react/src/ebay-table)
-   [x] [ebay-tabs (英语)](https://npmcn.com/package/%40ebay/ui-core-react/src/ebay-tabs)
-   [x] [ebay 文本框](https://npmcn.com/package/%40ebay/ui-core-react/src/ebay-textbox)
-   [x] [ebay-toast - 对话框](https://npmcn.com/package/%40ebay/ui-core-react/src/ebay-toast-dialog)
-   [x] [ebay-toggle- 按钮](https://npmcn.com/package/%40ebay/ui-core-react/src/ebay-toast-dialog)
-   [x] [ebay-toggle- 按钮组](https://npmcn.com/package/%40ebay/ui-core-react/src/ebay-toast-dialog)
-   [x] [ebay 工具提示](https://npmcn.com/package/%40ebay/ui-core-react/src/ebay-tooltip)
-   [x] [ebay-tourtip (英语)](https://npmcn.com/package/%40ebay/ui-core-react/src/ebay-tourtip)
-   [x] [ebay 三态复选框](https://npmcn.com/package/%40ebay/ui-core-react/src/ebay-tri-state-checkbox)
-   [x] [ebay-视频](https://npmcn.com/package/%40ebay/ui-core-react/src/ebay-video)

## 开始

这些反应组件作为 `@ebay/ui-core-react` 打开软件包 [国家预防机制](https://npmjs.org/@ebay/ui-core-react)。 。 。 .

使用 npm 或 线条将包依赖性添加到您的工程中 :

```sh
yarn add @ebay/ui-core-react @ebay/skin
```

```jsx
import { EbayTextbox } from '@ebay/ui-core-react/ebay-textbox'
import { EbayButton } from '@ebay/ui-core-react/ebay-button'

<EbayTextbox placeholder="Enter text here" />
<EbayButton>Submit</EbayButton>
```

### 页:1

如果你将孩子的组件动态化, 不想得到反应 `key` 警告后提供 `key`数字 :

```jsx
<EbayParentComponent>
    {items.map((item, index) => (
        <EbayChildComponent key={index}>{item}</EbayChildComponent>
    ))}
</EbayParentComponent>
```

### 通过属性

HTML属性可以用于任何组件上,它们会被传递到组件最突出的标记上. 最突出的标记通常是根或形式控件,但单个组件如果因特定情况而异会注意.

使用实例:

```jsx
<EbayButton id="my-button" />
```

### 问题

在 github 上创建一个问题

## [捐款](https://npmcn.com/package/%40ebay/ui-core-react/CONTRIBUTING.md)

## 更改日志

`@ebay/ui-core-react`

### 版本 7.x (皮肤 18, 打破图标名称的更改)

### 版本 6.x (皮肤 17, 打破图标名称的更改)

### 版本 5.x (皮肤 16, 打破事件召回的更改)

### 版本 4.x (皮肤 16, 打破图标名称的更改)

### 版本 3.x (皮肤 15, 对话框组件的一些断开更改)

### 2.x版本(皮肤15)

`@ebay/ebayui-core-react` (过时)

### 10.x版本(皮肤14)

### 9.x版本(皮肤13)

`ebayui-core-react` (过时)

### 8.x版本(皮肤 12)

### 6.x版本(皮肤 10)

### 版本 5.x (删除后减少, 更改进口以将捆绑大小最小化)

### 3.x版本(皮肤9,用钩子支持16.8反应)

### 2.x版本(皮肤7,反应16.7)

### 遗产

## 常见问题

### @ebay/ui-core-react 是什么？

皮肤组件从 React 创建

### 如何安装 @ebay/ui-core-react？

在项目目录运行 npm install @ebay/ui-core-react，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react（^19）、react-dom（^19）、@ebay/skin（^19）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @ebay/ui-core-react 支持 TypeScript 吗？

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

### @ebay/ui-core-react 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @ebay/ui-core-react 可以商用吗？

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

### @ebay/ui-core-react 的下载量有多少？

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

### @ebay/ui-core-react 还在维护吗？

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