指南總覽

指南區收錄 SoDialog 從接入到發布前檢查的工作流內容。API 細節放在 API 參考，這裡用來幫你選擇正確的整合、主題與排障路徑。

接入與使用

安裝

npm 安裝、ESM 匯入與樣式入口。

CDN 使用

固定版本 CDN、ESM/UMD 入口與範例版本切換。

框架整合

React、Vue、Nuxt、Next.js 等客戶端生命週期建議。

主題與樣式

CSS Variables、宿主頁面共存與 Bootstrap 相容邊界。

遷移與維護

Migration

從舊彈窗或專案內封裝遷移到 SoDialog。

Troubleshooting

定位樣式、焦點、CDN、佇列與生命週期問題。

FAQ

常見使用問題與設計邊界。

開發與發布流程

發布前驗證、版本檢查與 CI 路徑。

Adapter 設計

• Adapter Guidelines：統一入口、診斷 trace、日誌與反例。
• 框架適配器應保持薄封裝，不進入核心執行時依賴。