快速上手
Headed UI
Headed UI badge 表示元件包裝了自帶 DOM 與互動的第三方套件；API 多在上游，行為差異多半追上游版本。
文件頁、sidebar 或元件總覽出現 Headed UI badge，代表該元件包裝的第三方套件自帶 DOM 結構與互動。內部結構與行為由上游決定，admin 改不動。
多數 admin 元件包的是只給邏輯、不畫 UI 的套件（reka-ui、vidstack engine、embedpdf、cropperjs 等），DOM 由 admin 自寫，沒有此標記。
| 維度 | 一般 admin 元件 | Headed UI |
|---|---|---|
| DOM 結構與內部互動 | admin 自寫 | 上游決定、admin 改不動 |
| props / events / slots | admin 介面為主 | 大量透傳上游介面 |
| Bug 與行為差異 | admin 端可修 | 多數需追上游版本 |
使用注意
API 多在上游
該頁 API 參考表只列 admin 額外擴充或覆寫的欄位，不列上游透傳的 props / events / slots。
完整介面：點頁面右上角 參考 跳上游文件。例：Vxe Table → vxe-table API。
Bug 先分清來源
- admin 自加 prop / event / slot → 開 issue 到本 repo
- 上游套件本身 → 先查上游 issue tracker；已知問題可能需等上游修