块句柄与拖拽

块句柄组件在悬停块左侧显示把手，提供块级操作菜单：剪切 / 复制 / 翻译 / 创建副本 / 上下移动 / 删除，以及「转为…」类型切换、整块对齐与整块配色。按住把手可拖拽整块移动，拖拽过程显示落点指示线。

配置示例

new LarkDoc({
  element: '#editor',
  features: { blockHandle: true, blockDrag: true },
  blockMenu: {
    // 可选：裁剪块菜单动作
    disabled: ['translate'],   // 隐藏「翻译」
    allow: null,               // null = 全部动作；数组为白名单
  },
})

配置与用法

配置项	类型	默认值	说明
`features.blockHandle`	`boolean`	`true`	关闭后把手与块菜单不显示。
`features.blockDrag`	`boolean`	`true`	关闭后禁止拖拽移动（把手仍可用）。
`blockMenu.disabled`	`string[]`	`[]`	禁用指定动作。
`blockMenu.allow`	`string[] \| null`	`null`	动作白名单，`null` 为全部。

块菜单动作（id）

id	说明	id	说明
`cut` / `copy`	剪切 / 复制	`moveUp` / `moveDown`	上移 / 下移区块
`translate`	翻译	`duplicate`	创建副本
`delete`	删除区块

「转为…」类型

paragraph（正文）、heading1–heading3（标题）、orderedList / bulletList / taskList（列表）、codeBlock（代码块）、blockquote（引用）。

使用方式

操作	说明
悬停左侧把手	显示块菜单。
拖拽把手	移动整块，落点位置显示指示线。
菜单悬停停留	展开二级菜单（转为… / 对齐 / 颜色）。

块句柄与拖拽 ​

配置示例 ​

配置与用法 ​

块菜单动作（id） ​

「转为…」类型 ​