ant-design/components/tooltip/index.zh-CN.md

---
category: Components
subtitle: 文字提示
type: Data Display
title: Tooltip
---

简单的文字提示气泡框。

## 何时使用

鼠标移入则显示提示，移出消失，气泡浮层不承载复杂文本和操作。

可用来代替系统默认的 `title` 提示，提供一个`按钮/文字/操作`的文案解释。

## API

| 参数      | 说明                                     | 类型       | 默认值 |
|-----------|------------------------------------------|------------|--------|
| placement | 气泡框位置，可选 `top` `left` `right` `bottom` `topLeft` `topRight` `bottomLeft` `bottomRight` `leftTop` `leftBottom` `rightTop` `rightBottom` | string     | top    |
| title     | 提示文字                                 | string/React.Element | 无     |
| getTooltipContainer | 浮层渲染父节点。默认渲染到 body 上 | Function(triggerNode) | () => document.body |
| arrowPointAtCenter | 箭头是否指向目标元素中心，`antd@1.11+` 支持 | Boolean | `false` |

更多 API 可参考：https://github.com/react-component/tooltip
-												docs: update documentation format

											
										
										
											2016-03-31 14:17:09 +08:00
+								---
 								category: Components
-												docs: update docs details

											
										
										
											2016-09-21 11:28:38 +08:00
+								subtitle: 文字提示
-												docs: 调整组件导航结构 (#3758)

- Layout 更名为 Grid
											
										
										
											2016-11-09 14:43:32 +08:00
+								type: Data Display
-												docs: update docs details

											
										
										
											2016-09-21 11:28:38 +08:00
+								title: Tooltip
-												docs: update documentation format

											
										
										
											2016-03-31 14:17:09 +08:00
+								---
-												挖坑

											
										
										
											2015-05-27 15:43:29 +08:00
-												Add Tooltip

											
										
										
											2015-06-03 17:08:43 +08:00
+								简单的文字提示气泡框。
-												挖坑

											
										
										
											2015-05-27 15:43:29 +08:00
-												Add Tooltip

											
										
										
											2015-06-03 17:08:43 +08:00
+								## 何时使用
-												挖坑

											
										
										
											2015-05-27 15:43:29 +08:00
-												update index.md

											
										
										
											2015-06-03 17:48:52 +08:00
+								鼠标移入则显示提示，移出消失，气泡浮层不承载复杂文本和操作。
-												update popover and tooltip readme

											
										
										
											2015-06-17 17:10:10 +08:00
+								可用来代替系统默认的 `title` 提示，提供一个`按钮/文字/操作`的文案解释。
-												tooltip API

											
										
										
											2015-06-03 17:52:44 +08:00
 								## API
 								| 参数      | 说明                                     | 类型       | 默认值 |
 								|-----------|------------------------------------------|------------|--------|
-												update tooltip demo

											
										
										
											2016-01-30 02:02:03 +08:00
+								| placement | 气泡框位置，可选 `top` `left` `right` `bottom` `topLeft` `topRight` `bottomLeft` `bottomRight` `leftTop` `leftBottom` `rightTop` `rightBottom` | string     | top    |
 								| title     | 提示文字                                 | string/React.Element | 无     |
-												update tooltip doc for #1871

											
										
										
											2016-05-27 14:11:35 +08:00
+								| getTooltipContainer | 浮层渲染父节点。默认渲染到 body 上 | Function(triggerNode) | () => document.body |
-												Add arrowPointAtCenter to Tooltip Popover Popconfirm

修正默认对齐方式为边缘对齐，增加属性用于箭头指向中心的行为

											
										
										
											2016-08-31 13:50:50 +08:00
+								| arrowPointAtCenter | 箭头是否指向目标元素中心，`antd@1.11+` 支持 | Boolean | `false` |
-												update tooltip doc for #1871

											
										
										
											2016-05-27 14:17:20 +08:00
 								更多 API 可参考：https://github.com/react-component/tooltip