> ## Documentation Index
> Fetch the complete documentation index at: https://help.dingtalk.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Balloon 气泡提示

> Balloon 气泡提示组件使用文档，包含使用场景、属性配置与示例，为页面元素提供跟随交互出现的轻量辅助提示。

## 何时使用

* 当用户与被说明对象（文字，图片，输入框等）发生交互行为的 action 开始时, 即刻跟随动作出现一种辅助或帮助的提示信息。

## 组件示例

<iframe src="https://www.aliwork.com/developer/balloon-v2?isRenderNav=false" width="100%" height="480" frameBorder="0" />

## 组件属性

| 属性                      | 说明                                  | 类型                                                                                         | 默认值              |
| ----------------------- | ----------------------------------- | ------------------------------------------------------------------------------------------ | ---------------- |
| `TYPE`                  | 设置气泡类型，当气泡类型选择为 **tooltip** 时直接展示文字 | `'balloon' \| 'tooltip'`                                                                   | `'balloon'`      |
| `afterClose`            | Balloon 浮层关闭后触发的事件, 如果有动画，则在动画结束后触发 | `() => void`                                                                               | -                |
| `align`                 | 气泡弹出层的显示位置                          | `'t' \| 'b' \| 'l' \| 'r' \| 'tl' \| 'tr' \| 'bl' \| 'br' \| 'lt' \| 'lb' \| 'rt' \| 'rb'` | `'b'`            |
| `balloonOverlayVisible` | 设计器中是否显示弹层，该配置项只在设计器中有效             | `boolean`                                                                                  | `true`           |
| `closable`              | 是否显示关闭按钮                            | `boolean`                                                                                  | `true`           |
| `content`               | 气泡组件显示内容                            | `string`                                                                                   | `'提示内容'`         |
| `defaultVisible`        | 组件初始化时是否为显示状态                       | `boolean`                                                                                  | `false`          |
| `delay`                 | 时气泡显示的延迟时间，仅触发行为为hover时生效，单位为ms     | `number`                                                                                   | `0`              |
| `display`               | 用于配置触发元素所占空间                        | `'inline-block' \| 'block'`                                                                | `'inline-block'` |
| `onClose`               | Balloon 浮层关闭时触发的事件                  | `() => void`                                                                               | -                |
| `onVisibleChange`       | Balloon 浮层关闭后触发的事件, 如果有动画，则在动画结束后触发 | `(visible: boolean) => void`                                                               | -                |
| `overlayMaxWidth`       | 用于控制浮层最大宽度，\*\*'initial'\*\*表示不限制宽度 | `string`                                                                                   | `'300px'`        |
| `triggerType`           | 用于控制气泡组件的触发条件                       | `'hover' \| 'click' \| 'focus'`                                                            | `'click'`        |
| `type`                  | 气泡的样式类型                             | `'normal' \| 'primary'`                                                                    | `'normal'`       |