Upgrade to ExtJS 4.0.1 - Released 05/18/2011
[extjs.git] / docs / source / ToolTip.html
index 664f0e8..7d6c7fa 100644 (file)
+<!DOCTYPE html>
 <html>
 <head>
-  <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />    
+  <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
   <title>The source code</title>
-    <link href="../resources/prettify/prettify.css" type="text/css" rel="stylesheet" />
-    <script type="text/javascript" src="../resources/prettify/prettify.js"></script>
+  <link href="../prettify/prettify.css" type="text/css" rel="stylesheet" />
+  <script type="text/javascript" src="../prettify/prettify.js"></script>
+  <style type="text/css">
+    .highlight { display: block; background-color: #ddd; }
+  </style>
+  <script type="text/javascript">
+    function highlight() {
+      document.getElementById(location.hash.replace(/#/, "")).className = "highlight";
+    }
+  </script>
 </head>
-<body  onload="prettyPrint();">
-    <pre class="prettyprint lang-js">/*!
- * Ext JS Library 3.3.1
- * Copyright(c) 2006-2010 Sencha Inc.
- * licensing@sencha.com
- * http://www.sencha.com/license
- */
-<div id="cls-Ext.ToolTip"></div>/**
- * @class Ext.ToolTip
- * @extends Ext.Tip
- * A standard tooltip implementation for providing additional information when hovering over a target element.
- * @xtype tooltip
+<body onload="prettyPrint(); highlight();">
+  <pre class="prettyprint lang-js"><span id='Ext-tip-ToolTip-method-constructor'><span id='Ext-tip-ToolTip'>/**
+</span></span> * @class Ext.tip.ToolTip
+ * @extends Ext.tip.Tip
+ * 
+ * ToolTip is a {@link Ext.tip.Tip} implementation that handles the common case of displaying a
+ * tooltip when hovering over a certain element or elements on the page. It allows fine-grained
+ * control over the tooltip's alignment relative to the target element or mouse, and the timing
+ * of when it is automatically shown and hidden.
+ * 
+ * This implementation does **not** have a built-in method of automatically populating the tooltip's
+ * text based on the target element; you must either configure a fixed {@link #html} value for each
+ * ToolTip instance, or implement custom logic (e.g. in a {@link #beforeshow} event listener) to
+ * generate the appropriate tooltip content on the fly. See {@link Ext.tip.QuickTip} for a more
+ * convenient way of automatically populating and configuring a tooltip based on specific DOM
+ * attributes of each target element.
+ * 
+ * ## Basic Example
+ * 
+ *     var tip = Ext.create('Ext.tip.ToolTip', {
+ *         target: 'clearButton',
+ *         html: 'Press this button to clear the form'
+ *     });
+ * 
+ * {@img Ext.tip.ToolTip/Ext.tip.ToolTip1.png Basic Ext.tip.ToolTip}
+ * 
+ * ## Delegation
+ * 
+ * In addition to attaching a ToolTip to a single element, you can also use delegation to attach
+ * one ToolTip to many elements under a common parent. This is more efficient than creating many
+ * ToolTip instances. To do this, point the {@link #target} config to a common ancestor of all the
+ * elements, and then set the {@link #delegate} config to a CSS selector that will select all the
+ * appropriate sub-elements.
+ * 
+ * When using delegation, it is likely that you will want to programmatically change the content
+ * of the ToolTip based on each delegate element; you can do this by implementing a custom
+ * listener for the {@link #beforeshow} event. Example:
+ * 
+ *     var myGrid = Ext.create('Ext.grid.GridPanel', gridConfig);
+ *     myGrid.on('render', function(grid) {
+ *         var view = grid.getView();    // Capture the grid's view.
+ *         grid.tip = Ext.create('Ext.tip.ToolTip', {
+ *             target: view.el,          // The overall target element.
+ *             delegate: view.itemSelector, // Each grid row causes its own seperate show and hide.
+ *             trackMouse: true,         // Moving within the row should not hide the tip.
+ *             renderTo: Ext.getBody(),  // 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) {
+ *                     tip.update('Over company &quot;' + view.getRecord(tip.triggerElement).get('company') + '&quot;');
+ *                 }
+ *             }
+ *         });
+ *     });
+ * 
+ * {@img Ext.tip.ToolTip/Ext.tip.ToolTip2.png Ext.tip.ToolTip with delegation}
+ * 
+ * ## Alignment
+ * 
+ * The following configuration properties allow control over how the ToolTip is aligned relative to
+ * the target element and/or mouse pointer:
+ * 
+ *  - {@link #anchor}
+ *  - {@link #anchorToTarget}
+ *  - {@link #anchorOffset}
+ *  - {@link #trackMouse}
+ *  - {@link #mouseOffset}
+ * 
+ * ## Showing/Hiding
+ * 
+ * The following configuration properties allow control over how and when the ToolTip is automatically
+ * shown and hidden:
+ * 
+ *  - {@link #autoHide}
+ *  - {@link #showDelay}
+ *  - {@link #hideDelay}
+ *  - {@link #dismissDelay}
+ * 
  * @constructor
- * Create a new Tooltip
+ * Create a new ToolTip instance
  * @param {Object} config The configuration options
+ * @xtype tooltip
+ * @markdown
+ * @docauthor Jason Johnston &lt;jason@sencha.com&gt;
  */
-Ext.ToolTip = Ext.extend(Ext.Tip, {
-    <div id="prop-Ext.ToolTip-triggerElement"></div>/**
-     * When a Tooltip is configured with the <code>{@link #delegate}</code>
-     * option to cause selected child elements of the <code>{@link #target}</code>
+Ext.define('Ext.tip.ToolTip', {
+    extend: 'Ext.tip.Tip',
+    alias: 'widget.tooltip',
+    alternateClassName: 'Ext.ToolTip',
+<span id='Ext-tip-ToolTip-property-triggerElement'>    /**
+</span>     * When a ToolTip is configured with the &lt;code&gt;{@link #delegate}&lt;/code&gt;
+     * option to cause selected child elements of the &lt;code&gt;{@link #target}&lt;/code&gt;
      * Element to each trigger a seperate show event, this property is set to
      * the DOM element which triggered the show.
      * @type DOMElement
      * @property triggerElement
      */
-    <div id="cfg-Ext.ToolTip-target"></div>/**
-     * @cfg {Mixed} target The target HTMLElement, Ext.Element or id to monitor
+<span id='Ext-tip-ToolTip-cfg-target'>    /**
+</span>     * @cfg {Mixed} target The target HTMLElement, Ext.core.Element or id to monitor
      * for mouseover events to trigger showing this ToolTip.
      */
-    <div id="cfg-Ext.ToolTip-autoHide"></div>/**
-     * @cfg {Boolean} autoHide True to automatically hide the tooltip after the
-     * mouse exits the target element or after the <code>{@link #dismissDelay}</code>
-     * has expired if set (defaults to true).  If <code>{@link closable} = true</code>
+<span id='Ext-tip-ToolTip-cfg-autoHide'>    /**
+</span>     * @cfg {Boolean} autoHide True to automatically hide the tooltip after the
+     * mouse exits the target element or after the &lt;code&gt;{@link #dismissDelay}&lt;/code&gt;
+     * has expired if set (defaults to true).  If &lt;code&gt;{@link #closable} = true&lt;/code&gt;
      * a close tool button will be rendered into the tooltip header.
      */
-    <div id="cfg-Ext.ToolTip-showDelay"></div>/**
-     * @cfg {Number} showDelay Delay in milliseconds before the tooltip displays
+<span id='Ext-tip-ToolTip-cfg-showDelay'>    /**
+</span>     * @cfg {Number} showDelay Delay in milliseconds before the tooltip displays
      * after the mouse enters the target element (defaults to 500)
      */
-    showDelay : 500,
-    <div id="cfg-Ext.ToolTip-hideDelay"></div>/**
-     * @cfg {Number} hideDelay Delay in milliseconds after the mouse exits the
+    showDelay: 500,
+<span id='Ext-tip-ToolTip-cfg-hideDelay'>    /**
+</span>     * @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,
-    <div id="cfg-Ext.ToolTip-dismissDelay"></div>/**
-     * @cfg {Number} dismissDelay Delay in milliseconds before the tooltip
+    hideDelay: 200,
+<span id='Ext-tip-ToolTip-cfg-dismissDelay'>    /**
+</span>     * @cfg {Number} dismissDelay Delay in milliseconds before the tooltip
      * automatically hides (defaults to 5000). To disable automatic hiding, set
      * dismissDelay = 0.
      */
-    dismissDelay : 5000,
-    <div id="cfg-Ext.ToolTip-mouseOffset"></div>/**
-     * @cfg {Array} mouseOffset An XY offset from the mouse position where the
+    dismissDelay: 5000,
+<span id='Ext-tip-ToolTip-cfg-mouseOffset'>    /**
+</span>     * @cfg {Array} mouseOffset An XY offset from the mouse position where the
      * tooltip should be shown (defaults to [15,18]).
      */
-    <div id="cfg-Ext.ToolTip-trackMouse"></div>/**
-     * @cfg {Boolean} trackMouse True to have the tooltip follow the mouse as it
+<span id='Ext-tip-ToolTip-cfg-trackMouse'>    /**
+</span>     * @cfg {Boolean} trackMouse True to have the tooltip follow the mouse as it
      * moves over the target element (defaults to false).
      */
-    trackMouse : false,
-    <div id="cfg-Ext.ToolTip-anchorToTarget"></div>/**
-     * @cfg {Boolean} anchorToTarget True to anchor the tooltip to the target
+    trackMouse: false,
+<span id='Ext-tip-ToolTip-cfg-anchor'>    /**
+</span>     * @cfg {String} anchor If specified, indicates that the tip should be anchored to a
+     * particular side of the target element or mouse pointer (&quot;top&quot;, &quot;right&quot;, &quot;bottom&quot;,
+     * or &quot;left&quot;), with an arrow pointing back at the target or mouse pointer. If
+     * {@link #constrainPosition} is enabled, this will be used as a preferred value
+     * only and may be flipped as needed.
+     */
+<span id='Ext-tip-ToolTip-cfg-anchorToTarget'>    /**
+</span>     * @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 <code>anchorToTarget</code> is true, use
-     * <code>{@link #defaultAlign}</code> to control tooltip alignment to the
-     * target element.  When <code>anchorToTarget</code> is false, use
-     * <code>{@link #anchorPosition}</code> instead to control alignment.
+     * to true).  When &lt;code&gt;anchorToTarget&lt;/code&gt; is true, use
+     * &lt;code&gt;{@link #defaultAlign}&lt;/code&gt; to control tooltip alignment to the
+     * target element.  When &lt;code&gt;anchorToTarget&lt;/code&gt; is false, use
+     * &lt;code&gt;{@link #anchorPosition}&lt;/code&gt; instead to control alignment.
      */
-    anchorToTarget : true,
-    <div id="cfg-Ext.ToolTip-anchorOffset"></div>/**
-     * @cfg {Number} anchorOffset A numeric pixel value used to offset the
+    anchorToTarget: true,
+<span id='Ext-tip-ToolTip-cfg-anchorOffset'>    /**
+</span>     * @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, <code>anchorOffset</code>
+     * position is on the top or bottom of the tooltip, &lt;code&gt;anchorOffset&lt;/code&gt;
      * will be used as a horizontal offset.  Likewise, when the anchor position
-     * is on the left or right side, <code>anchorOffset</code> will be used as
+     * is on the left or right side, &lt;code&gt;anchorOffset&lt;/code&gt; will be used as
      * a vertical offset.
      */
-    anchorOffset : 0,
-    <div id="cfg-Ext.ToolTip-delegate"></div>/**
-     * @cfg {String} delegate <p>Optional. A {@link Ext.DomQuery DomQuery}
+    anchorOffset: 0,
+<span id='Ext-tip-ToolTip-cfg-delegate'>    /**
+</span>     * @cfg {String} delegate &lt;p&gt;Optional. A {@link Ext.DomQuery DomQuery}
      * selector which allows selection of individual elements within the
-     * <code>{@link #target}</code> element to trigger showing and hiding the
-     * ToolTip as the mouse moves within the target.</p>
-     * <p>When specified, the child element of the target which caused a show
-     * event is placed into the <code>{@link #triggerElement}</code> property
-     * before the ToolTip is shown.</p>
-     * <p>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:</p><pre><code>
-var myGrid = new Ext.grid.gridPanel(gridConfig);
+     * &lt;code&gt;{@link #target}&lt;/code&gt; element to trigger showing and hiding the
+     * ToolTip as the mouse moves within the target.&lt;/p&gt;
+     * &lt;p&gt;When specified, the child element of the target which caused a show
+     * event is placed into the &lt;code&gt;{@link #triggerElement}&lt;/code&gt; property
+     * before the ToolTip is shown.&lt;/p&gt;
+     * &lt;p&gt;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:&lt;/p&gt;&lt;pre&gt;&lt;code&gt;
+var myGrid = Ext.create('Ext.grid.GridPanel', gridConfig);
 myGrid.on('render', function(grid) {
-    var store = grid.getStore();  // Capture the Store.
-    var view = grid.getView();    // Capture the GridView.
-    myGrid.tip = new Ext.ToolTip({
-        target: view.mainBody,    // The overall target element.
-        delegate: '.x-grid3-row', // Each grid row causes its own seperate show and hide.
+    var view = grid.getView();    // Capture the grid's view.
+    grid.tip = Ext.create('Ext.tip.ToolTip', {
+        target: view.el,          // The overall target element.
+        delegate: view.itemSelector, // 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.
-            beforeshow: function updateTipBody(tip) {
-                var rowIndex = view.findRowIndex(tip.triggerElement);
-                tip.body.dom.innerHTML = 'Over Record ID ' + store.getAt(rowIndex).id;
+        renderTo: Ext.getBody(),  // 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(tip) {
+                tip.update('Over Record ID ' + view.getRecord(tip.triggerElement).id);
             }
         }
     });
 });
-     *</code></pre>
+     *&lt;/code&gt;&lt;/pre&gt;
      */
 
     // private
-    targetCounter : 0,
-
-    constrainPosition : false,
+    targetCounter: 0,
+    quickShowInterval: 250,
 
     // private
-    initComponent : function(){
-        Ext.ToolTip.superclass.initComponent.call(this);
-        this.lastActive = new Date();
-        this.initTarget(this.target);
-        this.origAnchor = this.anchor;
+    initComponent: function() {
+        var me = this;
+        me.callParent(arguments);
+        me.lastActive = new Date();
+        me.setTarget(me.target);
+        me.origAnchor = me.anchor;
     },
 
     // private
-    onRender : function(ct, position){
-        Ext.ToolTip.superclass.onRender.call(this, ct, position);
-        this.anchorCls = 'x-tip-anchor-' + this.getAnchorPosition();
-        this.anchorEl = this.el.createChild({
-            cls: 'x-tip-anchor ' + this.anchorCls
+    onRender: function(ct, position) {
+        var me = this;
+        me.callParent(arguments);
+        me.anchorCls = Ext.baseCSSPrefix + 'tip-anchor-' + me.getAnchorPosition();
+        me.anchorEl = me.el.createChild({
+            cls: Ext.baseCSSPrefix + 'tip-anchor ' + me.anchorCls
         });
     },
 
     // private
-    afterRender : function(){
-        Ext.ToolTip.superclass.afterRender.call(this);
-        this.anchorEl.setStyle('z-index', this.el.getZIndex() + 1).setVisibilityMode(Ext.Element.DISPLAY);
+    afterRender: function() {
+        var me = this,
+            zIndex;
+
+        me.callParent(arguments);
+        zIndex = parseInt(me.el.getZIndex(), 10) || 0;
+        me.anchorEl.setStyle('z-index', zIndex + 1).setVisibilityMode(Ext.core.Element.DISPLAY);
     },
 
-    <div id="method-Ext.ToolTip-initTarget"></div>/**
-     * Binds this ToolTip to the specified element. The tooltip will be displayed when the mouse moves over the element.
+<span id='Ext-tip-ToolTip-method-setTarget'>    /**
+</span>     * Binds this ToolTip to the specified element. The tooltip will be displayed when the mouse moves over the element.
      * @param {Mixed} t The Element, HtmlElement, or ID of an element to bind to
      */
-    initTarget : function(target){
-        var t;
-        if((t = Ext.get(target))){
-            if(this.target){
-                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,
-                mouseout: this.onTargetOut,
-                mousemove: this.onMouseMove,
-                scope: this
+    setTarget: function(target) {
+        var me = this,
+            t = Ext.get(target),
+            tg;
+
+        if (me.target) {
+            tg = Ext.get(me.target);
+            me.mun(tg, 'mouseover', me.onTargetOver, me);
+            me.mun(tg, 'mouseout', me.onTargetOut, me);
+            me.mun(tg, 'mousemove', me.onMouseMove, me);
+        }
+        
+        me.target = t;
+        if (t) {
+            
+            me.mon(t, {
+                // TODO - investigate why IE6/7 seem to fire recursive resize in e.getXY
+                // breaking QuickTip#onTargetOver (EXTJSIV-1608)
+                freezeEvent: true,
+
+                mouseover: me.onTargetOver,
+                mouseout: me.onTargetOut,
+                mousemove: me.onMouseMove,
+                scope: me
             });
-            this.target = t;
         }
-        if(this.anchor){
-            this.anchorTarget = this.target;
+        if (me.anchor) {
+            me.anchorTarget = me.target;
         }
     },
 
     // private
-    onMouseMove : function(e){
-        var t = this.delegate ? e.getTarget(this.delegate) : this.triggerElement = true;
+    onMouseMove: function(e) {
+        var me = this,
+            t = me.delegate ? e.getTarget(me.delegate) : me.triggerElement = true,
+            xy;
         if (t) {
-            this.targetXY = e.getXY();
-            if (t === this.triggerElement) {
-                if(!this.hidden && this.trackMouse){
-                    this.setPagePosition(this.getTargetXY());
+            me.targetXY = e.getXY();
+            if (t === me.triggerElement) {
+                if (!me.hidden &amp;&amp; me.trackMouse) {
+                    xy = me.getTargetXY();
+                    if (me.constrainPosition) {
+                        xy = me.el.adjustForConstraints(xy, me.el.dom.parentNode);
+                    }
+                    me.setPagePosition(xy);
                 }
             } else {
-                this.hide();
-                this.lastActive = new Date(0);
-                this.onTargetOver(e);
+                me.hide();
+                me.lastActive = new Date(0);
+                me.onTargetOver(e);
             }
-        } else if (!this.closable && this.isVisible()) {
-            this.hide();
+        } else if ((!me.closable &amp;&amp; me.isVisible()) &amp;&amp; me.autoHide !== false) {
+            me.hide();
         }
     },
 
     // private
-    getTargetXY : function(){
-        if(this.delegate){
-            this.anchorTarget = this.triggerElement;
+    getTargetXY: function() {
+        var me = this,
+            mouseOffset;
+        if (me.delegate) {
+            me.anchorTarget = me.triggerElement;
         }
-        if(this.anchor){
-            this.targetCounter++;
-            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){
-                if(axy[0] < scrollX){
-                    if(this.anchorToTarget){
-                        this.defaultAlign = 'l-r';
-                        if(this.mouseOffset){this.mouseOffset[0] *= -1;}
+        if (me.anchor) {
+            me.targetCounter++;
+                var offsets = me.getOffsets(),
+                    xy = (me.anchorToTarget &amp;&amp; !me.trackMouse) ? me.el.getAlignToXY(me.anchorTarget, me.getAnchorAlign()) : me.targetXY,
+                    dw = Ext.core.Element.getViewWidth() - 5,
+                    dh = Ext.core.Element.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 = me.getSize(),
+                    constrainPosition = me.constrainPosition;
+
+            me.anchorEl.removeCls(me.anchorCls);
+
+            if (me.targetCounter &lt; 2 &amp;&amp; constrainPosition) {
+                if (axy[0] &lt; scrollX) {
+                    if (me.anchorToTarget) {
+                        me.defaultAlign = 'l-r';
+                        if (me.mouseOffset) {
+                            me.mouseOffset[0] *= -1;
+                        }
                     }
-                    this.anchor = 'left';
-                    return this.getTargetXY();
+                    me.anchor = 'left';
+                    return me.getTargetXY();
                 }
-                if(axy[0]+sz.width > dw){
-                    if(this.anchorToTarget){
-                        this.defaultAlign = 'r-l';
-                        if(this.mouseOffset){this.mouseOffset[0] *= -1;}
+                if (axy[0] + sz.width &gt; dw) {
+                    if (me.anchorToTarget) {
+                        me.defaultAlign = 'r-l';
+                        if (me.mouseOffset) {
+                            me.mouseOffset[0] *= -1;
+                        }
                     }
-                    this.anchor = 'right';
-                    return this.getTargetXY();
+                    me.anchor = 'right';
+                    return me.getTargetXY();
                 }
-                if(axy[1] < scrollY){
-                    if(this.anchorToTarget){
-                        this.defaultAlign = 't-b';
-                        if(this.mouseOffset){this.mouseOffset[1] *= -1;}
+                if (axy[1] &lt; scrollY) {
+                    if (me.anchorToTarget) {
+                        me.defaultAlign = 't-b';
+                        if (me.mouseOffset) {
+                            me.mouseOffset[1] *= -1;
+                        }
                     }
-                    this.anchor = 'top';
-                    return this.getTargetXY();
+                    me.anchor = 'top';
+                    return me.getTargetXY();
                 }
-                if(axy[1]+sz.height > dh){
-                    if(this.anchorToTarget){
-                        this.defaultAlign = 'b-t';
-                        if(this.mouseOffset){this.mouseOffset[1] *= -1;}
+                if (axy[1] + sz.height &gt; dh) {
+                    if (me.anchorToTarget) {
+                        me.defaultAlign = 'b-t';
+                        if (me.mouseOffset) {
+                            me.mouseOffset[1] *= -1;
+                        }
                     }
-                    this.anchor = 'bottom';
-                    return this.getTargetXY();
+                    me.anchor = 'bottom';
+                    return me.getTargetXY();
                 }
             }
 
-            this.anchorCls = 'x-tip-anchor-'+this.getAnchorPosition();
-            this.anchorEl.addClass(this.anchorCls);
-            this.targetCounter = 0;
+            me.anchorCls = Ext.baseCSSPrefix + 'tip-anchor-' + me.getAnchorPosition();
+            me.anchorEl.addCls(me.anchorCls);
+            me.targetCounter = 0;
             return axy;
-        }else{
-            var mouseOffset = this.getMouseOffset();
-            return [this.targetXY[0]+mouseOffset[0], this.targetXY[1]+mouseOffset[1]];
+        } else {
+            mouseOffset = me.getMouseOffset();
+            return (me.targetXY) ? [me.targetXY[0] + mouseOffset[0], me.targetXY[1] + mouseOffset[1]] : mouseOffset;
         }
     },
 
-    getMouseOffset : function(){
-        var offset = this.anchor ? [0,0] : [15,18];
-        if(this.mouseOffset){
-            offset[0] += this.mouseOffset[0];
-            offset[1] += this.mouseOffset[1];
+    getMouseOffset: function() {
+        var me = this,
+        offset = me.anchor ? [0, 0] : [15, 18];
+        if (me.mouseOffset) {
+            offset[0] += me.mouseOffset[0];
+            offset[1] += me.mouseOffset[1];
         }
         return offset;
     },
 
     // private
-    getAnchorPosition : function(){
-        if(this.anchor){
-            this.tipAnchor = this.anchor.charAt(0);
-        }else{
-            var m = this.defaultAlign.match(/^([a-z]+)-([a-z]+)(\?)?$/);
-            if(!m){
-               throw 'AnchorTip.defaultAlign is invalid';
+    getAnchorPosition: function() {
+        var me = this,
+            m;
+        if (me.anchor) {
+            me.tipAnchor = me.anchor.charAt(0);
+        } else {
+            m = me.defaultAlign.match(/^([a-z]+)-([a-z]+)(\?)?$/);
+            //&lt;debug&gt;
+            if (!m) {
+                Ext.Error.raise('The AnchorTip.defaultAlign value &quot;' + me.defaultAlign + '&quot; is invalid.');
             }
-            this.tipAnchor = m[1].charAt(0);
+            //&lt;/debug&gt;
+            me.tipAnchor = m[1].charAt(0);
         }
 
-        switch(this.tipAnchor){
-            case 't': return 'top';
-            case 'b': return 'bottom';
-            case 'r': return 'right';
+        switch (me.tipAnchor) {
+        case 't':
+            return 'top';
+        case 'b':
+            return 'bottom';
+        case 'r':
+            return 'right';
         }
         return 'left';
     },
 
     // private
-    getAnchorAlign : function(){
-        switch(this.anchor){
-            case 'top'  : return 'tl-bl';
-            case 'left' : return 'tl-tr';
-            case 'right': return 'tr-tl';
-            default     : return 'bl-tl';
+    getAnchorAlign: function() {
+        switch (this.anchor) {
+        case 'top':
+            return 'tl-bl';
+        case 'left':
+            return 'tl-tr';
+        case 'right':
+            return 'tr-tl';
+        default:
+            return 'bl-tl';
         }
     },
 
     // private
-    getOffsets : function(){
-        var offsets, 
-            ap = this.getAnchorPosition().charAt(0);
-        if(this.anchorToTarget && !this.trackMouse){
-            switch(ap){
-                case 't':
-                    offsets = [0, 9];
-                    break;
-                case 'b':
-                    offsets = [0, -13];
-                    break;
-                case 'r':
-                    offsets = [-13, 0];
-                    break;
-                default:
-                    offsets = [9, 0];
-                    break;
+    getOffsets: function() {
+        var me = this,
+            mouseOffset,
+            offsets,
+            ap = me.getAnchorPosition().charAt(0);
+        if (me.anchorToTarget &amp;&amp; !me.trackMouse) {
+            switch (ap) {
+            case 't':
+                offsets = [0, 9];
+                break;
+            case 'b':
+                offsets = [0, -13];
+                break;
+            case 'r':
+                offsets = [ - 13, 0];
+                break;
+            default:
+                offsets = [9, 0];
+                break;
             }
-        }else{
-            switch(ap){
-                case 't':
-                    offsets = [-15-this.anchorOffset, 30];
-                    break;
-                case 'b':
-                    offsets = [-19-this.anchorOffset, -13-this.el.dom.offsetHeight];
-                    break;
-                case 'r':
-                    offsets = [-15-this.el.dom.offsetWidth, -13-this.anchorOffset];
-                    break;
-                default:
-                    offsets = [25, -13-this.anchorOffset];
-                    break;
+        } else {
+            switch (ap) {
+            case 't':
+                offsets = [ - 15 - me.anchorOffset, 30];
+                break;
+            case 'b':
+                offsets = [ - 19 - me.anchorOffset, -13 - me.el.dom.offsetHeight];
+                break;
+            case 'r':
+                offsets = [ - 15 - me.el.dom.offsetWidth, -13 - me.anchorOffset];
+                break;
+            default:
+                offsets = [25, -13 - me.anchorOffset];
+                break;
             }
         }
-        var mouseOffset = this.getMouseOffset();
+        mouseOffset = me.getMouseOffset();
         offsets[0] += mouseOffset[0];
         offsets[1] += mouseOffset[1];
 
@@ -337,213 +465,239 @@ myGrid.on('render', function(grid) {
     },
 
     // private
-    onTargetOver : function(e){
-        if(this.disabled || e.within(this.target.dom, true)){
+    onTargetOver: function(e) {
+        var me = this,
+            t;
+
+        if (me.disabled || e.within(me.target.dom, true)) {
             return;
         }
-        var t = e.getTarget(this.delegate);
+        t = e.getTarget(me.delegate);
         if (t) {
-            this.triggerElement = t;
-            this.clearTimer('hide');
-            this.targetXY = e.getXY();
-            this.delayShow();
+            me.triggerElement = t;
+            me.clearTimer('hide');
+            me.targetXY = e.getXY();
+            me.delayShow();
         }
     },
 
     // private
-    delayShow : function(){
-        if(this.hidden && !this.showTimer){
-            if(this.lastActive.getElapsed() < this.quickShowInterval){
-                this.show();
-            }else{
-                this.showTimer = this.show.defer(this.showDelay, this);
+    delayShow: function() {
+        var me = this;
+        if (me.hidden &amp;&amp; !me.showTimer) {
+            if (Ext.Date.getElapsed(me.lastActive) &lt; me.quickShowInterval) {
+                me.show();
+            } else {
+                me.showTimer = Ext.defer(me.show, me.showDelay, me);
             }
-        }else if(!this.hidden && this.autoHide !== false){
-            this.show();
+        }
+        else if (!me.hidden &amp;&amp; me.autoHide !== false) {
+            me.show();
         }
     },
 
     // private
-    onTargetOut : function(e){
-        if(this.disabled || e.within(this.target.dom, true)){
+    onTargetOut: function(e) {
+        var me = this;
+        if (me.disabled || e.within(me.target.dom, true)) {
             return;
         }
-        this.clearTimer('show');
-        if(this.autoHide !== false){
-            this.delayHide();
+        me.clearTimer('show');
+        if (me.autoHide !== false) {
+            me.delayHide();
         }
     },
 
     // private
-    delayHide : function(){
-        if(!this.hidden && !this.hideTimer){
-            this.hideTimer = this.hide.defer(this.hideDelay, this);
+    delayHide: function() {
+        var me = this;
+        if (!me.hidden &amp;&amp; !me.hideTimer) {
+            me.hideTimer = Ext.defer(me.hide, me.hideDelay, me);
         }
     },
 
-    <div id="method-Ext.ToolTip-hide"></div>/**
-     * Hides this tooltip if visible.
+<span id='Ext-tip-ToolTip-method-hide'>    /**
+</span>     * Hides this tooltip if visible.
      */
-    hide: function(){
-        this.clearTimer('dismiss');
-        this.lastActive = new Date();
-        if(this.anchorEl){
-            this.anchorEl.hide();
+    hide: function() {
+        var me = this;
+        me.clearTimer('dismiss');
+        me.lastActive = new Date();
+        if (me.anchorEl) {
+            me.anchorEl.hide();
         }
-        Ext.ToolTip.superclass.hide.call(this);
-        delete this.triggerElement;
+        me.callParent(arguments);
+        delete me.triggerElement;
     },
 
-    <div id="method-Ext.ToolTip-show"></div>/**
-     * Shows this tooltip at the current event target XY position.
+<span id='Ext-tip-ToolTip-method-show'>    /**
+</span>     * Shows this tooltip at the current event target XY position.
      */
-    show : function(){
-        if(this.anchor){
-            // pre-show it off screen so that the el will have dimensions
-            // for positioning calcs when getting xy next
-            this.showAt([-1000,-1000]);
-            this.origConstrainPosition = this.constrainPosition;
-            this.constrainPosition = false;
-            this.anchor = this.origAnchor;
-        }
-        this.showAt(this.getTargetXY());
-
-        if(this.anchor){
-            this.anchorEl.show();
-            this.syncAnchor();
-            this.constrainPosition = this.origConstrainPosition;
-        }else{
-            this.anchorEl.hide();
+    show: function() {
+        var me = this;
+
+        // Show this Component first, so that sizing can be calculated
+        // pre-show it off screen so that the el will have dimensions
+        this.callParent();
+        if (this.hidden === false) {
+            me.setPagePosition(-10000, -10000);
+
+            if (me.anchor) {
+                me.anchor = me.origAnchor;
+            }
+            me.showAt(me.getTargetXY());
+
+            if (me.anchor) {
+                me.syncAnchor();
+                me.anchorEl.show();
+            } else {
+                me.anchorEl.hide();
+            }
         }
     },
 
     // inherit docs
-    showAt : function(xy){
-        this.lastActive = new Date();
-        this.clearTimers();
-        Ext.ToolTip.superclass.showAt.call(this, xy);
-        if(this.dismissDelay && this.autoHide !== false){
-            this.dismissTimer = this.hide.defer(this.dismissDelay, this);
+    showAt: function(xy) {
+        var me = this;
+        me.lastActive = new Date();
+        me.clearTimers();
+
+        // Only call if this is hidden. May have been called from show above.
+        if (!me.isVisible()) {
+            this.callParent(arguments);
         }
-        if(this.anchor && !this.anchorEl.isVisible()){
-            this.syncAnchor();
-            this.anchorEl.show();
-        }else{
-            this.anchorEl.hide();
+
+        // Show may have been vetoed.
+        if (me.isVisible()) {
+            me.setPagePosition(xy[0], xy[1]);
+            if (me.constrainPosition || me.constrain) {
+                me.doConstrain();
+            }
+            me.toFront(true);
+        }
+
+        if (me.dismissDelay &amp;&amp; me.autoHide !== false) {
+            me.dismissTimer = Ext.defer(me.hide, me.dismissDelay, me);
+        }
+        if (me.anchor) {
+            me.syncAnchor();
+            if (!me.anchorEl.isVisible()) {
+                me.anchorEl.show();
+            }
+        } else {
+            me.anchorEl.hide();
         }
     },
 
     // private
-    syncAnchor : function(){
-        var anchorPos, targetPos, offset;
-        switch(this.tipAnchor.charAt(0)){
-            case 't':
-                anchorPos = 'b';
-                targetPos = 'tl';
-                offset = [20+this.anchorOffset, 2];
-                break;
-            case 'r':
-                anchorPos = 'l';
-                targetPos = 'tr';
-                offset = [-2, 11+this.anchorOffset];
-                break;
-            case 'b':
-                anchorPos = 't';
-                targetPos = 'bl';
-                offset = [20+this.anchorOffset, -2];
-                break;
-            default:
-                anchorPos = 'r';
-                targetPos = 'tl';
-                offset = [2, 11+this.anchorOffset];
-                break;
+    syncAnchor: function() {
+        var me = this,
+            anchorPos,
+            targetPos,
+            offset;
+        switch (me.tipAnchor.charAt(0)) {
+        case 't':
+            anchorPos = 'b';
+            targetPos = 'tl';
+            offset = [20 + me.anchorOffset, 1];
+            break;
+        case 'r':
+            anchorPos = 'l';
+            targetPos = 'tr';
+            offset = [ - 1, 12 + me.anchorOffset];
+            break;
+        case 'b':
+            anchorPos = 't';
+            targetPos = 'bl';
+            offset = [20 + me.anchorOffset, -1];
+            break;
+        default:
+            anchorPos = 'r';
+            targetPos = 'tl';
+            offset = [1, 12 + me.anchorOffset];
+            break;
         }
-        this.anchorEl.alignTo(this.el, anchorPos+'-'+targetPos, offset);
+        me.anchorEl.alignTo(me.el, anchorPos + '-' + targetPos, offset);
     },
 
     // private
-    setPagePosition : function(x, y){
-        Ext.ToolTip.superclass.setPagePosition.call(this, x, y);
-        if(this.anchor){
-            this.syncAnchor();
+    setPagePosition: function(x, y) {
+        var me = this;
+        me.callParent(arguments);
+        if (me.anchor) {
+            me.syncAnchor();
         }
     },
 
     // private
-    clearTimer : function(name){
+    clearTimer: function(name) {
         name = name + 'Timer';
         clearTimeout(this[name]);
         delete this[name];
     },
 
     // private
-    clearTimers : function(){
-        this.clearTimer('show');
-        this.clearTimer('dismiss');
-        this.clearTimer('hide');
+    clearTimers: function() {
+        var me = this;
+        me.clearTimer('show');
+        me.clearTimer('dismiss');
+        me.clearTimer('hide');
     },
 
     // private
-    onShow : function(){
-        Ext.ToolTip.superclass.onShow.call(this);
-        Ext.getDoc().on('mousedown', this.onDocMouseDown, this);
+    onShow: function() {
+        var me = this;
+        me.callParent();
+        me.mon(Ext.getDoc(), 'mousedown', me.onDocMouseDown, me);
     },
 
     // private
-    onHide : function(){
-        Ext.ToolTip.superclass.onHide.call(this);
-        Ext.getDoc().un('mousedown', this.onDocMouseDown, this);
+    onHide: function() {
+        var me = this;
+        me.callParent();
+        me.mun(Ext.getDoc(), 'mousedown', me.onDocMouseDown, me);
     },
 
     // private
-    onDocMouseDown : function(e){
-        if(this.autoHide !== true && !this.closable && !e.within(this.el.dom)){
-            this.disable();
-            this.doEnable.defer(100, this);
+    onDocMouseDown: function(e) {
+        var me = this;
+        if (me.autoHide !== true &amp;&amp; !me.closable &amp;&amp; !e.within(me.el.dom)) {
+            me.disable();
+            Ext.defer(me.doEnable, 100, me);
         }
     },
-    
+
     // private
-    doEnable : function(){
-        if(!this.isDestroyed){
+    doEnable: function() {
+        if (!this.isDestroyed) {
             this.enable();
         }
     },
 
     // private
-    onDisable : function(){
+    onDisable: function() {
+        this.callParent();
         this.clearTimers();
         this.hide();
     },
 
-    // private
-    adjustPosition : function(x, y){
-        if(this.contstrainPosition){
-            var ay = this.targetXY[1], h = this.getSize().height;
-            if(y <= ay && (y+h) >= ay){
-                y = ay-h-5;
-            }
-        }
-        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);    
+    beforeDestroy: function() {
+        var me = this;
+        me.clearTimers();
+        Ext.destroy(me.anchorEl);
+        delete me.anchorEl;
+        delete me.target;
+        delete me.anchorTarget;
+        delete me.triggerElement;
+        me.callParent();
     },
 
     // private
-    onDestroy : function(){
+    onDestroy: function() {
         Ext.getDoc().un('mousedown', this.onDocMouseDown, this);
-        Ext.ToolTip.superclass.onDestroy.call(this);
+        this.callParent();
     }
 });
-
-Ext.reg('tooltip', Ext.ToolTip);</pre>    
+</pre>
 </body>
-</html>
\ No newline at end of file
+</html>