SxPopover (弹出框)

  • Implemented

比 Tooltip 更通用的弹出层容器。对齐 Microsoft Fluent UI Blazor Popover (v4.13.2) 的 API 结构,并说明 NextUI 当前实现状态。

使用场景

  • 点击触发的提示与说明
  • 操作菜单或二级内容
  • 表单中的辅助说明

约束说明

  • TriggerContent 为空时需自行控制 Open
  • 位置根据 Position 简单定位。

行为说明

  • 点击触发器切换 Open
  • OpenChanged 回调同步状态。

API

Parameters (参数)

状态 参数名 类型 默认值 描述
Implemented TriggerContent RenderFragment? null 触发器内容。
Implemented ChildContent RenderFragment? null 弹出内容。
Implemented Open bool false 打开状态。
Implemented Position TooltipPosition Bottom 弹出位置。
Implemented AnchorId string? null 锚定目标 Id。
Implemented OpenChanged EventCallback<bool> - 打开状态回调。
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 额外属性。

Events (事件)

状态 事件名 类型 描述
Implemented OpenChanged EventCallback<bool> 打开状态改变时触发。

Methods (方法)

方法名 返回类型 描述
TogglePopover() Task 切换弹出框的显示状态。
OpenPopover() Task 打开弹出框。
ClosePopover() Task 关闭弹出框。

示例

<SxPopover>
    <TriggerContent>
        <SxButton>点击弹出</SxButton>
    </TriggerContent>
    <ChildContent>
        <div>弹出内容</div>
    </ChildContent>
</SxPopover>

参考设计 (References)