mirror of
https://github.com/ant-design/ant-design.git
synced 2024-12-30 04:18:28 +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。