跳到正文

排版

Pika 有一套全局字号体系。字号、行高、字重和字距都来自 --p-* token,组件和你自己的界面因此能对齐。字体家族见字体。Typography 排版组件(Heading、Text、Paragraph 等)已经按这套字号体系排好文字。

字号档位

共九档,每档是一个字号配一个固定行高。档位按密集界面调过:大部分文字落在 1 到 4 档(10 到 14px)。

级示例字号 / 行高
1敏捷的棕色狐狸跳过了懒狗 The quick brown fox10 / 14--p-font-size-1
2敏捷的棕色狐狸跳过了懒狗 The quick brown fox11 / 16--p-font-size-2
3敏捷的棕色狐狸跳过了懒狗 The quick brown fox12 / 16--p-font-size-3
4敏捷的棕色狐狸跳过了懒狗 The quick brown fox14 / 20--p-font-size-4
5敏捷的棕色狐狸跳过了懒狗 The quick brown fox16 / 24--p-font-size-5
6敏捷的棕色狐狸跳过了懒狗 The quick brown fox18 / 26--p-font-size-6
7敏捷的棕色狐狸跳过了懒狗 The quick brown fox20 / 28--p-font-size-7
8敏捷的棕色狐狸跳过了懒狗 The quick brown fox24 / 32--p-font-size-8
9敏捷的棕色狐狸跳过了懒狗 The quick brown fox30 / 38--p-font-size-9
档--p-font-size-N--p-line-height-N常见用途
110px14px等宽小标签、角标
211px16px等宽元信息
312px16px次要信息、说明文字、时间戳
414px20px正文、消息(默认)
516px24px大号正文、h4
618px26pxh3、面板标题
720px28pxh2
824px32pxh1、页面标题
930px38px展示用

同一档的字号和行高总是一起用:

css
.my-caption { font-size: var(--p-font-size-3); line-height: var(--p-line-height-3); }

行高用固定像素,密集列表里的行才对得齐。长文阅读(比如文档)改用 --p-line-height-prose(1.6)。

字重

Token值
--p-font-weight-regular400
--p-font-weight-medium500
--p-font-weight-strong600
--p-font-weight-heavy800

strong 是强调字重,浅色和深色模式相同。见字体页的“检查字重”一节。

字距

Token值常见用途
--p-letter-spacing-tight-0.01em大标题
--p-letter-spacing-normal0其他所有文字
--p-letter-spacing-wide0.02em需要透气的小字
--p-letter-spacing-widest0.08em大写的区块小标题、标签

控件

控件尺寸保留自己的 token:--p-common-font-size-tiny / -small / -medium / -large。前三个分别指向第 3、4、4 档(12、14、14px);large 仍是 15px,介于第 4 档和第 5 档之间。

文字颜色

每个主题根(:root,以及任何带 data-p-theme-mode 的元素,比如设置了 themeMode 的 ConfigProvider)都把 color 设为 --pw-alias-label-primary。主题根里的文字不会退回浏览器默认的黑色,否则在深色模式下会看不清。字体家族和字号不在根上设置,仍然从你的页面继承。