工程開發
frontend avatar

frontend

Preact 與 Tailwind 的前端編碼規範。適用於叢集應用程式的網頁 UI 元件開發。

簡介

此技能為 Hippocampus 平台的前端開發提供了標準化的編碼規範與架構模式,特別針對 cluster/applications/ 目錄下的靜態前端應用。它作為開發人員與 AI 代理的權威參考,確保 Kubernetes 平台生態系統中所有網頁 UI 元件的一致性、無障礙支援與框架遵循。

主要功能與能力包括:

  • 強制執行 Preact 作為靜態前端元件的主要 UI 函式庫。
  • 指定使用 Tailwind CSS 進行樣式設計,確保設計系統的統一性。
  • 要求使用 Preact 的 h() 函式而非 JSX/TSX 語法,以維持輕量級的依賴需求。
  • 提供手動實作 UI 時的無障礙遵循協定。
  • 針對表單與表格的 DOM 元素關聯提供具體指導,包括 label 與 input 的對應以及 ARIA 屬性的使用。

使用說明、實務建議與限制:

  • 針對所有位於 cluster/applications/ 目錄下的 UI 元件,請一律使用 Preact 與 Tailwind。
  • Next.js 與 shadcn/ui 僅限於 workers/ 目錄下的 Cloudflare Workers 環境使用。
  • 在手動實作無障礙功能時,務必將表單輸入與明確標籤配對,或在省略可視標籤時使用 aria-label;表格標頭則須顯式使用 scope 屬性(如 col 或 row)。
  • 遵循 h(element, attributes, children) 的編碼模式,以確保程式碼符合專案的建置流程。
  • 在建立、修改或審查任何與前端相關的 JavaScript、HTML 或 CSS 檔案時,應觸發此技能,以便儘早發現不符規範的代碼。
  • 優先使用 Tailwind 的 sr-only 工具類別,在保持語意化無障礙的同時滿足自定義設計需求。

倉庫統計

Star 數
4
Fork 數
2
Open Issue 數
1
主要語言
Go
預設分支
main
同步狀態
閒置
最近同步時間
2026年5月3日 下午05:35
在 GitHub 查看