跳至主要内容

Web 使用指南

本指南協助你學習並使用 AppFuse Web 建構 React 應用。內容採 Diátaxis 分類;先依你的問題選擇閱讀方式,不需要依序讀完所有頁面。

:::info 升級既有專案 先確認當前發布線,再閱讀 Web Changelog框架升級指南。 :::

依問題選擇入口

我需要……文檔類型建議入口
從零跟著做出可運行成果教學建立新專案第一個 Applet
解決一個明確任務操作指南表單驗證切換 Mock 與真實 API
理解設計理由與權衡概念解釋Applet 模式Mock API 策略
查詢精確介面、設定或規格參考手冊表單元件Hooks工具函數

學習路徑

我是新手

  1. 建立新專案
  2. 建立第一個 Applet
  3. 表單元件
  4. 狀態管理

我想建立 Prototype

  1. 使用 app-office-mockup 作為起點。
  2. 閱讀 Mock API 指南
  3. 參考第一個 Applet
  4. Storybook檢查元件行為

我想建立生產環境應用

  1. 使用 app-office 作為參考實作。
  2. 了解 Mock → 真實 API
  3. 閱讀 狀態管理
  4. 測試參考完成驗證

參考資料的權威邊界

  • 元件庫:公開元件目錄與使用邊界。
  • Storybook:元件互動、狀態與視覺範例。
  • Guides Reference:跨元件的框架設定與使用規格。
  • Web Changelog:版本差異、Removed、Deprecated 與 Breaking Changes。

本指南的分類決策見 ADR-001。應用層的完整生命週期則從 開發指南開始。