X-Git-Url: http://git.ithinksw.org/extjs.git/blobdiff_plain/c930e9176a5a85509c5b0230e2bff5c22a591432..92c2b89db26be16707f4a805d3303ab2531006e1:/src/widgets/tips/ToolTip.js?ds=inline
diff --git a/src/widgets/tips/ToolTip.js b/src/widgets/tips/ToolTip.js
index f9965b9d..f2cc656e 100644
--- a/src/widgets/tips/ToolTip.js
+++ b/src/widgets/tips/ToolTip.js
@@ -1,6 +1,6 @@
/*!
- * Ext JS Library 3.0.0
- * Copyright(c) 2006-2009 Ext JS, LLC
+ * Ext JS Library 3.1.1
+ * Copyright(c) 2006-2010 Ext JS, LLC
* licensing@extjs.com
* http://www.extjs.com/license
*/
@@ -8,69 +8,85 @@
* @class Ext.ToolTip
* @extends Ext.Tip
* A standard tooltip implementation for providing additional information when hovering over a target element.
+ * @xtype tooltip
* @constructor
* Create a new Tooltip
* @param {Object} config The configuration options
*/
Ext.ToolTip = Ext.extend(Ext.Tip, {
/**
- * When a Tooltip is configured with the {@link #delegate} option to cause selected child elements of the {@link #target}
- * Element to each trigger a seperate show event, this property is set to the DOM element which triggered the show.
+ * When a Tooltip is configured with the {@link #delegate}
+ * option to cause selected child elements of the {@link #target}
+ * Element to each trigger a seperate show event, this property is set to
+ * the DOM element which triggered the show.
* @type DOMElement
* @property triggerElement
*/
/**
- * @cfg {Mixed} target The target HTMLElement, Ext.Element or id to monitor for mouseover events to trigger
- * showing this ToolTip.
+ * @cfg {Mixed} target The target HTMLElement, Ext.Element or id to monitor
+ * for mouseover events to trigger showing this ToolTip.
*/
/**
- * @cfg {Boolean} autoHide True to automatically hide the tooltip after the mouse exits the target element
- * or after the {@link #dismissDelay} has expired if set (defaults to true). If {@link closable} = true a close
- * tool button will be rendered into the tooltip header.
+ * @cfg {Boolean} autoHide True to automatically hide the tooltip after the
+ * mouse exits the target element or after the {@link #dismissDelay}
+ * has expired if set (defaults to true). If {@link closable} = true
+ * a close tool button will be rendered into the tooltip header.
*/
/**
- * @cfg {Number} showDelay Delay in milliseconds before the tooltip displays after the mouse enters the
- * target element (defaults to 500)
+ * @cfg {Number} showDelay Delay in milliseconds before the tooltip displays
+ * after the mouse enters the target element (defaults to 500)
*/
- showDelay: 500,
+ showDelay : 500,
/**
- * @cfg {Number} hideDelay Delay in milliseconds after the mouse exits the target element but before the
- * tooltip actually hides (defaults to 200). Set to 0 for the tooltip to hide immediately.
+ * @cfg {Number} hideDelay Delay in milliseconds after the mouse exits the
+ * target element but before the tooltip actually hides (defaults to 200).
+ * Set to 0 for the tooltip to hide immediately.
*/
- hideDelay: 200,
+ hideDelay : 200,
/**
- * @cfg {Number} dismissDelay Delay in milliseconds before the tooltip automatically hides (defaults to 5000).
- * To disable automatic hiding, set dismissDelay = 0.
+ * @cfg {Number} dismissDelay Delay in milliseconds before the tooltip
+ * automatically hides (defaults to 5000). To disable automatic hiding, set
+ * dismissDelay = 0.
*/
- dismissDelay: 5000,
+ dismissDelay : 5000,
/**
- * @cfg {Array} mouseOffset An XY offset from the mouse position where the tooltip should be shown (defaults to [15,18]).
+ * @cfg {Array} mouseOffset An XY offset from the mouse position where the
+ * tooltip should be shown (defaults to [15,18]).
*/
/**
- * @cfg {Boolean} trackMouse True to have the tooltip follow the mouse as it moves over the target element (defaults to false).
+ * @cfg {Boolean} trackMouse True to have the tooltip follow the mouse as it
+ * moves over the target element (defaults to false).
*/
trackMouse : false,
/**
- * @cfg {Boolean} anchorToTarget True to anchor the tooltip to the target element, false to
- * anchor it relative to the mouse coordinates (defaults to true). When anchorToTarget is
- * true, use {@link #defaultAlign} to control tooltip alignment to the target element. When
- * anchorToTarget is false, use {@link #anchorPosition} instead to control alignment.
+ * @cfg {Boolean} anchorToTarget True to anchor the tooltip to the target
+ * element, false to anchor it relative to the mouse coordinates (defaults
+ * to true). When anchorToTarget
is true, use
+ * {@link #defaultAlign}
to control tooltip alignment to the
+ * target element. When anchorToTarget
is false, use
+ * {@link #anchorPosition}
instead to control alignment.
*/
- anchorToTarget: true,
+ anchorToTarget : true,
/**
- * @cfg {Number} anchorOffset A numeric pixel value used to offset the default position of the
- * anchor arrow (defaults to 0). When the anchor position is on the top or bottom of the tooltip,
- * anchorOffset will be used as a horizontal offset. Likewise, when the anchor position is on the
- * left or right side, anchorOffset will be used as a vertical offset.
+ * @cfg {Number} anchorOffset A numeric pixel value used to offset the
+ * default position of the anchor arrow (defaults to 0). When the anchor
+ * position is on the top or bottom of the tooltip, anchorOffset
+ * will be used as a horizontal offset. Likewise, when the anchor position
+ * is on the left or right side, anchorOffset
will be used as
+ * a vertical offset.
*/
- anchorOffset: 0,
+ anchorOffset : 0,
/**
- * @cfg {String} delegate
Optional. A {@link Ext.DomQuery DomQuery} selector which allows selection of individual elements - * within the {@link #target} element to trigger showing and hiding the ToolTip as the mouse moves within the target.
- *When specified, the child element of the target which caused a show event is placed into the {@link #triggerElement} property + * @cfg {String} delegate
Optional. A {@link Ext.DomQuery DomQuery}
+ * selector which allows selection of individual elements within the
+ * {@link #target}
element to trigger showing and hiding the
+ * ToolTip as the mouse moves within the target.
When specified, the child element of the target which caused a show
+ * event is placed into the {@link #triggerElement}
property
* before the ToolTip is shown.
This may be useful when a Component has regular, repeating elements in it, each of which need a Tooltip which contains - * information specific to that element. For example:
+ * This may be useful when a Component has regular, repeating elements
+ * in it, each of which need a Tooltip which contains information specific
+ * to that element. For example:
var myGrid = new Ext.grid.gridPanel(gridConfig);
myGrid.on('render', function(grid) {
var store = grid.getStore(); // Capture the Store.
@@ -79,24 +95,27 @@ myGrid.on('render', function(grid) {
target: view.mainBody, // The overall target element.
delegate: '.x-grid3-row', // Each grid row causes its own seperate show and hide.
trackMouse: true, // Moving within the row should not hide the tip.
- renderTo: document.body, // Render immediately so that tip.body can be referenced prior to the first show.
- listeners: { // Change content dynamically depending on which element triggered the show.
+ renderTo: document.body, // Render immediately so that tip.body can be
+ // referenced prior to the first show.
+ listeners: { // Change content dynamically depending on which element
+ // triggered the show.
beforeshow: function updateTipBody(tip) {
var rowIndex = view.findRowIndex(tip.triggerElement);
- tip.body.dom.innerHTML = "Over Record ID " + store.getAt(rowIndex).id;
+ tip.body.dom.innerHTML = 'Over Record ID ' + store.getAt(rowIndex).id;
}
}
});
-});
+});
+ *
*/
// private
- targetCounter: 0,
+ targetCounter : 0,
- constrainPosition: false,
+ constrainPosition : false,
// private
- initComponent: function(){
+ initComponent : function(){
Ext.ToolTip.superclass.initComponent.call(this);
this.lastActive = new Date();
this.initTarget(this.target);
@@ -126,10 +145,10 @@ myGrid.on('render', function(grid) {
var t;
if((t = Ext.get(target))){
if(this.target){
- this.target = Ext.get(this.target);
- this.target.un('mouseover', this.onTargetOver, this);
- this.target.un('mouseout', this.onTargetOut, this);
- this.target.un('mousemove', this.onMouseMove, this);
+ var tg = Ext.get(this.target);
+ this.mun(tg, 'mouseover', this.onTargetOver, this);
+ this.mun(tg, 'mouseout', this.onTargetOut, this);
+ this.mun(tg, 'mousemove', this.onMouseMove, this);
}
this.mon(t, {
mouseover: this.onTargetOver,
@@ -165,20 +184,22 @@ myGrid.on('render', function(grid) {
// private
getTargetXY : function(){
+ if(this.delegate){
+ this.anchorTarget = this.triggerElement;
+ }
if(this.anchor){
this.targetCounter++;
- var offsets = this.getOffsets();
- var xy = (this.anchorToTarget && !this.trackMouse) ?
- this.el.getAlignToXY(this.anchorTarget, this.getAnchorAlign()) :
- this.targetXY;
-
- var dw = Ext.lib.Dom.getViewWidth()-5;
- var dh = Ext.lib.Dom.getViewHeight()-5;
- var scrollX = (document.documentElement.scrollLeft || document.body.scrollLeft || 0)+5;
- var scrollY = (document.documentElement.scrollTop || document.body.scrollTop || 0)+5;
-
- var axy = [xy[0] + offsets[0], xy[1] + offsets[1]];
- var sz = this.getSize();
+ var offsets = this.getOffsets(),
+ xy = (this.anchorToTarget && !this.trackMouse) ? this.el.getAlignToXY(this.anchorTarget, this.getAnchorAlign()) : this.targetXY,
+ dw = Ext.lib.Dom.getViewWidth() - 5,
+ dh = Ext.lib.Dom.getViewHeight() - 5,
+ de = document.documentElement,
+ bd = document.body,
+ scrollX = (de.scrollLeft || bd.scrollLeft || 0) + 5,
+ scrollY = (de.scrollTop || bd.scrollTop || 0) + 5,
+ axy = [xy[0] + offsets[0], xy[1] + offsets[1]],
+ sz = this.getSize();
+
this.anchorEl.removeClass(this.anchorCls);
if(this.targetCounter < 2){
@@ -242,7 +263,7 @@ myGrid.on('render', function(grid) {
}else{
var m = this.defaultAlign.match(/^([a-z]+)-([a-z]+)(\?)?$/);
if(!m){
- throw "AnchorTip.defaultAlign is invalid";
+ throw 'AnchorTip.defaultAlign is invalid';
}
this.tipAnchor = m[1].charAt(0);
}
@@ -266,8 +287,9 @@ myGrid.on('render', function(grid) {
},
// private
- getOffsets: function(){
- var offsets, ap = this.getAnchorPosition().charAt(0);
+ getOffsets : function(){
+ var offsets,
+ ap = this.getAnchorPosition().charAt(0);
if(this.anchorToTarget && !this.trackMouse){
switch(ap){
case 't':
@@ -395,6 +417,10 @@ myGrid.on('render', function(grid) {
if(this.dismissDelay && this.autoHide !== false){
this.dismissTimer = this.hide.defer(this.dismissDelay, this);
}
+ if(this.anchor && !this.anchorEl.isVisible()){
+ this.syncAnchor();
+ this.anchorEl.show();
+ }
},
// private
@@ -483,10 +509,22 @@ myGrid.on('render', function(grid) {
}
return {x : x, y: y};
},
+
+ beforeDestroy : function(){
+ this.clearTimers();
+ Ext.destroy(this.anchorEl);
+ delete this.anchorEl;
+ delete this.target;
+ delete this.anchorTarget;
+ delete this.triggerElement;
+ Ext.ToolTip.superclass.beforeDestroy.call(this);
+ },
// private
onDestroy : function(){
Ext.getDoc().un('mousedown', this.onDocMouseDown, this);
Ext.ToolTip.superclass.onDestroy.call(this);
}
-});
\ No newline at end of file
+});
+
+Ext.reg('tooltip', Ext.ToolTip);
\ No newline at end of file