---
title: "Ext.tip.ToolTip"
description: "xtype 为 tooltip 的 Ext JS 原生组件参考。"
---

> Documentation Index
> Fetch the complete documentation index at: https://ag.879818327.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Ext.tip.ToolTip

源码定义：`ext-all-debug.js:58772`。分类：基础组件与提示。

## 创建示例

```javascript
var component = Ext.create("Ext.tip.ToolTip", {
  xtype: "tooltip",
  _timerNames: {},
  anchorOffset: 0,
  anchorToTarget: true,
  ariaRole: 'tooltip',
  renderTo: Ext.getBody()
});
```

## 属性

| 属性 | 类型 | 默认值 | 说明 | 配置示例 |
| --- | --- | --- | --- | --- |
| `_timerNames` | `Object` | `{}` | 配置组件的 `_timerNames` 选项。 | `_timerNames: {}` |
| `anchorOffset` | `Number` | `0` | 配置组件的 `anchorOffset` 选项。 | `anchorOffset: 0` |
| `anchorToTarget` | `Boolean` | `true` | 控制是否启用 `anchorToTarget` 行为。 | `anchorToTarget: true` |
| `ariaRole` | `String` | `'tooltip'` | 组件在辅助技术中的 ARIA 角色。 | `ariaRole: 'tooltip'` |
| `autoHide` | `Boolean` | `true` | 控制是否启用 `autoHide` 行为。 | `autoHide: true` |
| `dismissDelay` | `Number` | `5000` | 配置组件的 `dismissDelay` 选项。 | `dismissDelay: 5000` |
| `hideDelay` | `Number` | `200` | 配置组件的 `hideDelay` 选项。 | `hideDelay: 200` |
| `quickShowInterval` | `Number` | `250` | 配置组件的 `quickShowInterval` 选项。 | `quickShowInterval: 250` |
| `showDelay` | `Number` | `500` | 配置组件的 `showDelay` 选项。 | `showDelay: 500` |
| `stayOnTop` | `Boolean` | `true` | 控制是否启用 `stayOnTop` 行为。 | `stayOnTop: true` |
| `targetCounter` | `Number` | `0` | 配置组件的 `targetCounter` 选项。 | `targetCounter: 0` |
| `trackMouse` | `Boolean` | `false` | 控制是否启用 `trackMouse` 行为。 | `trackMouse: false` |

## 方法

