# Admin Registry

> admin 組件 registry，配合 shadcn-vue CLI 安裝。

## Documentation Sets

- [Admin Registry 完整文件](https://component-registry-4d4d86.gitlab.io/llms-full.txt): Admin Registry 全部組件的完整文件。

## Docs

- [Alert Dialog](https://component-registry-4d4d86.gitlab.io/docs/admin/alert-dialog): 高風險操作確認用的強制對話框；需明確回應後才能關閉。
- [Audio Player](https://component-registry-4d4d86.gitlab.io/docs/admin/audio-player): 音訊播放器（vidstack）。播放、快進快退、音量、播放速度、時間顯示。
- [Avatar](https://component-registry-4d4d86.gitlab.io/docs/admin/avatar): 圓形頭像。縮圖或替代文字。
- [Badge](https://component-registry-4d4d86.gitlab.io/docs/admin/badge): 狀態或數量的小型標籤。尺寸 small／medium／large。
- [Breadcrumb](https://component-registry-4d4d86.gitlab.io/docs/admin/breadcrumb): 目前頁面在網站階層中的位置。
- [Button](https://component-registry-4d4d86.gitlab.io/docs/admin/button): 觸發動作的按鈕。尺寸 medium／small；樣式 filled／outline／ghost。
- [Checkbox](https://component-registry-4d4d86.gitlab.io/docs/admin/checkbox): 核取方塊。單選、多選、不定態（indeterminate）。
- [Color Picker](https://component-registry-4d4d86.gitlab.io/docs/admin/color-picker): 從呼叫端傳入的色票陣列挑選顏色。
- [Cropper](https://component-registry-4d4d86.gitlab.io/docs/admin/cropper): 圖片裁切。可拖移 selection、zoom、即時預覽；可搭配 dialog／stepper 做多尺寸裁切。
- [Date Picker](https://component-registry-4d4d86.gitlab.io/docs/admin/date-picker): 日期選擇器（@ark-ui/vue）。單日、區間選取。
- [Dialog](https://component-registry-4d4d86.gitlab.io/docs/admin/dialog): 覆蓋頁面內容的模態對話框。
- [Divider](https://component-registry-4d4d86.gitlab.io/docs/admin/divider): 區隔內容的分隔線。方向：水平（預設）、垂直。
- [Dropdown Menu](https://component-registry-4d4d86.gitlab.io/docs/admin/dropdown-menu): 點按 trigger 後彈出的選項列表；含鍵盤導航。
- [Field](https://component-registry-4d4d86.gitlab.io/docs/admin/field): 表單欄位容器。統一 label、說明、錯誤訊息排版。
- [File Upload](https://component-registry-4d4d86.gitlab.io/docs/admin/file-upload): 多檔上傳。拖曳、驗證、File 與 URL 並存；上傳由父層監聽 upload 事件處理。
- [Image](https://component-registry-4d4d86.gitlab.io/docs/admin/image): 圖片純展示。視覺態：loading／loaded／error。
- [Image Upload](https://component-registry-4d4d86.gitlab.io/docs/admin/image-upload): 單張圖片上傳。
- [Input](https://component-registry-4d4d86.gitlab.io/docs/admin/input): 文字輸入欄位。可搭配清除、密碼切換、字數限制等子組件。
- [Loading](https://component-registry-4d4d86.gitlab.io/docs/admin/loading): 讀取中指示。全螢幕或區塊 inline。
- [Notification](https://component-registry-4d4d86.gitlab.io/docs/admin/notification): 浮動通知（vue-sonner）。狀態變體與動作按鈕。
- [Number Field](https://component-registry-4d4d86.gitlab.io/docs/admin/number-field): 數字輸入。含增減控制。
- [Overlay](https://component-registry-4d4d86.gitlab.io/docs/admin/overlay): 程式化開啟 Dialog、Drawer 等浮層。可動態更新 props；結果以 Promise 回傳。
- [Pagination](https://component-registry-4d4d86.gitlab.io/docs/admin/pagination): 分頁導覽。頁碼、資訊區、每頁筆數選擇。
- [Pdf Viewer](https://component-registry-4d4d86.gitlab.io/docs/admin/pdf-viewer): 內嵌 PDF 檢視器（EmbedPDF）。
- [Progress](https://component-registry-4d4d86.gitlab.io/docs/admin/progress): 進度條。顯示百分比。
- [Radio Group](https://component-registry-4d4d86.gitlab.io/docs/admin/radio-group): 互斥單選按鈕組。
- [Scroll Area](https://component-registry-4d4d86.gitlab.io/docs/admin/scroll-area): 可捲動容器。自訂捲動列樣式。
- [Select](https://component-registry-4d4d86.gitlab.io/docs/admin/select): 下拉選擇器。單選／多選、選項搜尋、tag 顯示、自訂選項渲染。
- [Side Menu](https://component-registry-4d4d86.gitlab.io/docs/admin/side-menu): 後台側邊導覽。展開／收合、分組、巢狀子項目、行動裝置抽屜。
- [Stepper](https://component-registry-4d4d86.gitlab.io/docs/admin/stepper): 多步驟進度指示器。目前步驟與整體流程狀態。
- [Switch](https://component-registry-4d4d86.gitlab.io/docs/admin/switch): 布林狀態開關。
- [Tabs](https://component-registry-4d4d86.gitlab.io/docs/admin/tabs): 分頁切換。
- [Tag](https://component-registry-4d4d86.gitlab.io/docs/admin/tag): 分類、狀態或關鍵字的靜態標籤。
- [Textarea](https://component-registry-4d4d86.gitlab.io/docs/admin/textarea): 多行文字輸入。可搭配字數限制。
- [Timeline](https://component-registry-4d4d86.gitlab.io/docs/admin/timeline): 依節點狀態呈現進度的時間軸。狀態：pending／current／completed／error；方向：垂直、水平。
- [Tooltip](https://component-registry-4d4d86.gitlab.io/docs/admin/tooltip): 懸停時顯示輔助說明。
- [Tree](https://component-registry-4d4d86.gitlab.io/docs/admin/tree): 巢狀資料。展開、收合、選取。
- [Video Player](https://component-registry-4d4d86.gitlab.io/docs/admin/video-player): 影片播放器（vidstack）。來源：MP4、HLS、YouTube；控制：快進快退、解析度、播放速度、音量、全螢幕。
- [Vxe Table](https://component-registry-4d4d86.gitlab.io/docs/admin/vxe-table): 資料表格（vxe-table）。排序、勾選、分頁。
- [llms.txt](https://component-registry-4d4d86.gitlab.io/docs/ai/llms-txt): 站點提供 /llms.txt（索引）與 /llms-full.txt（全文），供 AI 工具以 web fetch 讀取文件。
- [MCP](https://component-registry-4d4d86.gitlab.io/docs/ai/mcp): 用 shadcn-vue 官方 MCP server，在對話中瀏覽與安裝 @admin 元件。
- [Agent skill](https://component-registry-4d4d86.gitlab.io/docs/ai/skills): 用 npx skills 安裝 admin-registry skill；與官方 shadcn-vue skill 並用，補 @admin 規則。
- [AIO 編輯器總覽](https://component-registry-4d4d86.gitlab.io/docs/aio-editor/overview): config 驅動的 all-in-one 富文本編輯器系列，傳入設定即得完整編輯器。
- [AioEditor](https://component-registry-4d4d86.gitlab.io/docs/aio-editor/editor): config 驅動的 all-in-one 富文本編輯器，傳入設定即得完整編輯器，無需組裝子元件。
- [Extensions 總覽](https://component-registry-4d4d86.gitlab.io/docs/aio-editor/extensions/overview): AIO 編輯器全部 extension 一覽，逐一提供完整選項說明。
- [Subscript](https://component-registry-4d4d86.gitlab.io/docs/aio-editor/extensions/subscript): 下標 mark。
- [Superscript](https://component-registry-4d4d86.gitlab.io/docs/aio-editor/extensions/superscript): 上標 mark。
- [Document / Text / Gapcursor](https://component-registry-4d4d86.gitlab.io/docs/aio-editor/extensions/schema-base): schema 基底與游標行為，皆無選項。
- [Paragraph](https://component-registry-4d4d86.gitlab.io/docs/aio-editor/extensions/paragraph): 段落節點。
- [Heading](https://component-registry-4d4d86.gitlab.io/docs/aio-editor/extensions/heading): 標題節點。
- [Blockquote](https://component-registry-4d4d86.gitlab.io/docs/aio-editor/extensions/blockquote): 引用區塊節點。
- [HorizontalRule](https://component-registry-4d4d86.gitlab.io/docs/aio-editor/extensions/horizontal-rule): 水平分隔線節點。
- [HardBreak](https://component-registry-4d4d86.gitlab.io/docs/aio-editor/extensions/hard-break): 強制斷行節點。
- [CodeBlock](https://component-registry-4d4d86.gitlab.io/docs/aio-editor/extensions/code-block): 程式碼區塊（lowlight 語法高亮）。
- [BulletList](https://component-registry-4d4d86.gitlab.io/docs/aio-editor/extensions/bullet-list): 項目清單節點。
- [Bold](https://component-registry-4d4d86.gitlab.io/docs/aio-editor/extensions/bold): 粗體 mark。
- [OrderedList](https://component-registry-4d4d86.gitlab.io/docs/aio-editor/extensions/ordered-list): 編號清單節點。
- [ListItem](https://component-registry-4d4d86.gitlab.io/docs/aio-editor/extensions/list-item): 清單項節點。
- [TaskList](https://component-registry-4d4d86.gitlab.io/docs/aio-editor/extensions/task-list): 待辦清單節點。
- [TaskItem](https://component-registry-4d4d86.gitlab.io/docs/aio-editor/extensions/task-item): 待辦清單項節點。
- [ListKeyMap](https://component-registry-4d4d86.gitlab.io/docs/aio-editor/extensions/list-keymap): 清單鍵盤行為。
- [TextAlign](https://component-registry-4d4d86.gitlab.io/docs/aio-editor/extensions/text-align): 文字對齊。
- [Indent](https://component-registry-4d4d86.gitlab.io/docs/aio-editor/extensions/indent): 區塊縮排。
- [LineHeight](https://component-registry-4d4d86.gitlab.io/docs/aio-editor/extensions/line-height): 行高。
- [FontFamily](https://component-registry-4d4d86.gitlab.io/docs/aio-editor/extensions/font-family): 字體。
- [FontSize](https://component-registry-4d4d86.gitlab.io/docs/aio-editor/extensions/font-size): 字級。
- [Italic](https://component-registry-4d4d86.gitlab.io/docs/aio-editor/extensions/italic): 斜體 mark。
- [UndoRedo](https://component-registry-4d4d86.gitlab.io/docs/aio-editor/extensions/undo-redo): 編輯歷史。
- [Dropcursor](https://component-registry-4d4d86.gitlab.io/docs/aio-editor/extensions/dropcursor): 拖放位置指示線。
- [Placeholder](https://component-registry-4d4d86.gitlab.io/docs/aio-editor/extensions/placeholder): 空內容提示文字。
- [CharacterCount](https://component-registry-4d4d86.gitlab.io/docs/aio-editor/extensions/character-count): 字數統計與上限。
- [KeydownHandler](https://component-registry-4d4d86.gitlab.io/docs/aio-editor/extensions/keydown-handler): 鍵盤事件 hook。
- [AutoJoiner](https://component-registry-4d4d86.gitlab.io/docs/aio-editor/extensions/auto-joiner): 相鄰清單自動合併。
- [CopyData](https://component-registry-4d4d86.gitlab.io/docs/aio-editor/extensions/copy-data): data-copy 屬性保留。
- [Link](https://component-registry-4d4d86.gitlab.io/docs/aio-editor/extensions/link): 超連結 mark。
- [Image](https://component-registry-4d4d86.gitlab.io/docs/aio-editor/extensions/image): 圖片節點（可拖曳縮放）。
- [Video](https://component-registry-4d4d86.gitlab.io/docs/aio-editor/extensions/video): 影片節點。
- [Strike](https://component-registry-4d4d86.gitlab.io/docs/aio-editor/extensions/strike): 刪除線 mark。
- [TableKit](https://component-registry-4d4d86.gitlab.io/docs/aio-editor/extensions/table-kit): 表格（含 grip 選取）。
- [Mention](https://component-registry-4d4d86.gitlab.io/docs/aio-editor/extensions/mention): @ 提及（opt-in）。
- [HashTag](https://component-registry-4d4d86.gitlab.io/docs/aio-editor/extensions/hash-tag): # 標籤（opt-in）。
- [Bubble Menu](https://component-registry-4d4d86.gitlab.io/docs/aio-editor/extensions/bubble-menu): 七種情境的浮動選單。
- [Drag Handle](https://component-registry-4d4d86.gitlab.io/docs/aio-editor/extensions/drag-handle): 區塊拖曳把手。
- [Underline](https://component-registry-4d4d86.gitlab.io/docs/aio-editor/extensions/underline): 底線 mark。
- [Code](https://component-registry-4d4d86.gitlab.io/docs/aio-editor/extensions/code): 行內程式碼 mark。
- [TextStyle](https://component-registry-4d4d86.gitlab.io/docs/aio-editor/extensions/text-style): 文字樣式載體 mark。
- [Color](https://component-registry-4d4d86.gitlab.io/docs/aio-editor/extensions/color): 文字顏色。
- [Highlight](https://component-registry-4d4d86.gitlab.io/docs/aio-editor/extensions/highlight): 螢光標記 mark。
- [編輯器總覽](https://component-registry-4d4d86.gitlab.io/docs/editor/overview): 以 @tiptap/vue-3 為底的文字編輯器；核心與擴充包分開安裝。
- [自訂指南](https://component-registry-4d4d86.gitlab.io/docs/editor/customization): 加 extension、客製 toolbar，塞進自己的按鈕、下拉選單與元件。
- [Editor](https://component-registry-4d4d86.gitlab.io/docs/editor/core/editor): 基於 @tiptap/vue-3 的空白編輯器核心；無 extension、無 toolbar。
- [Rich Editor](https://component-registry-4d4d86.gitlab.io/docs/editor/core/rich-editor): admin-editor 加上 StarterKit；粗體、標題、清單等基本格式。
- [Editor Toolbar](https://component-registry-4d4d86.gitlab.io/docs/editor/core/toolbar): admin-rich-editor 的工具列。layout：fixed／bubble／floating；可放按鈕、下拉選單與自訂元件。
- [Editor Image](https://component-registry-4d4d86.gitlab.io/docs/editor/addons/image): 顯示圖片；以程式插入 img。
- [Editor Emoji Menu](https://component-registry-4d4d86.gitlab.io/docs/editor/addons/emoji): 輸入 : 觸發浮動選單；挑選並插入 emoji。
- [Editor Suggestion Menu](https://component-registry-4d4d86.gitlab.io/docs/editor/addons/suggestion): 輸入 / 觸發浮動選單；挑選指令執行對應動作。
- [Editor Link Bubble](https://component-registry-4d4d86.gitlab.io/docs/editor/addons/link-bubble): 游標位於連結時浮出泡泡；檢視、編輯、移除。
- [Editor List Trash](https://component-registry-4d4d86.gitlab.io/docs/editor/addons/list-trash): 游標位於清單項時，旁側浮出刪除鈕。
- [Editor Drag Handle](https://component-registry-4d4d86.gitlab.io/docs/editor/addons/drag-handle): 游標停在區塊時左側浮出把手；拖曳排序或選取區塊。
- [Editor Table](https://component-registry-4d4d86.gitlab.io/docs/editor/addons/table): 插入表格；Notion 式欄／列 grip 選取與操作。
- [Editor Superscript / Subscript](https://component-registry-4d4d86.gitlab.io/docs/editor/addons/superscript-subscript): toolbar 上標／下標按鈕；sup／sub 行內樣式。
- [Editor Video](https://component-registry-4d4d86.gitlab.io/docs/editor/addons/video): 顯示影片；以程式插入原生 video。
- [Editor YouTube](https://component-registry-4d4d86.gitlab.io/docs/editor/addons/youtube): 嵌入 YouTube 影片；以程式插入。
- [Editor Font Size](https://component-registry-4d4d86.gitlab.io/docs/editor/addons/font-size): toolbar 字級控制：−／下拉／+。
- [Editor Markdown](https://component-registry-4d4d86.gitlab.io/docs/editor/addons/markdown): 以 markdown 字串為內容；content-type="markdown" 雙向轉換。
- [Editor Code Block](https://component-registry-4d4d86.gitlab.io/docs/editor/addons/code-block): 程式碼區塊；語言選擇與語法上色。
- [Editor Text Color](https://component-registry-4d4d86.gitlab.io/docs/editor/addons/text-color): toolbar 文字顏色按鈕與色板；套用至選取文字。
- [Editor Highlight](https://component-registry-4d4d86.gitlab.io/docs/editor/addons/highlight): toolbar 文字底色按鈕與色板；標示選取文字。
- [Editor TextAlign](https://component-registry-4d4d86.gitlab.io/docs/editor/addons/text-align): toolbar 對齊按鈕；標題／段落左中右。
- [Editor Placeholder](https://component-registry-4d4d86.gitlab.io/docs/editor/addons/placeholder): 內容為空時顯示提示文字。
- [Editor TaskList](https://component-registry-4d4d86.gitlab.io/docs/editor/addons/task-list): 可勾選待辦清單。
- [Editor Indent](https://component-registry-4d4d86.gitlab.io/docs/editor/addons/indent): toolbar 縮排按鈕；段落、標題、清單層級。
- [Editor Mention Menu](https://component-registry-4d4d86.gitlab.io/docs/editor/addons/mention): 輸入 @ 觸發浮動選單；挑選並插入提及對象。
- [介紹](https://component-registry-4d4d86.gitlab.io/docs/get-started/introduction): 透過 shadcn-vue CLI 複製進專案的 Vue 3 admin 元件集合（admin- 字首）。
- [安裝](https://component-registry-4d4d86.gitlab.io/docs/get-started/installation): 把 @admin registry 接到專案，並用 shadcn-vue CLI 安裝樣式與元件。
- [主題](https://component-registry-4d4d86.gitlab.io/docs/get-started/theming): 語意色彩 token（primary-*、text-*、bg-*、狀態色）與 typo-* typography utilities。
- [Type-safe](https://component-registry-4d4d86.gitlab.io/docs/get-started/type-safe): 把 Type-safe 範例複製到已安裝 @admin 元件的專案，並開啟 strictVModel 後，編輯器才會標出刻意錯誤的 v-model 綁定。
- [Headed UI](https://component-registry-4d4d86.gitlab.io/docs/get-started/headed-ui): Headed UI badge 表示元件包裝了自帶 DOM 與互動的第三方套件；API 多在上游，行為差異多半追上游版本。