@ephox/alloy

中文文档
16.0.0发布于 2026/03/31GPL-2.0-or-laterTypeScriptESM + CJS近 30 天下载 1.4万

Ui 框架

中文使用文档
文档目录6 节
  1. 先决条件
  2. 运行测试
  3. 运行控制台测试
  4. 运行浏览器测试
  5. 运行 Webdriver 测试
  6. 合金 APIs

说明

alloy 是一个UI 库,它特别用来创建对 DOM 结构和造型没有印象的可重复使用的行为和组件. 这是一个非常低级的图书馆.

安装

先决条件

运行演示、 npm 和网络包的网络服务器需要运行和开发合金

alloy 可作为 npm 软件包。 您可以通过 npm 软件包安装 @ephox/alloy

yarn 安装依赖关系 webpack 编译 src 代码

使用量

运行测试

alloy 用途 bedrock 进行测试。 如果您正在运行浏览器测试, 您可能需要确保您在路径上有有效的网络驱动器 。 您可以通过 npm 安装许多网络驱动器 .

合金有四种测试:

  • 原子试验
  • 无头试验
  • 浏览器测试
  • 网络司机测试

运行控制台测试

$ yarn run test

这将运行控制台测试 在无铬头.

运行浏览器测试

浏览器测试在 src/test/js/browser 目录。 它们不需要网络司机,可以使用 bedrock 模式(而不是 bedrock-auto) (中文(简体) ).

$ bedrock --testdir src/test/js/browser

在这种模式下,基德不会打开浏览器,也不会关闭. 此模式用于开发和调试.

运行 Webdriver 测试

一些合金测试需要访问原始的 WebDriver API 如 sendKeys。这允许测试使用硒提供实际 真实 关键事件,而不是模拟JavaScript事件. 然而,要进行这些测试,你需要使用 bedrock-auto。这些测试储存在 src/test/js/webdriver 目录.

例如,在Chrome进行测试:

$ bedrock-auto -b chrome --testdir src/test/js/webdriver

说明, webdriver 测试仍然相当脆弱.

合金 APIs

我们目前正在记录合金API。 目前,有许多演示可以使用 src/demo/html 证明如何使用 alloy。请注意,图书馆仍处于不断调整的状态.

版本与发布记录

@ephox/alloy 共发布 286 个版本,首次发布于 2017/09/20;过去 12 个月发布了 1 个版本。

版本发布日期距今
16.0.0latest2026/03/317 个月前
14.0.32024/02/072 年前
14.0.22023/12/122 年前
14.0.12023/11/292 年前
14.0.02023/11/222 年前
14.0.0-alpha.02023/11/103 年前

其他发布通道:legacy → 9.0.4,rc → 13.1.0-alpha.0。

关于 @ephox/alloy 的常见问题

@ephox/alloy 是什么?

Ui 框架

如何安装 @ephox/alloy?

在项目目录运行 npm install @ephox/alloy,或使用 pnpm add / yarn add / bun add。

@ephox/alloy 支持 TypeScript 吗?

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

@ephox/alloy 支持 ESM 还是 CommonJS?

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

@ephox/alloy 可以商用吗?

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

@ephox/alloy 的下载量有多少?

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

@ephox/alloy 还在维护吗?

最新版本 16.0.0 发布于 2026/03/31(7 个月前);至今共发布 286 个版本,其中过去 12 个月发布了 1 个;首次发布于 2017/09/20。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。