| 方法 | 参数 | 说明 | 调用示例 |
| --- | --- | --- | --- |
| `initComponent` | `` | 初始化组件及其子项。 执行时会保留父类默认行为、更新 `lastActive`、`origAnchor` 状态。源码涉及 `callParent()`、`setTarget()`。 | `component.initComponent()` |
| `onRender` | `ct, position` | 生成 `on` 的渲染结果。 执行时会保留父类默认行为、更新 `anchorCls`、`anchorEl` 状态。源码涉及 `callParent()`、`getAnchorPosition()`。 | `component.onRender(...)` |
| `setTarget` | `target` | 设置 `target`。 执行时会更新 `target`、`anchorTarget` 状态。源码涉及 `mun()`、`mon()`。 | `component.setTarget(...)` |
| `onMouseMove` | `e` | 处理 `mouseMove` 回调。 执行时会更新 `triggerElement`、`targetXY` 状态。源码涉及 `getTargetXY()`、`setPagePosition()`、`hide()`、`onTargetOver()`。 | `component.onMouseMove(...)` |
| `getTargetXY` | `` | 读取并返回 `targetXY`。 执行时会更新 `anchorTarget`、`defaultAlign` 状态。源码涉及 `getOffsets()`、`getAlignToXY()`、`getAnchorAlign()`、`getSize()`。 | `component.getTargetXY()` |
| `getMouseOffset` | `` | 读取并返回 `mouseOffset`。 | `component.getMouseOffset()` |
| `getAnchorPosition` | `` | 读取并返回 `anchorPosition`。 执行时会更新 `tipAnchor` 状态。 | `component.getAnchorPosition()` |
| `getAnchorAlign` | `` | 读取并返回 `anchorAlign`。 | `component.getAnchorAlign()` |
| `getOffsets` | `` | 读取并返回 `offsets`。源码涉及 `getAnchorPosition()`、`getMouseOffset()`。 | `component.getOffsets()` |
| `onTargetOver` | `e` | 处理 `targetOver` 回调。 执行时会更新 `triggerElement`、`triggerEvent` 状态。源码涉及 `clearTimer()`、`delayShow()`。 | `component.onTargetOver(...)` |
| `delayShow` | `trackMouse` | 处理 `delayShow` 操作。 执行时会更新 `showTimer` 状态。源码涉及 `getTargetXY()`、`show()`。 | `component.delayShow(...)` |
| `showFromDelay` | `xy` | 显示 `fromDelay`。 执行时会更新 `fromDelayShow` 状态。源码涉及 `show()`。 | `component.showFromDelay(...)` |
| `onShowVeto` | `` | 处理 `showVeto` 回调。 执行时会保留父类默认行为。源码涉及 `callParent()`、`clearTimer()`。 | `component.onShowVeto()` |
| `onTargetOut` | `e` | 处理 `targetOut` 回调。 执行时会更新 `triggerElement` 状态。源码涉及 `clearTimer()`、`delayHide()`。 | `component.onTargetOut(...)` |
| `delayHide` | `` | 处理 `delayHide` 操作。 执行时会更新 `hideTimer` 状态。 | `component.delayHide()` |
| `hide` | `` | 隐藏组件。 执行时会保留父类默认行为、更新 `lastActive` 状态。源码涉及 `clearTimer()`、`callParent()`。 | `component.hide()` |
| `show` | `xy` | 显示组件。 执行时会保留父类默认行为、同步关联状态、更新 `anchor` 状态。源码涉及 `callParent()`、`setPagePosition()`、`showAt()`、`getTargetXY()`。 | `component.show(...)` |
| `showAt` | `xy` | 显示 `at`。 执行时会保留父类默认行为、同步关联状态、更新 `lastActive`、`calledFromShowAt` 状态。源码涉及 `clearTimers()`、`isVisible()`、`callParent()`、`setPagePosition()`。 | `component.showAt(...)` |
| `syncAnchor` | `` | 同步 `anchor`。 | `component.syncAnchor()` |
| `setPagePosition` | `x, y` | 设置 `pagePosition`。 执行时会保留父类默认行为、同步关联状态。源码涉及 `callParent()`、`syncAnchor()`。 | `component.setPagePosition(...)` |
| `clearTimer` | `name` | 清空 `timer`。 | `component.clearTimer(...)` |
| `clearTimers` | `` | 清空 `timers`。源码涉及 `clearTimer()`。 | `component.clearTimers()` |
| `onShow` | `` | 处理 `show` 回调。 执行时会保留父类默认行为。源码涉及 `callParent()`、`mon()`。 | `component.onShow()` |
| `onHide` | `` | 处理 `hide` 回调。 执行时会保留父类默认行为。源码涉及 `callParent()`、`mun()`。 | `component.onHide()` |
| `onDocMouseDown` | `e` | 处理 `docMouseDown` 回调。源码涉及 `disable()`。 | `component.onDocMouseDown(...)` |
| `doEnable` | `` | 执行 `enable` 操作。源码涉及 `enable()`。 | `component.doEnable()` |
| `onDisable` | `` | 处理 `disable` 回调。 执行时会保留父类默认行为。源码涉及 `callParent()`、`clearTimers()`、`hide()`。 | `component.onDisable()` |
| `beforeDestroy` | `` | 在 `destroy` 前执行预处理。 执行时会保留父类默认行为。源码涉及 `clearTimers()`、`callParent()`。 | `component.beforeDestroy()` |
| `onDestroy` | `` | 处理 `destroy` 回调。 执行时会保留父类默认行为。源码涉及 `callParent()`。 | `component.onDestroy()` |

## 事件

源码中未找到该组件自身注册的事件；可监听继承事件。

Source: https://ag.879818327.xyz/ext/basic/tip-tooltip/index.mdx