AIO 編輯器
Drag Handle
區塊拖曳把手。
hover 區塊時浮現的拖曳把手,可拖動整個區塊重排。不走 extensionsConfig——由 config.dragHandle 設定:false 停用、物件覆寫預設。拖曳清單項離開清單時會自動包回對應的 ul / ol(配合 AutoJoiner 合併相鄰清單)。
- config key:
config.dragHandle設定(預設啟用) - 來源:自製
選項(DragHandleConfigType)
| 欄位 | 型別 | 預設值 | 說明 |
|---|---|---|---|
scrollThreshold | number | 100 | 拖曳至視窗上下邊緣多少 px 內自動捲動 |
excludedTags | string[] | [] | 不顯示把手之 HTML 標籤 |
isChildNode | (nodeName: string) => boolean | undefined | 自訂「視為子節點」判定(子節點拖曳時以父層為單位) |
updateDelay | number | 250 | 更新節流(ms) |
resizeDelay | number | 60 | resize 節流(ms) |
options.placement | Placement | 'left-start' | 把手相對區塊之位置 |
options.offset | number | 13 | 與區塊之間距 |
其餘 options.* | 同 Bubble Menu | — | floating-ui middleware 與生命週期 hooks |
覆寫範例
const config: AioEditorConfig = { dragHandle: { scrollThreshold: 60, excludedTags: ['hr'] }}element 欄位由 UI 層注入(Teleport 掛載),consumer 不需設定。