@hanzo/font

中文文档
1.9.6发布于 2026/10/30SIL OPEN FONT LICENSETypeScriptES Module零依赖近 30 天下载 1.6万

Zen)——"花野"类型家族:sans,单相和像素,并有品牌预设和a个被子.

中文使用文档
文档目录4 节
  1. 安装
  2. 与 Next.js 一起使用
  3. 阿拉伯语
  4. 许可证

Zen, Zen 摩诺 & Zen等

禅是"汉藏"类型家族,由SIL开放字体许可证下. 每一个版权 许可证要求为 LICENSE.txt在二进制船旁边.

禅是桑色色相型相,为可辨和简单而设计. 它是现代的,几何的,基于经典的瑞士打字原理. 其被设计用于体型复制,头条,标志,海报等大型显示尺寸.

禅道道是一相相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相 它被设计用于代码编辑器,图表,终端,以及提供代码的其他文本界面.

Zen Pixel是一个以五个独特的以像素为基础的变体为特色的显示型相克家族,每个变体具有鲜明的视觉风格. 它的设计是为了装饰性地用于头条,标志,以及其它需要像素美学的显示上下文.

安装

pnpm add @hanzo/font

与 Next.js 一起使用

Zen 从 @hanzo/font/sans, (中文(简体) ), ZenMono 可见于 @hanzo/font/mono,而"禅像素"变体从 @hanzo/font/pixel全部为 NextFontWithVariable 实例。 你可以多学一点 读取 next/font 文档。 。 。 .

禅像素变体

Zen Pixel包括五个不同的变体,每个变体分别导出:

导出CSS 变量说明
ZenPixelSquare--font-zen-pixel-square平方像素形状
ZenPixelGrid--font-zen-pixel-grid基于网格的像素图案
ZenPixelCircle--font-zen-pixel-circle圆形像素形状
ZenPixelTriangle--font-zen-pixel-triangle三角像素形状
ZenPixelLine--font-zen-pixel-line基于线的像素图案
import {
  ZenPixelSquare,
  ZenPixelGrid,
  ZenPixelCircle,
  ZenPixelTriangle,
  ZenPixelLine,
} from "@hanzo/font/pixel";

应用路由器

单位 app/layout.js数字 :

import { Zen } from "@hanzo/font/sans";

export default function RootLayout({ children }) {
  return (
    <html lang="en" className={Zen.className}>
      <body>{children}</body>
    </html>
  );
}

页面路由器

单位 pages/_app.js数字 :

import { Zen } from "@hanzo/font/sans";

export default function MyApp({ Component, pageProps }) {
  return (
    <main className={Zen.className}>
      <Component {...pageProps} />
    </main>
  );
}

如果你使用的版本 Next.js 超过15,然后在 next.config.js 或者说 next.config.mjs 添加:

/** @type {import('next').NextConfig} */
const nextConfig = {
  reactStrictMode: true,
+  transpilePackages: ["@hanzo/font"],
};

export default nextConfig;

这样做是为了纠正错误,例如:

  • TypeError: next_font_local__WEBPACK_IMPORTED_MODULE_0___default(...) is not a function
  • SyntaxError: Cannot use import statement outside a module

有尾风CSS

所有禅字型都可以通过CSS变量来使用.

  • Zen数字 : --font-zen-sans
  • ZenMono数字 : --font-zen-mono
  • ZenPixelSquare数字 : --font-zen-pixel-square
  • ZenPixelGrid数字 : --font-zen-pixel-grid
  • ZenPixelCircle数字 : --font-zen-pixel-circle
  • ZenPixelTriangle数字 : --font-zen-pixel-triangle
  • ZenPixelLine数字 : --font-zen-pixel-line

单位 app/layout.js数字 :

import { Zen } from "@hanzo/font/sans";
import { ZenMono } from "@hanzo/font/mono";
import { ZenPixelSquare } from "@hanzo/font/pixel";

export default function RootLayout({ children }) {
  return (
    <html
      lang="en"
      className={`${Zen.variable} ${ZenMono.variable} ${ZenPixelSquare.variable}`}
    >
      <body>{children}</body>
    </html>
  );
}
尾风 CSS V4

然后进入 tailwind.css数字 :

@theme {
  /* rest of your theme config */

  --font-sans: var(--font-zen-sans);
  --font-mono: var(--font-zen-mono);
  --font-pixel-square: var(--font-zen-pixel-square);
  --font-pixel-grid: var(--font-zen-pixel-grid);
  --font-pixel-circle: var(--font-zen-pixel-circle);
  --font-pixel-triangle: var(--font-zen-pixel-triangle);
  --font-pixel-line: var(--font-zen-pixel-line);

  /* rest of your theme config */
}
尾风 CSS V3

