React 组件

UGDropdownMenu 下拉菜单

UGDropdownMenu 适合承载行操作、更多菜单和补充动作入口;菜单会限制在可视区域内,并完整执行打开与关闭动效。

导入方式

按需从包入口导入组件,并在应用入口引入一次样式文件。

tsx
import { UGDropdownMenu, UGDropdownTrigger, UGDropdownContent, UGDropdownItem, UGDropdownRadioItem, UGDropdownSeparator } from '@ug666/ui-react'

变体预览

支持点击、Enter、Space 与方向键打开;菜单内使用方向键移动,Escape 关闭并归还焦点。

状态展示

同时覆盖普通、禁用、危险和长文案菜单项;禁用项会被键盘导航跳过。

危险项建议配合 destructive

尺寸展示

可以搭配普通按钮、图标按钮或行尾菜单触发器使用。

代码示例

推荐用于卡片角标、表格行或工具栏二级动作。

tsx
import { UGButton, UGDropdownContent, UGDropdownItem, UGDropdownMenu, UGDropdownSeparator, UGDropdownTrigger } from '@ug666/ui-react'

export function RowActions() {
  return (
    <UGDropdownMenu>
      <UGDropdownTrigger>
        <UGButton variant="outline">操作</UGButton>
      </UGDropdownTrigger>
      <UGDropdownContent align="end">
        <UGDropdownItem>编辑</UGDropdownItem>
        <UGDropdownItem>归档</UGDropdownItem>
        <UGDropdownSeparator />
        <UGDropdownItem destructive>删除</UGDropdownItem>
      </UGDropdownContent>
    </UGDropdownMenu>
  )
}

属性

属性类型默认值说明
align'start' | 'end''start'设置菜单与触发器的首选对齐方式;靠近视口边缘时会自动限制位置。
destructivebooleanfalse为菜单项应用危险操作样式。
checkedboolean为单选菜单项声明当前选中状态,并同步可访问语义。
classNamestring扩展菜单、触发器与菜单项样式。