blog
Critical CSS cho Next.js static: critters, font và màn hình đầu trên PSI mobile
Site Next.js static của tôi dính 3 bẫy PSI mobile: CSS chặn render, font inline tải sớm và JS chờ ở màn hình đầu. Đây là cách xử lý từng cái, bắt đầu từ critical CSS bằng critters ở postbuild.
- Ngày đăng
Màn hình đầu của một site Next.js static chậm trên PSI mobile vì 3 thứ: CSS chặn render, file font tải sớm và JS phải chạy trước khi nội dung hiện. Site này là Next.js 16 với output: 'export', và mỗi thứ có một bẫy riêng mà tôi đã dính. Critical CSS, font và quy ước cho màn hình đầu nằm ở scripts/inline-critical-css.js và vài quy ước trong component.
Critical CSS Next.js: chạy critters ở postbuild, đừng bật experimental.optimizeCss
Script chạy ở postbuild, sau khi next build đã xuất ra out/:
"postbuild": "node scripts/inline-critical-css.js && node scripts/generate-sitemaps.js && node scripts/check-seo.js && node scripts/check-links.js"
Với mỗi out/**/*.html, critters inline phần CSS cần cho màn hình đầu. File CSS đầy đủ chuyển sang nạp không chặn render (media="print" kèm onload, có <noscript> dự phòng). Cấu hình lõi:
const critters = new Critters({
path: OUT,
publicPath: '/',
preload: 'media',
inlineFonts: false,
preloadFonts: false,
allowRules: ['html:not(.dark)'],
reduceInlineStyles: false,
})
Tôi không bật experimental.optimizeCss của Next. critters của nó chạy trên HTML chưa có nội dung các layout dynamic (layouts/index.js), nên bỏ sót phần lớn CSS màn hình đầu. Script của tôi đọc HTML sau khi export xong.
3 chi tiết giữ cho nó chạy đúng:
pages/_document.jsrender sẵn classdark, để critters giữ rule dark. Biến màu light mode nằm ởhtml:not(.dark), không khớp DOM tĩnh, nênallowRulesgiữ tay.url(../media/…)của font tương đối theo/_next/static/chunks/. Inline vào HTML thì phải đổi sang đường tuyệt đối, không thì font 404 và chữ rơi về font fallback.- Thẻ
<link rel="preload" … as="style">của Next bị xoá, vì CSS đã nạp không chặn và preload đó chỉ tranh băng thông với ảnh LCP.
out = out.replace(/<style>[\s\S]*?<\/style>/g, (style) => style.replace(/url\(\.\.\//g, 'url(/_next/static/'))
Script throw nếu số trang có <style> khác số file HTML (chỉ N/M trang có CSS inline). Kiểm bằng mắt thì chặn **/*.css trong Playwright rồi so ảnh chụp màn hình đầu với bản đủ CSS.
Không inline @font-face có url(): PSI tính font xong trước paint là chặn render
Face inline vào HTML làm mọi file font màn hình đầu tải ngay, với priority VeryHigh. File nào xong trước lần paint đầu thì Lantern của PSI tính là chặn render. Triệu chứng tôi gặp: FCP mobile nhảy 0,8s ↔ 2s giữa các lượt đo. inlineFonts: false và preloadFonts: false ở trên là để tránh đúng chuyện này. Font thật nạp theo file CSS đầy đủ.
Có một chỗ phải bù. Khi inlineFonts tắt, critters bỏ mọi @font-face, kể cả face fallback của next/font (local(Arial) chỉnh size-adjust cho khớp metric Inter và JetBrains Mono). Thiếu nó, lần paint đầu dùng font mặc định của browser rồi chữ nhảy khi CSS đầy đủ tới. Script chèn tay đúng loại face đó:
function fallbackFaces(html) {
const faces = new Set()
for (const [, href] of html.matchAll(/href="(\/_next\/static\/[^"]+\.css)"/g)) {
const css = fs.readFileSync(path.join(OUT, href), 'utf8')
for (const face of css.match(/@font-face\{[^}]*src:local\([^}]*\}/g) || []) faces.add(face)
}
return [...faces].join('')
}
Bỏ face latin-ext: trang tiếng Việt khỏi tải thêm 86 KB font
next/font khai đủ mọi subset của Google Fonts, còn subsets chỉ quyết định phần preload. Các ký tự ơ ư ă đ nằm trong cả range latin-ext lẫn vietnamese. Face khai sau được xét trước, nên trang tiếng Việt luôn tải thêm Inter latin-ext 86 KB (và JetBrains Mono latin-ext) dù face vietnamese đã đủ glyph.
Content của site không dùng ký tự nào chỉ latin-ext mới có, nên script bỏ hẳn face đó khỏi CSS:
const LATIN_EXT_FACE = /@font-face\{[^}]*unicode-range:U\+100-2BA[^}]*\}/g
Regex bám vào chuỗi unicode-range mà Google phát. Google đổi range thì regex trượt im lặng và font thừa quay lại, nên script đếm số face đã bỏ và in cảnh báo khi bằng 0:
inline-critical-css: không thấy @font-face latin-ext nào để bỏ, kiểm lại LATIN_EXT_FACE
Cái giá: bài nào dùng ký tự chỉ latin-ext mới có (ł, ş, č…) thì ký tự đó rơi về Arial.
Màn hình đầu không chờ JS: Reveal, ảnh LCP và script bên thứ ba
Quy ước trong component:
Revealvà hiệu ứng fade củaImagechỉ ẩn phần tử nằm dưới màn hình lúc mount. Phần tử ở màn hình đầu luôn hiện, không đợi JS.- Ảnh LCP truyền
priority. Wrappercomponents/Image.jsxtự gắnfetchPriority="high", vì Next 16 không tự gắn. - Ảnh dự án ở
public/screenshots/dùng.webptrên trang, còn.jpgcùng tên giữ choog:image(components/Seo.jsx). Thêm screenshot mới thì sinh cả hai. - Bản
-720.webpchosrcsetdoscripts/resize-screenshots.jssinh ởprebuild(bỏ qua-mobile.webp).
Static export không có Image Optimization API, nên next.config.js dùng custom loader lib/image-loader.js. Chỉ /screenshots/*.webp có srcset (bản 720 cho candidate dưới 1024px). Mọi ảnh khác bị components/Image.jsx hoặc MDXImage đánh unoptimized. Gọi next/image trực tiếp ở chỗ mới thì phải tự truyền unoptimized, không thì ảnh đi qua loader.
GA4 và AdSense cũng không được chặn màn hình đầu. components/DeferredScripts.jsx nạp gtag.js và adsbygoogle.js sau tương tác đầu tiên, hoặc khi rảnh 4s sau load. 2 script này khoảng 1,3 MB JS chưa nén; đừng chuyển về <script> trong <head>.
Đo trên site thật, và chỗ chưa kiểm được trên máy
Tôi không đưa điểm PSI vào bài, vì điểm dao động theo lượt đo và bài này không có số đo kèm lệnh để chống lưng. Quy trình đo nằm ở docs/operations.md: lệnh psi chạy trên site thật, 5 lượt, báo trung vị. Lighthouse local không thay được số đó.
2 chỗ còn đánh đổi. Thứ nhất, ký tự latin-ext rơi về Arial, chấp nhận được khi content chỉ có tiếng Việt và tiếng Anh. Thứ hai, mọi thứ ở trên phụ thuộc vào HTML sau export: đổi cấu trúc out/, nâng critters hoặc nâng Next đều phải mở trang thật ra xem lại, vì không có test suite nào bắt hộ.
Bài viết liên quan
tất cả bài viết →- Gỡ @tailwindcss/aspect-ratio: lỗi im lặng khiến mọi ảnh cover cao 0pxPlugin aspect-ratio thay theme.aspectRatio nên Tailwind core ngừng phát aspect-video. Hộp ảnh sập còn 0px, mọi cover vô hình, build vẫn xanh. Đây là cách tôi lần ra và chặn lỗi này.đọc tiếp →
- check:seo và check:links trên out/ của Next.js: kiểm HTML đã build, không kiểm source2 gate chạy trong postbuild đọc thẳng out/**/*.html: canonical, og:image, hreflang hai chiều, title trùng, xhtml:link của sitemap, link nội bộ chết. Lỗi làm build fail trước khi deploy.đọc tiếp →
- Blog song ngữ trên Next.js static export: translationOf, hreflang và gate fail buildMỗi bài có 2 file Markdown nối nhau bằng một dòng translationOf. Map URL, hreflang, nút đổi ngôn ngữ và gate fail build đều suy ra từ dòng đó, không dùng i18n của Next.đọc tiếp →
- Bỏ server: chuyển site Next.js tĩnh sang Cloudflare Workers Static AssetsSite này chỉ là HTML, JS và ảnh, vậy mà từng nằm trên một VPS 2 GB RAM chung với khoảng 28 site khác. Cách chuyển nó sang Workers Static Assets: dịch cấu hình nginx sang _redirects và _headers, vì sao request không tính vào hạn mức gói Free, và 2 chỗ vấp sau ngày chuyển.đọc tiếp →