@aurodesignsystem/design-tokens

中文文档
9.4.3发布于 2026/11/07Apache-2.0ES Module零依赖构建来源已验证近 30 天下载 8.5万

阿拉斯加航空 Air Auro 设计系统标识库

中文使用文档
文档目录17 节
  1. 概览
  2. 安装
  3. 快速启动
  4. CSS 自定义属性
  5. 与萨斯
  6. Java 脚本使用法
  7. 可用主题
  8. 应用主题
  9. 嵌入式主题
  10. 部分主题覆盖( 只有颜色或类型)
  11. 纯色覆盖
  12. 仅限字法的覆盖
  13. 合并部分覆盖
  14. 文档
  15. 软件包结构
  16. 捐款
  17. 许可证

奥罗设计托肯斯

Build Status See it on NPM! License

概览

奥罗设计 Tokens是Auro设计系统的基础,为不同平台和执行提供了一致的设计价值. 这些标志为阿拉斯加航空公司和夏威夷航空公司品牌定义了颜色,打字,间隔等视觉属性.

安装

npm install @aurodesignsystem/design-tokens

快速启动

CSS 自定义属性

对于大多数网络应用程序,建议使用 CSS 自定义属性:

// In a React or similar application
import "@aurodesignsystem/design-tokens/dist/themes/alaska/CSSCustomProperties--alaska.css"
<!-- In an HTML file -->
<link rel="stylesheet" href="node_modules/@aurodesignsystem/design-tokens/dist/themes/alaska/CSSCustomProperties--alaska.css">

与萨斯

在与萨斯合作时:

@import "~@aurodesignsystem/design-tokens/dist/themes/alaska/primitives--alaska.scss";

Java 脚本使用法

import { AuroColorAlertNotificationOnLight } from '@aurodesignsystem/design-tokens/dist/legacy/auro-classic/JSVariables--color.js';

可用主题

奥罗设计 Tokens 支持多个主题:

主题说明使用量
阿拉斯加语Name目前阿拉斯加航空主题阿拉斯加航空公司品牌接口
阿拉斯加经典带有 Auro 经典值但最新符号名的过渡主题仅针对移徙情况
阿摩斯语Name当前 Atmos 主题Atmos 品牌接口
夏威夷语夏威夷航空主题夏威夷航空公司品牌接口
奥罗经典遗产主题(被贬)仅用于后向兼容

应用主题

使用 data-aag-theme 属性。 所有的孩子元素都会继承主题的设计符号.

<html data-aag-theme="aag-theme-as">
  <!-- All content uses Alaska theme tokens -->
</html>

可用的主题代码 :

主题属性值
阿拉斯加语Nameaag-theme-as
阿拉斯加经典aag-theme-asc
夏威夷语aag-theme-ha
阿摩斯语Nameaag-theme-atm

嵌入式主题

通过应用不同的主题可以嵌入主题 data-aag-theme 值到儿童元素。 子及其后人会使用被巢被子的主题的符号,而其余页面保留了母主题.

<html data-aag-theme="aag-theme-as">
  <!-- Alaska theme -->
  <header>...</header>

  <section data-aag-theme="aag-theme-ha">
    <!-- Hawaiian theme within this section only -->
    <p>This content uses Hawaiian tokens.</p>
  </section>

  <!-- Back to Alaska theme -->
  <footer>...</footer>
</html>

部分主题覆盖( 只有颜色或类型)

主题被分割成 颜色 财务报告和审定财务报表 打印 象征团体。 您可以应用一个主题的一个方面而不通过附加来影响另一个方面 -color 或者说 -type 到属性值.

纯色覆盖

在保留父主题打字时应用主题的颜色符号 :

<html data-aag-theme="aag-theme-as">
  <!-- Alaska color + Alaska typography -->

  <section data-aag-theme="aag-theme-ha-color">
    <!-- Hawaiian colors, but still Alaska typography -->
    <p>Hawaiian color palette with Alaska fonts.</p>
  </section>
</html>

仅限字法的覆盖

在保留父主题颜色的同时应用主题的打字符 :

<html data-aag-theme="aag-theme-as">
  <!-- Alaska color + Alaska typography -->

  <section data-aag-theme="aag-theme-ha-type">
    <!-- Hawaiian typography, but still Alaska colors -->
    <p>Hawaiian fonts with Alaska color palette.</p>
  </section>
</html>

合并部分覆盖

您可以将部分选择器堆放在同一元素上, 从一个主题混合颜色, 从另一个主题混合打印 :

<html data-aag-theme="aag-theme-as">
  <section data-aag-theme="aag-theme-ha-color">
    <div data-aag-theme="aag-theme-atm-type">
      <!-- Hawaiian colors + Atmos typography -->
    </div>
  </section>
</html>

文档

关于综合文件,请见我们:

软件包结构

Npm 软件包在 ./dist/ 按主题排列的目录.

捐款

请读我们的 提供指南 详细介绍我们的行为守则和提交拉动请求的程序.

许可证

该项目根据Apache 2.0许可证颁发许可——见 自由主义 详细文件.

版本与发布记录

@aurodesignsystem/design-tokens 共发布 108 个版本,首次发布于 2023/09/14;过去 12 个月发布了 36 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
9.4.3latest2026/11/07今天
9.4.22026/11/061 天前
9.4.12026/09/221 个月前
9.4.02026/09/221 个月前
9.3.32026/08/142 个月前
9.3.22026/07/283 个月前

关于 @aurodesignsystem/design-tokens 的常见问题

@aurodesignsystem/design-tokens 是什么?

阿拉斯加航空 Air Auro 设计系统标识库

如何安装 @aurodesignsystem/design-tokens?

在项目目录运行 npm install @aurodesignsystem/design-tokens,或使用 pnpm add / yarn add / bun add。

@aurodesignsystem/design-tokens 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/aurodesignsystem__design-tokens 是否存在。

@aurodesignsystem/design-tokens 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@aurodesignsystem/design-tokens 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js ^22.14.0 || >= 24.10.0。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@aurodesignsystem/design-tokens 可以商用吗?

@aurodesignsystem/design-tokens 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@aurodesignsystem/design-tokens 的下载量有多少?

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

@aurodesignsystem/design-tokens 还在维护吗?

最新版本 9.4.3 发布于 2026/11/07(今天);至今共发布 108 个版本,其中过去 12 个月发布了 36 个;首次发布于 2023/09/14。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。