@haklex/rich-style-token

中文文档
0.66.0发布于 2026/11/15MITTypeScriptES Module零依赖构建来源已验证近 30 天下载 2.4万

Haklex 丰富的编辑器的样式符号和 CSS 变量

中文使用文档
文档目录13 节
  1. 安装
  2. 同伴依赖关系
  3. 使用量
  4. 东道主主题
  5. 出口
  6. 主题 建筑
  7. 上下文提供者
  8. 设计托肯斯
  9. 主题对象
  10. 类型
  11. 子路径导出
  12. 哈克历克的一部分
  13. 许可证

@haklex/ rich- style- token (英语)

Haklex富源编辑器主题系统的设计符,CSS变量和变体预设.

安装

pnpm add @haklex/rich-style-token

同伴依赖关系

软件包版本
react>=19

使用量

import { createThemeStyle, articleTheme, vars } from '@haklex/rich-style-token'
import { PortalThemeProvider } from '@haklex/rich-style-token'

// Generate inline style object from a theme
const style = createThemeStyle(articleTheme)

// Use CSS variables in your styles
// vars.fontSize, vars.lineHeight, vars.fontFamily, etc.

// Provide portal theme context for overlays
<PortalThemeProvider theme="light" variant="article">
  {children}
</PortalThemeProvider>

东道主主题

每个颜色符号和每个字体家庭符号首先通过主机变量解决:

--rc-text: var(--rc-host-text, #171717);
--rc-font-family-sans: var(--rc-host-font-family-sans, -apple-system, …);

主机通过定义重映射编辑器 --rc-host-* 曾经 :root。数值达到内容,可编辑的表面,以及光和暗两种模式的入门铬(菜单、工具提示、工具栏),所以主机拥有自己的光/暗切换:

:root {
  --rc-host-text: var(--color-fg);
  --rc-host-bg: var(--color-surface-card);
  --rc-host-border: var(--color-border);
  --rc-host-accent: var(--color-accent);
}

主机变量名称是符号名称 --rc- 改为 --rc-host- (单位:千美元)--rc-text-secondary → --rc-host-text-secondary) (中文(简体) ). 设置 --rc-* 直接在元素上( 例如 --rc-font-family 仍然为那棵树工作.

出口

主题 建筑

导出说明
createThemeStyle(tokens)从主题符号生成一个 CSS 变量样式对象

上下文提供者

导出说明
PortalContainerProvider提供自定义门户容器元素
usePortalContainer()访问门户容器元素
PortalThemeProvider为门户覆盖提供主题上下文
PortalThemeWrapper应用主题变量的折叠元素
usePortalTheme()访问当前门户网站主题

设计托肯斯

导出说明
articleLayout组合符号 article 变体(sans-serif, 16px)
noteLayout组合符号 note 变体( CJK serif, 16px)
commentLayout组合符号 comment 变体(sans-serif, 14px)
darkColors暗模式的颜色符号
lightArticleColors轻型文章/注解模式的颜色符号
lightCommentColors光评分模式的颜色符号
fonts字体家族定义

主题对象

导出说明
articleTheme联合国 article 变体
noteTheme联合国 note 变体
commentTheme联合国 comment 变体
vars已键入的 CSS 变量引用( 用于 Vanilla 提取样式)

类型

导出说明
ThemeTokens完整的主题符号集形状
PortalTheme门户主题描述符

子路径导出

导入路径说明
@haklex/rich-style-token所有标志、主题、提供者和公用事业
@haklex/rich-style-token/styles香草提取样式定义

哈克历克的一部分

此软件包是 哈克历 丰富的编辑生态系统.

许可证

麻省理工学院

版本与发布记录

@haklex/rich-style-token 共发布 241 个版本,首次发布于 2026/02/20;过去 12 个月发布了 241 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.66.0latest2026/11/151 天前
0.65.72026/11/143 天前
0.65.62026/11/124 天前
0.65.52026/11/124 天前
0.65.42026/11/124 天前
0.65.32026/11/124 天前

关于 @haklex/rich-style-token 的常见问题

@haklex/rich-style-token 是什么?

Haklex 丰富的编辑器的样式符号和 CSS 变量

如何安装 @haklex/rich-style-token?

在项目目录运行 npm install @haklex/rich-style-token,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:react(>=19)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@haklex/rich-style-token 支持 TypeScript 吗?

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

@haklex/rich-style-token 支持 ESM 还是 CommonJS?

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

@haklex/rich-style-token 可以商用吗?

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

@haklex/rich-style-token 的下载量有多少?

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

@haklex/rich-style-token 还在维护吗?

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