用于 SxMenu 或 SxMenuButton 中的具体操作项。对齐 Microsoft Fluent UI Blazor MenuItem (v4.13.2) 的 API 结构,并说明 NextUI 当前实现状态。
使用场景
- 菜单项操作入口
- 快捷操作列表
- 菜单分组与快捷键提示
约束说明
Text 为必填显示文本。
Shortcut 仅做展示,不处理快捷键逻辑。
行为说明
- 点击时触发
OnClick 并通知父菜单。
Disabled 为真时不可点击。
API
Parameters (参数)
| 状态 |
参数名 |
类型 |
默认值 |
描述 |
| Implemented |
Text |
string |
"" |
菜单项显示文字。 |
| Implemented |
Icon |
string? |
null |
菜单项图标。 |
| Implemented |
IconStyle |
IconStyle |
Regular |
图标风格。 |
| Implemented |
Shortcut |
string? |
null |
快捷键提示。 |
| Implemented |
Value |
object? |
null |
菜单项值。 |
| Implemented |
OnClick |
EventCallback |
- |
点击事件。 |
| Implemented |
Disabled (继承) |
bool |
false |
是否禁用。 |
| Implemented |
Id (继承) |
string? |
null |
组件的物理 Id。 |
| Implemented |
Class (继承) |
string? |
null |
自定义 CSS 类名。 |
| Implemented |
Style (继承) |
string? |
null |
自定义样式。 |
| Implemented |
Title (继承) |
string? |
null |
HTML title 属性。 |
| Implemented |
AdditionalAttributes (继承) |
IEnumerable<KeyValuePair<string, object>>? |
null |
捕获不匹配的 HTML 属性。 |
Events (事件)
| 状态 |
事件名 |
类型 |
描述 |
| Implemented |
OnClick |
EventCallback |
点击该项时触发。 |
示例
<SxMenuItem Text="保存" Icon="floppy-disk" Shortcut="Ctrl+S" />
参考设计 (References)