字体
Pika 选好了字体家族,但从不加载字体文件。字体怎么来由你的应用决定:自己托管、用字体服务,或者干脆不加载。
#Pika 用什么字体
浅色和深色模式用同一套字体:
正文(--p-font-sans) | 标题(--p-font-heading) | 等宽(--p-font-mono) |
|---|---|---|
| Geist | Inter | Geist Mono |
#字体栈是怎么组成的
每个字体栈都由三部分组成,顺序如下:
css
--p-font-sans: p-sans, "Geist", system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif, …;
/* ↑ 别名 ↑ 主题字体 ↑ 系统回退 */- 逻辑别名:
p-sans、p-heading或p-mono。默认没有任何字体注册在这些名字下,浏览器会跳过它们。把一个字体注册成其中某个名字,就能在所有地方替换这个角色的字体,不用写主题覆盖。 - Pika 的字体:Geist、Inter 或 Geist Mono。页面加载了它或者用户设备上装了它时才会用上。
- 系统回退:前两者都没有时使用,保证文字总能显示。
不做任何字体设置时,Pika 用系统字体渲染。
#加载字体
#自己托管(生产环境推荐)
自己提供字体文件,用上表里的字体名写 @font-face:
css
@font-face {
font-family: "Inter";
src: url("/fonts/Inter-Variable.woff2") format("woff2");
font-weight: 100 900;
font-display: swap;
}
@font-face {
font-family: "Geist";
src: url("/fonts/Geist-Variable.woff2") format("woff2");
font-weight: 100 900;
font-display: swap;
}只加载应用实际用到的字体。不显示代码的应用可以不加载 Geist Mono。
#从 Google Fonts 加载
本文档站就是这么做的:
css
@import url("https://fonts.googleapis.com/css2?family=Geist:wght@400..700&family=Geist+Mono:wght@300..700&family=Inter:wght@400;500;600;700&display=swap");放进应用的全局 CSS。注意这会让每个页面都去请求第三方域名。
#使用自己的字体
把你的字体注册成你想替换的那个角色的别名。比如在浅色和深色模式里都把正文换成品牌字体:
css
@font-face {
font-family: p-sans;
src: url("/fonts/Brand-Variable.woff2") format("woff2");
font-weight: 100 900;
font-display: swap;
}p-heading 对应标题,p-mono 对应代码。
只想在页面的一部分换字体,就覆盖变量:
tsx
<ConfigProvider themeOverrides={{ "--p-font-sans": '"Brand", system-ui, sans-serif' }}>
…
</ConfigProvider>#检查字重
Pika 用到这些字重:
| Token | 值 | 用在 |
|---|---|---|
--p-common-font-weight | 400 | 正文、按钮和控件 |
--p-common-font-weight-strong | 500 | 强调,strong 按钮 |
确认你加载的字体提供这些字重;覆盖 300–700 的可变字体就可以。字体缺某个字重时,浏览器会合成假粗体或者选最接近的字重,文字可能比预期更粗或更细。如果你的字体在别的字重下更好看,用 themeOverrides 调整这些 token:
tsx
<ConfigProvider themeOverrides={{ "--p-common-font-weight-strong": "600" }}>…</ConfigProvider>