# @ember-eui/core 中文文档

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

版本：16\.1\.4
npm 元数据更新时间：2026-10-28T04:54:54.734Z
中文译文更新时间：2026-11-13T15:16:16.357Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40ember-eui/core
原文对照：https://npmcn.com/package/%40ember-eui/core/?lang=original
源码仓库：https://github.com/prysmex/ember-eui

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

- 包体积（解压后）：18.7 MB，8079 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- Node.js 要求：\>= 20\.19\.0
- 运行依赖：39 个
- peer 依赖：moment ^2\.29\.3，ember-source \>= 7\.1\.0，@ember/string ^4\.0\.0，ember-modifier ^4\.1\.0，ember-focus-trap ^1\.1\.0，ember-concurrency ^5\.1\.0，@glimmer/component ^2\.0\.0，ember-power-select ^9\.0\.2，ember-basic-dropdown ^9\.0\.0
- 首次发布：2021-03-04T23:13:28.621Z
- 最新版本发布：2026-10-28T04:54:54.532Z
- 近 30 天下载量：6409（2026-10-14 至 2026-11-12，npm 官方下载统计）
- 已发布版本数：393（近 12 个月 28 个）

## 中文简介

弹性UI的嵌入组件

## 安装

```sh
npm install @ember-eui/core
```

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

## README

# @ember-eui/ 核心

本项目旨在提供执行Css层的嵌入组件 [https://elastic.github.io/eui (英语)](https://elastic.github.io/eui)

### 图标

EUI 图标在框外工作:它们与加通捆绑在一起,没有构建 需要配置( 用于需要 `ember-svg-jar`) (中文(简体) ).

```hbs
<EuiIcon @type="chevronSingleDown" />
```

每个EUI图标都是自己的块,第一次装入,所以应用 只下载他们使用的图标。 直到它来到一个空的图标 大小取而代之; `await render()` 编号 : `settled()` 在测试中等待它. 应立即显示的预装图标 :

```js
import { preloadIcons } from '@ember-eui/core/utils/preload-icons';

export default class ApplicationRoute extends Route {
  async beforeModel() {
    await preloadIcons(['chevronSingleDown', 'cross', 'magnify']);
  }
}
```

要使用自己的图标,请添加 [`@svg-jar/plugin`](https://github.com/svg-jar/plugin) 你的应用程序 `vite.config.mjs` (单位:千美元)`svgJar({ target: 'ember' })`如此 svg 文件 可作为组件导入。 然后直接通过组件:

```js
import MyLogo from '../icons/my-logo.svg';
```

```hbs
<EuiIcon @type={{MyLogo}} />
<EuiBadge @iconType={{MyLogo}}>New</EuiBadge>
```

或按名称注册,例如,一个完整的文件夹同时与 `iconsFromGlob` (icons以文件命名,就像ember-svg-jar所做的):

```js
// app/routes/application.js
import Route from '@ember/routing/route';
import { service } from '@ember/service';
import { iconsFromGlob } from '@ember-eui/core/utils/icons-from-glob';

export default class ApplicationRoute extends Route {
  @service euiConfig;

  beforeModel() {
    this.euiConfig.updateConfig({
      'euiIcon.icons': iconsFromGlob(
        import.meta.glob('../icons/**/*.svg', { eager: true })
      ),
    });
  }
}
```

```hbs
<EuiIcon @type="my-logo" />
<EuiButton @iconType="rocket">Launch</EuiButton>
```

保持这些svgs `public/`: Vite 不想要从中获取文件 从JavaScript导入的公用目录(它在开发中警告). 移动例如:. `public/assets/*.svg` 改为 `app/icons/` 保持相同的名称.

其他字符串作为 `<img>` 用那个URL.

## 兼容性

-   Ember.js v7.1 或以上 (中文(简体) )
-   Ember CLI v7.1 或以上 (单位:千美元)
-   节点.js v20.19或以上

## 安装

```
ember install @ember-eui/core
```

## 捐款

见 [捐款](https://npmcn.com/package/%40ember-eui/core/CONTRIBUTING.md) 详细指南.

### 公关真的很受欢迎

## 许可证

本项目根据以下规定获得许可证: [MIT 许可证](https://npmcn.com/package/%40ember-eui/core/LICENSE.md),但 来源于 [弹性UI (EUI)](https://github.com/elastic/eui) (数量) 组件样式、图标、端口组件逻辑和文档示例), 根据《弹性许可证》2.0或 服务器侧公共许可证,v 1. 见 [备注](https://npmcn.com/package/%40ember-eui/core/NOTICE.md)。 。 。 .

Ember EUI是一个社区项目,不附属于或认可 弹性.

## 常见问题

### @ember-eui/core 是什么？

弹性UI的嵌入组件

### 如何安装 @ember-eui/core？

在项目目录运行 npm install @ember-eui/core，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：moment（^2\.29\.3）、ember-source（\>= 7\.1\.0）、@ember/string（^4\.0\.0）、ember-modifier（^4\.1\.0）、ember-focus-trap（^1\.1\.0）、ember-concurrency（^5\.1\.0）、@glimmer/component（^2\.0\.0）、ember-power-select（^9\.0\.2）、ember-basic-dropdown（^9\.0\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @ember-eui/core 支持 TypeScript 吗？

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

### @ember-eui/core 支持 ESM 还是 CommonJS？

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

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

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

### @ember-eui/core 可以商用吗？

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

### @ember-eui/core 的下载量有多少？

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

### @ember-eui/core 还在维护吗？

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