快速上手
三步搭出第一个页面:引入文件,写标记,按「三条规矩」检查一遍。
一个完整的页面
把下面这段存成一个 HTML 文件,和 hairline.css、hairline.js 放在一起,用浏览器打开:
<!doctype html>
<html lang="zh-CN" data-theme="light">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>札记</title>
<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">
</head>
<body style="margin:0;background:var(--hao-bg);color:var(--hao-ink);font:400 17px/28px var(--hao-font-sans)">
<main class="hao-page" style="padding-top:48px">
<h1 class="hao-title-1" style="margin:0 0 24px">今日</h1>
<div class="hao-card hao-card--wave" style="max-width:390px">
<h2 class="hao-card__title">晨间札记</h2>
<p class="hao-card__body">窗外起了薄雾。把今天要做的三件事写下来,其余的先放一放。</p>
</div>
<p style="margin-top:24px">
<button class="hao-btn" data-hao-toast="已保存" data-hao-toast-ok>保存修改</button>
<button class="hao-btn hao-btn--plain" data-hao-open="confirm">删除</button>
</p>
</main>
<div class="hao-scrim" id="confirm" data-hao-modal hidden>
<div class="hao-dialog" role="alertdialog" aria-modal="true" aria-labelledby="confirm-title">
<h2 class="hao-dialog__title" id="confirm-title">删除这条札记</h2>
<p class="hao-dialog__body">删除后无法恢复。</p>
<div class="hao-dialog__actions">
<button class="hao-btn hao-btn--tinted" data-hao-close data-hao-initial>取消</button>
<button class="hao-btn hao-btn--seal" data-hao-close>删除</button>
</div>
</div>
</div>
<script src="hairline.js"></script>
</body>
</html>
组件怎么写
- 所有类名以
hao-开头。零件用两道下划线(hao-card__title),变体用两道横线(hao-btn--tinted)。 - 能用原生元素的地方都用原生元素:按钮是
<button>,开关是<input type="checkbox">,下拉是<select>。 - 行为靠属性声明。上面例子里的
data-hao-open、data-hao-close、data-hao-toast就是。全部属性见行为与脚本。 - 每个组件的页面都有可以操作的演示,点「显示代码」能看到对应的标记,直接复制。
做完检查三件事
- 朱砂一处。这一屏里红色是不是只出现了一次(一方印、一个角标、一个删除按钮)。
- 一屏一景。纹样、小品、装裱这类「景」是不是至多一个;设置和表单这类办事的页面应该一个都没有。
- 形随控件。进度是不是只用了一种意象,月亮是不是只出现了一处。
规矩的全文在设计原则里。
换成你自己的
这套系统不只属于一个产品。拿去用时换三样:印文、产品名、落款的年款。颜色、字体、间距的令牌和三条规矩保持原样。要做一方真正的篆字印,见印稿规范。