@ember-eui/core

中文文档
16.1.4发布于 2026/10/28MITTypeScriptCommonJS近 30 天下载 6409

弹性UI的嵌入组件

中文使用文档
文档目录6 节
  1. 图标
  2. 兼容性
  3. 安装
  4. 捐款
  5. 公关真的很受欢迎
  6. 许可证

@ember-eui/ 核心

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

图标

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

<EuiIcon @type="chevronSingleDown" />

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

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 你的应用程序 vite.config.mjs (单位:千美元)svgJar({ target: 'ember' })如此 svg 文件 可作为组件导入。 然后直接通过组件:

import MyLogo from '../icons/my-logo.svg';
<EuiIcon @type={{MyLogo}} />
<EuiBadge @iconType={{MyLogo}}>New</EuiBadge>

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

// 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 })
      ),
    });
  }
}
<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

捐款

见 捐款 详细指南.

公关真的很受欢迎

许可证

本项目根据以下规定获得许可证: MIT 许可证,但 来源于 弹性UI (EUI) (数量) 组件样式、图标、端口组件逻辑和文档示例), 根据《弹性许可证》2.0或 服务器侧公共许可证,v 1. 见 备注。 。 。 .

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

版本与发布记录

@ember-eui/core 共发布 393 个版本,首次发布于 2021/03/05;过去 12 个月发布了 28 个版本。

版本发布日期距今
16.1.4latest2026/10/2816 天前
16.1.32026/10/2816 天前
16.2.02026/10/2816 天前
16.1.22026/10/2420 天前
16.1.12026/10/2420 天前
16.1.02026/10/2123 天前

其他发布通道:1.6.5 → 1.6.5,1.6.7 → 1.6.7,2.0.1 → 2.0.1,3.1.1 → 3.1.2,1.6.8 → 1.6.8,1.6.9 → 1.6.9。

关于 @ember-eui/core 的常见问题

@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 和提交记录判断。