Qwik City

Qwik 專注於元件 API,而 Qwik City 提供了支援元件的 API,這些元件具有常見的以伺服器為中心的功能,包括以下內容

  • 路由:使用基於目錄的路由定義應用程式路由。(支援 MPA 和 SPA 路由模型。)
  • 頁面:渲染應用程式頁面,這是應用程式的主要功能。
  • 佈局:定義要在頁面之間重複使用的通用共用頁面佈局。
  • 載入器:在伺服器上抓取元件要使用的資料。
  • 動作:提供元件請求伺服器執行動作的方式。
  • 驗證器:提供驗證動作和載入器的方式。
  • 端點:一種為 RESTful API、GraphQL API、JSON、XML 或反向代理定義資料端點的方式。
  • 中介軟體:一種集中執行跨領域關注事項的方式,例如身份驗證、安全性、快取、重新導向和日誌記錄。
  • server$:一種在伺服器上執行邏輯的簡單方法。
  • 快取:控制內容的快取。
  • 環境變數:以平台獨立的方式管理讀取環境變數的 API,通常用於金鑰。
  • 支援伺服器端渲染 (SSR) 以建立完全動態的網站,以及靜態網站生成 (SSG) 以託管在靜態網路伺服器和 CDN 上。

Qwik¹ City²

Qwik¹:核心框架,穩定,基元,元件模型。

City²:基於檔案的路由器、中介軟體、端點以及資料抓取和更新。

Qwik City 是 Qwik 的元框架。Qwik City 之於 Qwik,就像 Next.js 之於 React、Nuxt 之於 Vue、SvelteKit 之於 Svelte,以及 Analog 之於 Angular。

Qwik(核心)和 Qwik City(路由)解決了兩個抽象層面的問題。Qwik 專注於元件和狀態管理基元,而 Qwik City 則帶來了一種構建大型網站的意見化且高效能的方式。我們不希望將生態系統鎖死在單一正確的網站構建方式中;事實上,我們鼓勵社群在 Qwik 之上構建替代解決方案。

雖然 Qwik City 充滿了有用的功能,但由於 Qwik 的可恢復性和 JavaScript 串流傳輸,Qwik City 對終端使用者來說沒有額外的成本。(零 JavaScript)。

使用 Qwik City 可以構建電子商務網站、部落格網站或任何需要路由、佈局或資料檢索/更新的網站。Qwik City 建立在 Qwik 之上,因此 Qwik City 網站是可恢復的,並且只會下載最少量的 JavaScript,並進行細粒度的延遲載入。

Qwik City 入門

請造訪 使用 CLI 建立應用程式,了解如何建立新的 Qwik City 入門專案。這就像

npm create qwik@latest
pnpm create qwik@latest
yarn create qwik
bun create qwik@latest

高階 API 概覽

此表格顯示應在哪些檔案(index.tsxlayout.tsx)中實作各個功能。

Partytown

Qwik City 也預先整合了 Partytown,讓您可以在主執行緒之外執行第三方程式碼。

貢獻者

感謝所有幫助改進此文件的人!

  • manucorporat
  • strogonoff
  • youngboy
  • farukEncoded
  • brunocrosier
  • forresst
  • mhevery
  • adamdbradley
  • wtlin1228
  • hamatoyogi
  • ownchoice
  • corydeppen
  • mrhoodz
  • shairez
  • debugmodedotnet