OverflowAction

定义 OverflowActions 中的一项按钮操作，让它可随可用空间在工具栏与更多菜单之间切换。

我们正在让 SnowUI 组件成为 AI 对话中可直接操作的界面。目前对话交互能力仍在建设中；本页展示网站用法，支持的对话平台与组件版本将在验证后公布。 AI 对话内生成和使用 SnowUI 界面完全免费，不属于项目，不占项目或开发者席位额度，无需 SnowUI 注册、激活或付费证明。

如何使用

作为 OverflowActions 中的一个操作使用，操作身份应稳定。结构分隔使用 Separator，不作为可执行操作。

直接子项必须声明 as="item"，并提供唯一 id 和可读 label。
children 只替换可见按钮内容；收进菜单后的文字与图标仍取 label / icon。
专用按钮使用 control Snippet 替换可见 Button，并把收到的 run 回调接入该按钮的 onclick；菜单继续调用同一项的 onclick，切换状态通过专用按钮的公开绑定完成。

导入

import { OverflowAction } from '@snowui-design-system/components';

用法

API 参考

属性	类型	默认值	示例	描述
`id`	`string`	`必填`	`id="example"`	组内稳定且唯一的操作标识
`label`	`string`	`必填`	`label="Example"`	按钮文字、菜单文字与 Icon-only 无障碍名称
`icon`	`OverflowActionIcon`	`—`	`icon={value}`	资源图标名或自定义图标；菜单复用同一内容
`disabled`	`boolean`	`false`	`disabled`	禁用可见按钮与对应 MenuItem
`href`	`string`	`—`	`href="/components"`	可见状态渲染链接；菜单执行时导航到同一地址
`iconOnly`	`boolean`	`false`	`iconOnly`	内建可见 Button 仅显示 icon，label 作为无障碍名称；菜单仍显示 label
`onclick`	`(event?: MouseEvent) => void`	`—`	`onclick={(value) => { /* handle value */ }}`	可见按钮与菜单执行共享的操作函数
`children`	`Snippet`	`—`	`<OverflowAction>Content</OverflowAction>`	覆盖可见按钮内容；注册到菜单的 label / icon 仍取显式 Props 默认行为：自动 Icon + label。
`control`	`Snippet<[(event?: MouseEvent) => void, boolean]>`	`—`	`control={controlContent}`	用专用控件替换可见 Button；参数依次为 run 回调与最终 disabled，须接入控件的实际 onclick / disabled。菜单仍通过 onclick 执行；组件直接测量专用控件，不复制带状态控件的隐藏实例。
`parts`	`ComponentPartsOf<{ Button: typeof Button }>`	`—`	`parts={partsOptions}`	配置当前操作内建 Button；优先级低于直接 Button Props、高于父级组默认，父级不读取此配置来推断 More 按钮样式。
`as`	`string`	`—`	`as="Example"`	作为 OverflowActions 的直系子项时必须设置 "item"，以注册测量、溢出与菜单执行；未注册时不能参与父级响应式操作管理。