Nuxt Fontaine
Nuxt 3 的字体指标回退实现
功能
⚠️ @nuxtjs/fontaine
正在积极开发中。⚠️
- 💪 通过使用具有精心设计的字体指标的本地字体回退来减少 CLS。
- ✨ 自动生成字体指标和回退。
- ⚡️ 纯 CSS,零运行时开销。
在演示项目中,启用/禁用此模块会使渲染 /
产生以下差异,无需任何自定义
之前 | 之后 | |
---|---|---|
CLS | 0.34 | 0.013 |
性能 | 88 | 98 |
下一步
为了获得最佳性能,您需要内联所有 CSS,而不仅仅是字体回退规则(此模块会自动执行此操作),否则在加载样式表时仍然会出现布局偏移(这就是上面的数字不为零的原因)。
此 PR 旨在将该功能引入 Nuxt 本身。
安装
npx nuxi@latest module add fontaine
用法
export default defineNuxtConfig({
modules: ['@nuxtjs/fontaine'],
// If you are using a Google font or you don't have a @font-face declaration
// for a font you're using, you can declare them here.
//
// In most cases this is not necessary.
//
// fontMetrics: {
// fonts: ['Inter', { family: 'Some Custom Font', src: '/path/to/custom/font.woff2' }],
// },
})
就是这样!
Tailwind CSS
如果您使用 Tailwind CSS 并通过配置文件使用自定义字体,则需要手动添加回退字体。
import type { Config } from 'tailwindcss'
import { fontFamily } from 'tailwindcss/defaultTheme'
export default <Partial<Config>> {
theme: {
extend: {
fontFamily: {
sans: ['Roboto', 'Roboto fallback', ...fontFamily.sans],
},
},
},
}
工作原理
Nuxt 将扫描您的 @font-face
规则并生成具有正确指标的回退规则。例如
@font-face {
font-family: 'Roboto';
font-display: swap;
src: url('/fonts/Roboto.woff2') format('woff2'), url('/fonts/Roboto.woff') format('woff');
font-weight: 700;
}
/* This will be generated. */
@font-face {
font-family: 'Roboto fallback';
src: local('BlinkMacSystemFont'), local('Segoe UI'), local('Roboto'), local('Helvetica Neue'),
local('Arial'), local('Noto Sans');
ascent-override: 92.7734375%;
descent-override: 24.4140625%;
line-gap-override: 0%;
}
然后,每当您使用 font-family: 'Roboto'
时,Nuxt 都会将回退添加到 font-family
:root {
font-family: 'Roboto';
/* This becomes */
font-family: 'Roboto', 'Roboto fallback';
}
在 Nuxt 之外使用
此模块的核心可以在 Nuxt 之外工作,并且已分离到一个单独的库中:fontaine
。去看看吧!
💻 开发
- 克隆此存储库
- 使用
corepack enable
启用 Corepack - 使用
pnpm install
安装依赖项 - 使用
pnpm dev:prepare
存根模块 - 运行
pnpm dev
以在开发模式下启动 演示
鸣谢
没有以下内容是不可能实现的
- 来自 capsizecss 的出色工具和生成的指标
- Katie Hempenius & Kara Erickson 在 Google Aurora 团队提出的建议和算法 - 请参阅关于计算字体指标覆盖的说明。
许可证
用 ❤️ 制作
在 MIT 许可证下发布。