ant-design/components/popover/index.zh-CN.md
𝑾𝒖𝒙𝒉 4dbb0075bb
docs(shared): Improve shared API docs ()
* docs: split shardProps

* chore: update english

* chore: update style

* chore: update snap
2024-12-02 23:03:44 +08:00

2.9 KiB
Raw Blame History

category group title subtitle description cover coverDark demo
Components 数据展示 Popover 气泡卡片 点击/鼠标移入元素,弹出气泡式的卡片浮层。 https://mdn.alipayobjects.com/huamei_7uahnr/afts/img/A*kfW5RrfF4L8AAAAAAAAAAAAADrJ8AQ/original https://mdn.alipayobjects.com/huamei_7uahnr/afts/img/A*6b8fSKVVtXIAAAAAAAAAAAAADrJ8AQ/original
cols
2

何时使用

当目标元素有进一步的描述和相关操作时,可以收纳到卡片中,根据用户的操作行为进行展现。

Tooltip 的区别是,用户可以对浮层上的元素进行操作,因此它可以承载更复杂的内容,比如链接或按钮等。

代码演示

基本 三种触发方式 位置 箭头展示 Arrow.pointAtCenter 贴边偏移 从浮层内关闭 悬停点击弹出窗口 _InternalPanelDoNotUseOrYouWillBeFired 线框风格 组件 Token

API

通用属性参考:通用属性

参数 说明 类型 默认值 版本
content 卡片内容 ReactNode | () => ReactNode -
title 卡片标题 ReactNode | () => ReactNode -

注意

请确保 Popover 的子元素能接受 onMouseEnteronMouseLeaveonFocusonClick 事件。

主题变量Design Token

FAQ

为何在严格模式中有时候会出现 findDOMNode is deprecated 这个警告?

这是由于 rc-trigger 的实现方式导致的,rc-trigger 强制要求 children 能够接受 ref否则就会 fallback 到 findDOMNode所以 children 需要是原生 html 标签,如果不是,则需要使用 React.forwardRefref 透传到原生 html 标签。

为何有时候 HOC 组件无法生效?

请确保 Popover 的子元素能接受 onMouseEnteronMouseLeaveonPointerEnteronPointerLeaveonFocusonClick 事件。

更多问题,请参考 Tooltip FAQ