跳到正文
English

安装

Hairline 由两个文件组成:一份样式表,一份行为脚本。不需要构建工具,也不依赖任何框架。

拿到文件

两个文件就在这个站点的 assets 文件夹里,直接复制到你的项目中:

文件内容大小
hairline.css全部令牌(颜色、字体、间距、圆角、阴影)和所有组件的样式,含昼夜两套主题109 KB
hairline.js弹窗、菜单、月历等组件的行为。可选:不加载它,组件照样能看34 KB
tokens.json令牌的原始数据,给设计工具或别的平台用20 KB

目前没有发布到 npm,也没有公共的 CDN 地址。请把文件放进自己的项目里引用。

引入

在页面的 <head> 里引入字体和样式表,在 <body> 结尾引入脚本:

<link rel="stylesheet" href="https://fonts.googleapis.com/css2?family=Newsreader:ital,opsz,wght@0,6..72,500;0,6..72,600;1,6..72,400&family=Noto+Serif+SC:wght@600;700;900&display=swap">
<link rel="stylesheet" href="hairline.css">

<!-- 页面内容 -->

<script src="hairline.js"></script>
  • 标题用的两支衬线字体(Newsreader、思源宋体)从 Google Fonts 加载。离线或无法访问时,会回退到系统自带的宋体和 Georgia。
  • 正文在 Apple 设备上用系统的苹方和 San Francisco,其他平台用思源黑体。要在非 Apple 平台保证一致,把思源黑体也加进字体链接。
  • 脚本要放在内容之后,或者加 defer。

昼夜主题

在 <html> 上写 data-theme="light" 或 data-theme="dark"。不写就跟随系统的深浅色设置。想让读者自己切换,用一小段脚本把选择写到这个属性上,这个站点右上角的开关就是这样做的。

用令牌

所有令牌都是 CSS 变量,名字以 --hao- 开头,放进已有的页面不会和别的变量撞名。文档里说的 tint、space-4,写出来就是 var(--hao-tint)、var(--hao-space-4)。

语言

在 <html> 上写 lang="zh-CN" 或 lang="en"。标题的字号与字距、段落的对齐、引文的角标、月历的星期与农历,都会跟着语言走。详见英文界面。

浏览器

面向近两年的 Chrome、Safari、Edge、Firefox。纹样、图标、月相用到了 CSS 遮罩;中西文自动间距和标点挤压是较新的特性,旧浏览器上不生效,但不影响使用。