SxTag (标签)
- Implemented
用于分类、标记或展示元数据。对齐 Microsoft Fluent UI Blazor Badge/Tag 风格 (v4.13.2) 的 API 结构，并说明 NextUI 当前实现状态。
使用场景
- 状态标签与分类标识
- 元数据展示
- 列表/卡片的属性提示
约束说明
Text与ChildContent同时存在时优先显示ChildContent。Icon为空时不渲染图标。
行为说明
Appearance控制标签风格色彩。Shape控制标签外形。
API
Parameters (参数)
| 状态 | 参数名 | 类型 | 默认值 | 描述 |
|---|---|---|---|---|
| Implemented | Text |
string? |
null |
标签文本。 |
| Implemented | ChildContent |
RenderFragment? |
null |
自定义内容。 |
| Implemented | Appearance |
TagAppearance |
Neutral |
标签风格。 |
| Implemented | Shape |
TagShape |
Rounded |
标签形状。 |
| Implemented | Icon |
string? |
null |
图标名称。 |
| Implemented | IconStyle |
IconStyle |
Regular |
图标风格。 |
| 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 属性。 |
示例
<SxTag Text="Label" Appearance="TagAppearance.Brand" />
<SxTag Icon="tag" Shape="TagShape.Capsule">Hot</SxTag>