SxTooltip (文字提示)

  • Implemented

用户悬停或聚焦元素时显示的简短描述。对齐 Microsoft Fluent UI Blazor Tooltip (v4.13.2) 的 API 结构,并说明 NextUI 当前实现状态。

使用场景

  • 按钮/图标补充说明
  • 表单字段解释
  • 状态提示

约束说明

  • ChildContent 作为触发元素。
  • Disabledtrue 时不显示提示。

行为说明

  • 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)