@hanzo/appearance

中文文档
0.2.15发布于 2026/11/13MITTypeScriptESM + CJS近 30 天下载 1.9万

一个人自己对汉藏设计系统的阅读——主题,类型大小,密度,角,口音——存储,应用和可调整.

中文使用文档
文档目录4 节
  1. Knobs, 不是主题
  2. 第一幅画
  3. 选择的地方
  4. 那个作曲家

@hanzo/出现

一个外观面板:主题,文本大小,尺度,密度,面相,阿拉伯面相, 宽度,角和口音,每人存储并应用于整个产品.

import { Appearance } from '@hanzo/appearance'

<Appearance />

将启动脚本添加到 <head> 所以,第一张画已经正确,没有 当JS运行时

import { bootScript } from '@hanzo/appearance/state'

<script dangerouslySetInnerHTML={{ __html: bootScript() }} />

<Hanzo> 从 @hanzo/ui 将个人的选择应用在挂载上,手将 主题。 一个挂起自己的 Gui 提供者的电话的主机 useAppearance() 一次在它的根并经过 useScheme() 作为 defaultTheme。 。 。 .

Knobs, 不是主题

@hanzo/design 发表 --type-scale, (中文(简体) ), --type-ratio, (中文(简体) ), --density, (中文(简体) ), --radius-scale, (中文(简体) ), --font-sans, (中文(简体) ), --font-arabic 编辑 --primary 编号 : --accent 和每个坡道 tokens/*.css 读取它们。 偏好设置几个数字和一个颜色 而不是重复一个比例表,所以后面添加的rung是免费覆盖的.

阿拉伯语是自己的轴线(arabic数字 : kufi, (中文(简体) ), sans 或者说 plex因作禅画无阿拉伯语. 写着 --font-arabic,该设计是 sans, 单和 serif 堆叠所有名称 首先,它所命名的同伴 将每个阿拉伯字母置于任何面孔之下 拉丁语从不碰它.

口音是家庭:填充物,其上读取的墨水(设计为黑色或 白色的,以更相左者为准)和加深它的悬浮,都来源于 一个颜色由 vars()主题是一个类, light 编号 : t_light 或者说 dark 编号 : t_dark,彩绘在 <html> 在两个词汇.

第一幅画

apply() 保持它画在下面 hanzo.appearance.painted,以及 bootScript() 在任何捆绑运行前 完全重放 这算不上什么, 所以它不会落后 vars()。 。 。 . bootScript({ base }) 绘制安装 在从未应用过设备上默认.

选择的地方

四层,最狭小的,以轴取胜的评分轴: install < org < person (everywhere) < person (this org)。人物的分层 保存在IAM中(/v1/iam/preferences成员 appearance)并缓存于 设备,所以一个汉藏起源的选择 到达另一个.

那个作曲家

一个人的作曲行为是一张唱片,每个作曲家都读过 (单位:千美元)@hanzo/ui/chat是因为 Composer),由面板上最后一行所写:

import { useComposing, writeComposing } from '@hanzo/appearance'

useComposing() // { send?: 'enter' | 'mod', chips?: boolean, model?: boolean, mode?: boolean }
writeComposing({ send: 'mod' }) // ⌘/Ctrl+Enter sends, Enter breaks the line

缺少一个无人设定的轴, 而表面本身的默认保存( Chat 打开) 没有芯片或模式, Dev 和两种模式; 模式选择器关闭直到关闭 (电话) 它保存在装置下面 hanzo.composer中,以 hanzo:composer 并保存在IAM 旁边的外观 composer 成员 /v1/iam/preferences,所以它跨越一个域。 画作 无: 没有文档 knob, 没有头脚本 .

版本与发布记录

@hanzo/appearance 共发布 23 个版本,首次发布于 2026/08/08;过去 12 个月发布了 23 个版本。

版本发布日期距今
0.2.15latest2026/11/134 天前
0.2.142026/11/0710 天前
0.2.132026/10/3018 天前
0.2.122026/10/2621 天前
0.2.112026/10/2325 天前
0.2.102026/10/171 个月前

关于 @hanzo/appearance 的常见问题

@hanzo/appearance 是什么?

一个人自己对汉藏设计系统的阅读——主题,类型大小,密度,角,口音——存储,应用和可调整.

如何安装 @hanzo/appearance?

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

@hanzo/appearance 支持 TypeScript 吗?

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

@hanzo/appearance 支持 ESM 还是 CommonJS?

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

@hanzo/appearance 可以商用吗?

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

@hanzo/appearance 的下载量有多少?

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

@hanzo/appearance 还在维护吗?

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