然后进入 tailwind.config.js数字 :

module.exports = {
  theme: {
    extend: {
      fontFamily: {
        sans: ["var(--font-zen-sans)"],
        mono: ["var(--font-zen-mono)"],
        "pixel-square": ["var(--font-zen-pixel-square)"],
        "pixel-grid": ["var(--font-zen-pixel-grid)"],
        "pixel-circle": ["var(--font-zen-pixel-circle)"],
        "pixel-triangle": ["var(--font-zen-pixel-triangle)"],
        "pixel-line": ["var(--font-zen-pixel-line)"],
      },
    },
  },
};

阿拉伯语

禅画出拉丁语和西里尔语,没有阿拉伯语. @hanzo/font/css 携带3个阿拉伯文 以阿拉伯文盟誓 unicode-range (U+0600-06FF,U+0750-077F, U+FB50–FDFF, U+FE70–FEFC),所以一个没有阿拉伯语的页面从不要求一个:

家属文件宽度2
Noto Kufi Arabicfonts/arabic/NotoKufiArabic-Variable.woff2时,100-900小时94.7克朗
Noto Sans Arabicfonts/arabic/NotoSansArabic-Variable.woff2时,100-900小时132.5 KB (韩语)
IBM Plex Sans Arabicfonts/arabic/IBMPlexSansArabic-<Weight>.woff2,100-700页70-75 KB a重量

默认( E)Noto Kufi Arabic,还有 var(--font-zen-arabic)) 将按 Zen 财务报告和审定财务报表 Zen Mono 也一样 font-family: Zen 设置阿拉伯语,没有其他更改。 改为: 在另一伙人中安放阿拉伯语,并说出在禅宗之前的名字: font-family: 'IBM Plex Sans Arabic', Zen, sans-serif。 。 。 .

每个同伴都画阿拉伯文字的每封信 汉佐船写 (阿拉伯语、波斯语、达里语、乌尔都语、普什图语、信德语、索拉尼库尔德语、维吾尔语、沙赫穆希语) 旁遮普语; scripts/arabic.py 拒绝一张没有的脸。 开罗,Redex Pro和 Rubik被测量了,没有出现在这里:每个字母都遗漏了普什图语、信德语、库尔德语或 维吾尔文.

诺托相被切为阿拉伯块,可变于禅重轴上. IBM 棱镜 Sans 阿拉伯语是 IBM 自己的woff2, 每克一个文件, 字节表示字节: OFL 储备 名称“Plex”,一个子集是一个可能不携带的被修改的版本。 默认 是一个超过100-900的单个可变文件,因为单个家族组合中的面孔 当每个描述器,但范围是相等的, 所以Plex是用自己的名字提供的 只有这个 这些都不是我们的:每个都保留自己的名字和通知在SIL Open字体下 许可证( E)fonts/arabic/OFL.txt 对于野藤, fonts/arabic/OFL-Plex.txt 用于Plex),以及 scripts/arabic.py 由承诺和验收来重建它们 这个 下个/font绑定只携带禅.

许可证

Zen字体家族自由并开源 SIL 打开字体许可证。 。 。 . 阿拉伯的同伴是野藤项目的(dist/fonts/arabic/OFL.txt)和IBM'(英语:dist/fonts/arabic/OFL-Plex.txt),持同一张许可证.

版本与发布记录

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

版本发布日期距今
1.9.6latest2026/10/3018 天前
1.9.52026/10/2325 天前
1.9.42026/10/2325 天前
1.9.32026/08/292 个月前
1.9.22026/08/292 个月前
1.9.12026/08/282 个月前

关于 @hanzo/font 的常见问题

@hanzo/font 是什么?

Zen)——"花野"类型家族:sans,单相和像素,并有品牌预设和a个被子.

如何安装 @hanzo/font?

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

@hanzo/font 支持 TypeScript 吗?

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

@hanzo/font 支持 ESM 还是 CommonJS?

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

@hanzo/font 可以商用吗?

@hanzo/font 使用 SIL OPEN FONT LICENSE 许可。声明的许可为 SIL OPEN FONT LICENSE,请阅读许可原文确认使用条件。以上为概括,不构成法律意见,请以许可原文为准。

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

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

@hanzo/font 还在维护吗?

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