mirror of
https://github.com/ant-design/ant-design.git
synced 2024-12-22 14:44:47 +08:00
4dbb0075bb
* docs: split shardProps * chore: update english * chore: update style * chore: update snap
2.9 KiB
2.9 KiB
| 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 |
|
何时使用
当目标元素有进一步的描述和相关操作时，可以收纳到卡片中，根据用户的操作行为进行展现。
和 Tooltip 的区别是，用户可以对浮层上的元素进行操作，因此它可以承载更复杂的内容，比如链接或按钮等。
代码演示
基本
三种触发方式
位置
箭头展示
Arrow.pointAtCenter
贴边偏移
从浮层内关闭
悬停点击弹出窗口
_InternalPanelDoNotUseOrYouWillBeFired
线框风格
组件 Token
API
通用属性参考：通用属性
| 参数 | 说明 | 类型 | 默认值 | 版本 |
|---|---|---|---|---|
| content | 卡片内容 | ReactNode | () => ReactNode | - | |
| title | 卡片标题 | ReactNode | () => ReactNode | - |
注意
请确保 Popover 的子元素能接受 onMouseEnter、onMouseLeave、onFocus、onClick 事件。
主题变量（Design Token）
FAQ
为何在严格模式中有时候会出现 findDOMNode is deprecated 这个警告？
这是由于 rc-trigger 的实现方式导致的，rc-trigger 强制要求 children 能够接受 ref，否则就会 fallback 到 findDOMNode，所以 children 需要是原生 html 标签，如果不是，则需要使用 React.forwardRef 把 ref 透传到原生 html 标签。
findDOMNode is deprecated重现：https://codesandbox.io/p/sandbox/finddomnode-c5hy96- 使用
forwardRef消除警告：https://codesandbox.io/p/sandbox/no-finddomnode-warning-forked-gdxczs
为何有时候 HOC 组件无法生效？
请确保 Popover 的子元素能接受 onMouseEnter、onMouseLeave、onPointerEnter、onPointerLeave、onFocus、onClick 事件。
更多问题，请参考 Tooltip FAQ。