| Defined In: | QuickTips.js |
| Class: | Ext.QuickTips |
| Extends: | Object |
为所有元素提供有吸引力和可定制的工具提示。QuickTips 是一个单态(singleton)类,被用来为多个元素的提示进行通用地、全局地配置和管理。 想要最大化地定制一个工具提示,你可以考虑使用 Ext.Tip 或者 Ext.ToolTip。
Quicktips 对象可以直接通过标签的属性来配置,或者在程序中通过 #register 方法注册提示。
单态的 Ext.QuickTip 对象实例可以通过 #getQuickTip 方法得到,并且提供所有的方法和所有 Ext.QuickTip 对象中的配置属性。 这些设置会被应用于所有显示的工具提示。
下面是可用的配置属性的汇总。详细的说明可以参见 #getQuickTip
QuickTips 单态配置项(所有均为可选项)
目标元素配置项(除有说明的均为可选项)
下面是一个用来说明其中的一些配置选项如何使用的例子:
// 初始化单态类。所有基于标签的提示将开始启用。
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>
| 方法 | 定义者 | |
|---|---|---|
|
init
(
)
初始化全局 QuickTips 实例
初始化全局 QuickTips 实例
参数项:
|
QuickTips | |
|
enable
(
)
打开全局快速提示功能.
打开全局快速提示功能.
参数项:
|
QuickTips | |
|
disable
(
)
关闭全局快速提示功能.
关闭全局快速提示功能.
参数项:
|
QuickTips | |
|
isEnabled
(
)
: Boolean
获取一个值,该值指示此quick tips是否可以对用户交互作出响应。
获取一个值,该值指示此quick tips是否可以对用户交互作出响应。
参数项:
|
QuickTips | |
|
getQuickTip
(
)
获得全局QuickTips实例.
获得全局QuickTips实例.
参数项:
|
QuickTips | |
register
(
Object config
)
配置一个新的quick tip实例并将其分配到一个目标元素. 详细...
配置一个新的quick tip实例并将其分配到一个目标元素. 详细信息请查看
Ext.QuickTip#register.
参数项:
|
QuickTips | |
unregister
(
String/HTMLElement/Element el
)
从目标元素中移除并销毁所有已注册的quick tip
从目标元素中移除并销毁所有已注册的quick tip
参数项:
|
QuickTips | |
tips
(
Object config
)
#register的别名.
#register的别名.
参数项:
|
QuickTips | |