Skip to content

FaContextMenu 右键菜单

右键点击时弹出的上下文菜单,支持分组、子菜单和图标。

使用场景

  • 表格行操作菜单
  • 文件/文件夹右键菜单
  • 画布/编辑器上下文菜单
  • 列表项操作菜单
  • 图片/媒体文件操作菜单

Props

属性类型默认值说明
items(MenuItem | MenuSubItem)[][]必需菜单项数组(二维数组)
ts
interface MenuItem {
  label: string
  icon?: string
  variant?: 'default' | 'destructive'
  disabled?: boolean
  handle?: () => void
}
ts
interface MenuSubItem {
  label: string
  items: (MenuItem | MenuSubItem)[][]
}

Slots

名称说明
default触发元素(必填)
label菜单头部标签

注意事项

  1. items 结构:二维数组,每个子数组为一组,组间自动添加分割线
  2. 图标一致性:组内任一菜单项有图标时,整组预留图标位置
  3. 触发区域:default slot 的元素为右键触发区域
  4. 子菜单:通过 items 属性嵌套实现多级菜单
  5. 危险操作:设置 variant: 'destructive' 标记为危险操作(红色)