用户悬停或聚焦元素时显示的简短描述。对齐 Microsoft Fluent UI Blazor Tooltip (v4.13.2) 的 API 结构,并说明 NextUI 当前实现状态。
使用场景
约束说明
ChildContent 作为触发元素。
Disabled 为 true 时不显示提示。
行为说明
Delay 控制显示延迟。
Position 控制提示位置。
API
Parameters
| 状态 |
参数名 |
类型 |
默认值 |
描述 |
| Implemented |
Content |
string |
"" |
提示文案。 |
| Implemented |
Position |
TooltipPosition |
Top |
显示位置。 |
| Implemented |
Delay |
int |
300 |
延迟时间 (ms)。 |
| Implemented |
ChildContent |
RenderFragment? |
null |
触发元素内容。 |
| 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 |
OnTooltipOpened |
EventCallback |
显示时触发。 |
| Implemented |
OnTooltipClosed |
EventCallback |
隐藏时触发。 |
示例
<SxTooltip Content="这是一段提示信息">
<SxButton>悬停查看提示</SxButton>
</SxTooltip>
参考设计 (References)