PropertiesMethodsEventsConfig OptionsDirect Link

Class Ext.QuickTips

Defined In: QuickTips.js
Class: Ext.QuickTips
Extends: Object

为所有元素提供有吸引力和可定制的工具提示。QuickTips 是一个单态(singleton)类,被用来为多个元素的提示进行通用地、全局地配置和管理。 想要最大化地定制一个工具提示,你可以考虑使用 Ext.Tip 或者 Ext.ToolTip

Quicktips 对象可以直接通过标签的属性来配置,或者在程序中通过 #register 方法注册提示。

单态的 Ext.QuickTip 对象实例可以通过 #getQuickTip 方法得到,并且提供所有的方法和所有 Ext.QuickTip 对象中的配置属性。 这些设置会被应用于所有显示的工具提示。

下面是可用的配置属性的汇总。详细的说明可以参见 #getQuickTip

QuickTips 单态配置项(所有均为可选项)

  • dismissDelay
  • hideDelay
  • maxWidth
  • minWidth
  • showDelay
  • trackMouse

目标元素配置项(除有说明的均为可选项)

  • autoHide
  • cls
  • dismissDelay (将覆写单态同名选项值)
  • target (必须)
  • text (必须)
  • title
  • width

下面是一个用来说明其中的一些配置选项如何使用的例子:


// 初始化单态类。所有基于标签的提示将开始启用。
Ext.QuickTips.init();

// 应用配置选项到对象上
Ext.apply(Ext.QuickTips.getQuickTip(), {
    maxWidth: 200,
    minWidth: 100,
    showDelay: 50,
    trackMouse: true
});

// 手动注册一个工具提示到指定的元素上
q.register({
    target: 'my-div',
    title: 'My Tooltip',
    text: 'This tooltip was added in code',
    width: 100,
    dismissDelay: 20
});

在标签中注册一个快捷提示,只需要简单地一个或多个有效的 QuickTip 属性并加上 ext: 作为命名空间前缀。 HTML 元素自身将自动地被设置为快捷提示的目标。下面是可用的属性的汇总(除有说明的均为可选项):

下面是一个说明如何通过使用标签在 HTML 元素上显示快捷提示的例子:


// 往一个 HTML 的按钮中添加快捷提示
<input type="button" value="OK" ext:qtitle="OK Button" ext:qwidth="100"
     ext:qtip="This is a quick tip from markup!"></input>

配置项

这个类没有配置项。

公告属性

这个类没有公告属性。

公共方法

方法 定义者

公告事件

这个类没公共的事件。