Astro
概述
Astro 是一個專為內容驅動網站設計的網頁框架,預設不載入任何 JavaScript。其島嶼架構僅對互動元件進行水合,在支援 React、Vue、Svelte 或任何需要互動性的 UI 框架同時,能達成優異的 Lighthouse 評分。
使用說明
- 建立頁面時,請在
src/pages/中使用.astro、.md或.mdx檔案進行基於檔案的路由,並在src/layouts/中組織共用的版面結構。 - 加入互動性時,請在框架元件上使用客戶端指令:優先使用
client:visible或client:idle,而非client:load,因為大多數元件不需要立即水合。 - 管理內容時,請在
src/content/中使用defineCollection()並搭配嚴格的 Zod schema 定義內容集合,並使用getCollection()與getEntry()進行查詢。 - 選擇渲染模式時,行銷與內容頁面預設使用靜態生成 (SSG),動態頁面使用
output: "server",或透過每個頁面的export const prerender = false使用混合渲染。 - 最佳化圖片時,請使用
astro:assets的<Image>元件進行自動格式轉換 (WebP/AVIF)、調整大小與延遲載入,而非使用原始的<img>標籤。 - 加入頁面轉場效果時,請啟用 View Transitions(使用
<ViewTransitions />),以實現類 SPA 的導航體驗,而無需載入客戶端路由器。 - 整合 UI 框架時,請安裝相應的整合套件(
@astrojs/react、@astrojs/vue、@astrojs/svelte),並使用 Astro 元件處理靜態內容,僅在需要互動性時才使用框架元件。
範例
範例 1:使用內容集合建立部落格
使用者請求:「建立一個具有型別安全 Markdown 內容的 Astro 部落格」
操作步驟:
- 使用 Zod schema 為 frontmatter(標題、日期、標籤、作者)定義一個部落格內容集合
- 建立動態路由
src/pages/blog/[slug].astro並使用getStaticPaths() - 透過
getCollection("blog")查詢並排序,建立部落格索引頁面 - 加入包含 SEO meta 標籤、導覽列與 View Transitions 的版面配置
輸出: 一個靜態生成的部落格,具有經過驗證的內容、簡潔的 URL 以及流暢的頁面轉場效果。
範例 2:在靜態網站中加入互動元件
使用者請求:「在我的 Astro 文件網站中加入一個 React 搜尋元件」
操作步驟:
- 安裝
@astrojs/react整合套件 - 建立包含狀態與事件處理的 React 搜尋元件
- 使用
client:idle指令將該元件加入到頁面中 - 從 Astro 頁面的 frontmatter 將靜態資料作為 props 傳遞
輸出: 一個完全靜態的文件網站,除了互動式搜尋島嶼之外。
指引
- 使用 Astro 元件處理靜態內容;僅在需要互動性時才使用 React/Vue/Svelte。
- 水合指令預設使用
client:visible或client:idle,而非client:load。 - 使用嚴格的 Zod schema 定義內容集合,以便在建置時捕捉內容錯誤。
- 使用
astro:assets的<Image>元件取代原始<img>標籤,以獲得自動最佳化。 - 保持版面輕量,共用
<head>、導覽列與頁尾;頁面特定內容放在頁面中。 - 使用混合渲染:行銷頁面使用靜態生成,僅個人化或動態頁面使用 SSR。
- 啟用 View Transitions 以獲得類 SPA 的導航體驗,無需載入路由器。