+<!DOCTYPE html>
<html>
<head>
+ <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="../resources/prettify/prettify.css" type="text/css" rel="stylesheet" />
+ <script type="text/javascript" src="../resources/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.0.3
- * Copyright(c) 2006-2009 Ext JS, LLC
- * licensing@extjs.com
- * http://www.extjs.com/license
+<body onload="prettyPrint(); highlight();">
+ <pre class="prettyprint lang-js"><span id='Ext-tip-ToolTip'>/**
+</span> * 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 store = Ext.create('Ext.data.ArrayStore', {
+ * fields: ['company', 'price', 'change'],
+ * data: [
+ * ['3m Co', 71.72, 0.02],
+ * ['Alcoa Inc', 29.01, 0.42],
+ * ['Altria Group Inc', 83.81, 0.28],
+ * ['American Express Company', 52.55, 0.01],
+ * ['American International Group, Inc.', 64.13, 0.31],
+ * ['AT&T Inc.', 31.61, -0.48]
+ * ]
+ * });
+ *
+ * var grid = Ext.create('Ext.grid.Panel', {
+ * title: 'Array Grid',
+ * store: store,
+ * columns: [
+ * {text: 'Company', flex: 1, dataIndex: 'company'},
+ * {text: 'Price', width: 75, dataIndex: 'price'},
+ * {text: 'Change', width: 75, dataIndex: 'change'}
+ * ],
+ * height: 200,
+ * width: 400,
+ * renderTo: Ext.getBody()
+ * });
+ *
+ * grid.getView().on('render', function(view) {
+ * view.tip = Ext.create('Ext.tip.ToolTip', {
+ * // The overall target element.
+ * target: view.el,
+ * // Each grid row causes its own seperate show and hide.
+ * delegate: view.itemSelector,
+ * // Moving within the row should not hide the tip.
+ * trackMouse: true,
+ * // Render immediately so that tip.body can be referenced prior to the first show.
+ * renderTo: Ext.getBody(),
+ * listeners: {
+ * // Change content dynamically depending on which element triggered the show.
+ * beforeshow: function updateTipBody(tip) {
+ * tip.update('Over company "' + view.getRecord(tip.triggerElement).get('company') + '"');
+ * }
+ * }
+ * });
+ * });
+ *
+ * {@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}
+ *
+ * @docauthor Jason Johnston <jason@sencha.com>
*/
-<div id="cls-Ext.ToolTip"></div>/**\r
- * @class Ext.ToolTip\r
- * @extends Ext.Tip\r
- * A standard tooltip implementation for providing additional information when hovering over a target element.\r
- * @xtype tooltip\r
- * @constructor\r
- * Create a new Tooltip\r
- * @param {Object} config The configuration options\r
- */\r
-Ext.ToolTip = Ext.extend(Ext.Tip, {\r
- <div id="prop-Ext.ToolTip-triggerElement"></div>/**\r
- * When a Tooltip is configured with the <code>{@link #delegate}</code>\r
- * option to cause selected child elements of the <code>{@link #target}</code>\r
- * Element to each trigger a seperate show event, this property is set to\r
- * the DOM element which triggered the show.\r
- * @type DOMElement\r
- * @property triggerElement\r
- */\r
- <div id="cfg-Ext.ToolTip-target"></div>/**\r
- * @cfg {Mixed} target The target HTMLElement, Ext.Element or id to monitor\r
- * for mouseover events to trigger showing this ToolTip.\r
- */\r
- <div id="cfg-Ext.ToolTip-autoHide"></div>/**\r
- * @cfg {Boolean} autoHide True to automatically hide the tooltip after the\r
- * mouse exits the target element or after the <code>{@link #dismissDelay}</code>\r
- * has expired if set (defaults to true). If <code>{@link closable} = true</code>\r
- * a close tool button will be rendered into the tooltip header.\r
- */\r
- <div id="cfg-Ext.ToolTip-showDelay"></div>/**\r
- * @cfg {Number} showDelay Delay in milliseconds before the tooltip displays\r
- * after the mouse enters the target element (defaults to 500)\r
- */\r
- showDelay : 500,\r
- <div id="cfg-Ext.ToolTip-hideDelay"></div>/**\r
- * @cfg {Number} hideDelay Delay in milliseconds after the mouse exits the\r
- * target element but before the tooltip actually hides (defaults to 200).\r
- * Set to 0 for the tooltip to hide immediately.\r
- */\r
- hideDelay : 200,\r
- <div id="cfg-Ext.ToolTip-dismissDelay"></div>/**\r
- * @cfg {Number} dismissDelay Delay in milliseconds before the tooltip\r
- * automatically hides (defaults to 5000). To disable automatic hiding, set\r
- * dismissDelay = 0.\r
- */\r
- dismissDelay : 5000,\r
- <div id="cfg-Ext.ToolTip-mouseOffset"></div>/**\r
- * @cfg {Array} mouseOffset An XY offset from the mouse position where the\r
- * tooltip should be shown (defaults to [15,18]).\r
- */\r
- <div id="cfg-Ext.ToolTip-trackMouse"></div>/**\r
- * @cfg {Boolean} trackMouse True to have the tooltip follow the mouse as it\r
- * moves over the target element (defaults to false).\r
- */\r
- trackMouse : false,\r
- <div id="cfg-Ext.ToolTip-anchorToTarget"></div>/**\r
- * @cfg {Boolean} anchorToTarget True to anchor the tooltip to the target\r
- * element, false to anchor it relative to the mouse coordinates (defaults\r
- * to true). When <code>anchorToTarget</code> is true, use\r
- * <code>{@link #defaultAlign}</code> to control tooltip alignment to the\r
- * target element. When <code>anchorToTarget</code> is false, use\r
- * <code>{@link #anchorPosition}</code> instead to control alignment.\r
- */\r
- anchorToTarget : true,\r
- <div id="cfg-Ext.ToolTip-anchorOffset"></div>/**\r
- * @cfg {Number} anchorOffset A numeric pixel value used to offset the\r
- * default position of the anchor arrow (defaults to 0). When the anchor\r
- * position is on the top or bottom of the tooltip, <code>anchorOffset</code>\r
- * will be used as a horizontal offset. Likewise, when the anchor position\r
- * is on the left or right side, <code>anchorOffset</code> will be used as\r
- * a vertical offset.\r
- */\r
- anchorOffset : 0,\r
- <div id="cfg-Ext.ToolTip-delegate"></div>/**\r
- * @cfg {String} delegate <p>Optional. A {@link Ext.DomQuery DomQuery}\r
- * selector which allows selection of individual elements within the\r
- * <code>{@link #target}</code> element to trigger showing and hiding the\r
- * ToolTip as the mouse moves within the target.</p>\r
- * <p>When specified, the child element of the target which caused a show\r
- * event is placed into the <code>{@link #triggerElement}</code> property\r
- * before the ToolTip is shown.</p>\r
- * <p>This may be useful when a Component has regular, repeating elements\r
- * in it, each of which need a Tooltip which contains information specific\r
- * to that element. For example:</p><pre><code>\r
-var myGrid = new Ext.grid.gridPanel(gridConfig);\r
-myGrid.on('render', function(grid) {\r
- var store = grid.getStore(); // Capture the Store.\r
- var view = grid.getView(); // Capture the GridView.\r
- myGrid.tip = new Ext.ToolTip({\r
- target: view.mainBody, // The overall target element.\r
- delegate: '.x-grid3-row', // Each grid row causes its own seperate show and hide.\r
- trackMouse: true, // Moving within the row should not hide the tip.\r
- renderTo: document.body, // Render immediately so that tip.body can be\r
- // referenced prior to the first show.\r
- listeners: { // Change content dynamically depending on which element\r
- // triggered the show.\r
- beforeshow: function updateTipBody(tip) {\r
- var rowIndex = view.findRowIndex(tip.triggerElement);\r
- tip.body.dom.innerHTML = 'Over Record ID ' + store.getAt(rowIndex).id;\r
- }\r
- }\r
- });\r
-});\r
- *</code></pre>\r
- */\r
-\r
- // private\r
- targetCounter : 0,\r
-\r
- constrainPosition : false,\r
-\r
- // private\r
- initComponent : function(){\r
- Ext.ToolTip.superclass.initComponent.call(this);\r
- this.lastActive = new Date();\r
- this.initTarget(this.target);\r
- this.origAnchor = this.anchor;\r
- },\r
-\r
- // private\r
- onRender : function(ct, position){\r
- Ext.ToolTip.superclass.onRender.call(this, ct, position);\r
- this.anchorCls = 'x-tip-anchor-' + this.getAnchorPosition();\r
- this.anchorEl = this.el.createChild({\r
- cls: 'x-tip-anchor ' + this.anchorCls\r
- });\r
- },\r
-\r
- // private\r
- afterRender : function(){\r
- Ext.ToolTip.superclass.afterRender.call(this);\r
- this.anchorEl.setStyle('z-index', this.el.getZIndex() + 1);\r
- },\r
-\r
- <div id="method-Ext.ToolTip-initTarget"></div>/**\r
- * Binds this ToolTip to the specified element. The tooltip will be displayed when the mouse moves over the element.\r
- * @param {Mixed} t The Element, HtmlElement, or ID of an element to bind to\r
- */\r
- initTarget : function(target){\r
- var t;\r
- if((t = Ext.get(target))){\r
- if(this.target){\r
- var tg = Ext.get(this.target);\r
- this.mun(tg, 'mouseover', this.onTargetOver, this);\r
- this.mun(tg, 'mouseout', this.onTargetOut, this);\r
- this.mun(tg, 'mousemove', this.onMouseMove, this);\r
- }\r
- this.mon(t, {\r
- mouseover: this.onTargetOver,\r
- mouseout: this.onTargetOut,\r
- mousemove: this.onMouseMove,\r
- scope: this\r
- });\r
- this.target = t;\r
- }\r
- if(this.anchor){\r
- this.anchorTarget = this.target;\r
- }\r
- },\r
-\r
- // private\r
- onMouseMove : function(e){\r
- var t = this.delegate ? e.getTarget(this.delegate) : this.triggerElement = true;\r
- if (t) {\r
- this.targetXY = e.getXY();\r
- if (t === this.triggerElement) {\r
- if(!this.hidden && this.trackMouse){\r
- this.setPagePosition(this.getTargetXY());\r
- }\r
- } else {\r
- this.hide();\r
- this.lastActive = new Date(0);\r
- this.onTargetOver(e);\r
- }\r
- } else if (!this.closable && this.isVisible()) {\r
- this.hide();\r
- }\r
- },\r
-\r
- // private\r
- getTargetXY : function(){\r
- if(this.delegate){\r
- this.anchorTarget = this.triggerElement;\r
- }\r
- if(this.anchor){\r
- this.targetCounter++;\r
- var offsets = this.getOffsets();\r
- var xy = (this.anchorToTarget && !this.trackMouse) ?\r
- this.el.getAlignToXY(this.anchorTarget, this.getAnchorAlign()) :\r
- this.targetXY;\r
-\r
- var dw = Ext.lib.Dom.getViewWidth()-5;\r
- var dh = Ext.lib.Dom.getViewHeight()-5;\r
- var scrollX = (document.documentElement.scrollLeft || document.body.scrollLeft || 0)+5;\r
- var scrollY = (document.documentElement.scrollTop || document.body.scrollTop || 0)+5;\r
-\r
- var axy = [xy[0] + offsets[0], xy[1] + offsets[1]];\r
- var sz = this.getSize();\r
- this.anchorEl.removeClass(this.anchorCls);\r
-\r
- if(this.targetCounter < 2){\r
- if(axy[0] < scrollX){\r
- if(this.anchorToTarget){\r
- this.defaultAlign = 'l-r';\r
- if(this.mouseOffset){this.mouseOffset[0] *= -1;}\r
- }\r
- this.anchor = 'left';\r
- return this.getTargetXY();\r
- }\r
- if(axy[0]+sz.width > dw){\r
- if(this.anchorToTarget){\r
- this.defaultAlign = 'r-l';\r
- if(this.mouseOffset){this.mouseOffset[0] *= -1;}\r
- }\r
- this.anchor = 'right';\r
- return this.getTargetXY();\r
- }\r
- if(axy[1] < scrollY){\r
- if(this.anchorToTarget){\r
- this.defaultAlign = 't-b';\r
- if(this.mouseOffset){this.mouseOffset[1] *= -1;}\r
- }\r
- this.anchor = 'top';\r
- return this.getTargetXY();\r
- }\r
- if(axy[1]+sz.height > dh){\r
- if(this.anchorToTarget){\r
- this.defaultAlign = 'b-t';\r
- if(this.mouseOffset){this.mouseOffset[1] *= -1;}\r
- }\r
- this.anchor = 'bottom';\r
- return this.getTargetXY();\r
- }\r
- }\r
-\r
- this.anchorCls = 'x-tip-anchor-'+this.getAnchorPosition();\r
- this.anchorEl.addClass(this.anchorCls);\r
- this.targetCounter = 0;\r
- return axy;\r
- }else{\r
- var mouseOffset = this.getMouseOffset();\r
- return [this.targetXY[0]+mouseOffset[0], this.targetXY[1]+mouseOffset[1]];\r
- }\r
- },\r
-\r
- getMouseOffset : function(){\r
- var offset = this.anchor ? [0,0] : [15,18];\r
- if(this.mouseOffset){\r
- offset[0] += this.mouseOffset[0];\r
- offset[1] += this.mouseOffset[1];\r
- }\r
- return offset;\r
- },\r
-\r
- // private\r
- getAnchorPosition : function(){\r
- if(this.anchor){\r
- this.tipAnchor = this.anchor.charAt(0);\r
- }else{\r
- var m = this.defaultAlign.match(/^([a-z]+)-([a-z]+)(\?)?$/);\r
- if(!m){\r
- throw 'AnchorTip.defaultAlign is invalid';\r
- }\r
- this.tipAnchor = m[1].charAt(0);\r
- }\r
-\r
- switch(this.tipAnchor){\r
- case 't': return 'top';\r
- case 'b': return 'bottom';\r
- case 'r': return 'right';\r
- }\r
- return 'left';\r
- },\r
-\r
- // private\r
- getAnchorAlign : function(){\r
- switch(this.anchor){\r
- case 'top' : return 'tl-bl';\r
- case 'left' : return 'tl-tr';\r
- case 'right': return 'tr-tl';\r
- default : return 'bl-tl';\r
- }\r
- },\r
-\r
- // private\r
- getOffsets : function(){\r
- var offsets, ap = this.getAnchorPosition().charAt(0);\r
- if(this.anchorToTarget && !this.trackMouse){\r
- switch(ap){\r
- case 't':\r
- offsets = [0, 9];\r
- break;\r
- case 'b':\r
- offsets = [0, -13];\r
- break;\r
- case 'r':\r
- offsets = [-13, 0];\r
- break;\r
- default:\r
- offsets = [9, 0];\r
- break;\r
- }\r
- }else{\r
- switch(ap){\r
- case 't':\r
- offsets = [-15-this.anchorOffset, 30];\r
- break;\r
- case 'b':\r
- offsets = [-19-this.anchorOffset, -13-this.el.dom.offsetHeight];\r
- break;\r
- case 'r':\r
- offsets = [-15-this.el.dom.offsetWidth, -13-this.anchorOffset];\r
- break;\r
- default:\r
- offsets = [25, -13-this.anchorOffset];\r
- break;\r
- }\r
- }\r
- var mouseOffset = this.getMouseOffset();\r
- offsets[0] += mouseOffset[0];\r
- offsets[1] += mouseOffset[1];\r
-\r
- return offsets;\r
- },\r
-\r
- // private\r
- onTargetOver : function(e){\r
- if(this.disabled || e.within(this.target.dom, true)){\r
- return;\r
- }\r
- var t = e.getTarget(this.delegate);\r
- if (t) {\r
- this.triggerElement = t;\r
- this.clearTimer('hide');\r
- this.targetXY = e.getXY();\r
- this.delayShow();\r
- }\r
- },\r
-\r
- // private\r
- delayShow : function(){\r
- if(this.hidden && !this.showTimer){\r
- if(this.lastActive.getElapsed() < this.quickShowInterval){\r
- this.show();\r
- }else{\r
- this.showTimer = this.show.defer(this.showDelay, this);\r
- }\r
- }else if(!this.hidden && this.autoHide !== false){\r
- this.show();\r
- }\r
- },\r
-\r
- // private\r
- onTargetOut : function(e){\r
- if(this.disabled || e.within(this.target.dom, true)){\r
- return;\r
- }\r
- this.clearTimer('show');\r
- if(this.autoHide !== false){\r
- this.delayHide();\r
- }\r
- },\r
-\r
- // private\r
- delayHide : function(){\r
- if(!this.hidden && !this.hideTimer){\r
- this.hideTimer = this.hide.defer(this.hideDelay, this);\r
- }\r
- },\r
-\r
- <div id="method-Ext.ToolTip-hide"></div>/**\r
- * Hides this tooltip if visible.\r
- */\r
- hide: function(){\r
- this.clearTimer('dismiss');\r
- this.lastActive = new Date();\r
- if(this.anchorEl){\r
- this.anchorEl.hide();\r
- }\r
- Ext.ToolTip.superclass.hide.call(this);\r
- delete this.triggerElement;\r
- },\r
-\r
- <div id="method-Ext.ToolTip-show"></div>/**\r
- * Shows this tooltip at the current event target XY position.\r
- */\r
- show : function(){\r
- if(this.anchor){\r
- // pre-show it off screen so that the el will have dimensions\r
- // for positioning calcs when getting xy next\r
- this.showAt([-1000,-1000]);\r
- this.origConstrainPosition = this.constrainPosition;\r
- this.constrainPosition = false;\r
- this.anchor = this.origAnchor;\r
- }\r
- this.showAt(this.getTargetXY());\r
-\r
- if(this.anchor){\r
- this.syncAnchor();\r
- this.anchorEl.show();\r
- this.constrainPosition = this.origConstrainPosition;\r
- }else{\r
- this.anchorEl.hide();\r
- }\r
- },\r
-\r
- // inherit docs\r
- showAt : function(xy){\r
- this.lastActive = new Date();\r
- this.clearTimers();\r
- Ext.ToolTip.superclass.showAt.call(this, xy);\r
- if(this.dismissDelay && this.autoHide !== false){\r
- this.dismissTimer = this.hide.defer(this.dismissDelay, this);\r
- }\r
- if(this.anchor && !this.anchorEl.isVisible()){\r
- this.syncAnchor();\r
- this.anchorEl.show();\r
- }\r
- },\r
-\r
- // private\r
- syncAnchor : function(){\r
- var anchorPos, targetPos, offset;\r
- switch(this.tipAnchor.charAt(0)){\r
- case 't':\r
- anchorPos = 'b';\r
- targetPos = 'tl';\r
- offset = [20+this.anchorOffset, 2];\r
- break;\r
- case 'r':\r
- anchorPos = 'l';\r
- targetPos = 'tr';\r
- offset = [-2, 11+this.anchorOffset];\r
- break;\r
- case 'b':\r
- anchorPos = 't';\r
- targetPos = 'bl';\r
- offset = [20+this.anchorOffset, -2];\r
- break;\r
- default:\r
- anchorPos = 'r';\r
- targetPos = 'tl';\r
- offset = [2, 11+this.anchorOffset];\r
- break;\r
- }\r
- this.anchorEl.alignTo(this.el, anchorPos+'-'+targetPos, offset);\r
- },\r
-\r
- // private\r
- setPagePosition : function(x, y){\r
- Ext.ToolTip.superclass.setPagePosition.call(this, x, y);\r
- if(this.anchor){\r
- this.syncAnchor();\r
- }\r
- },\r
-\r
- // private\r
- clearTimer : function(name){\r
- name = name + 'Timer';\r
- clearTimeout(this[name]);\r
- delete this[name];\r
- },\r
-\r
- // private\r
- clearTimers : function(){\r
- this.clearTimer('show');\r
- this.clearTimer('dismiss');\r
- this.clearTimer('hide');\r
- },\r
-\r
- // private\r
- onShow : function(){\r
- Ext.ToolTip.superclass.onShow.call(this);\r
- Ext.getDoc().on('mousedown', this.onDocMouseDown, this);\r
- },\r
-\r
- // private\r
- onHide : function(){\r
- Ext.ToolTip.superclass.onHide.call(this);\r
- Ext.getDoc().un('mousedown', this.onDocMouseDown, this);\r
- },\r
-\r
- // private\r
- onDocMouseDown : function(e){\r
- if(this.autoHide !== true && !this.closable && !e.within(this.el.dom)){\r
- this.disable();\r
- this.enable.defer(100, this);\r
- }\r
- },\r
-\r
- // private\r
- onDisable : function(){\r
- this.clearTimers();\r
- this.hide();\r
- },\r
-\r
- // private\r
- adjustPosition : function(x, y){\r
- if(this.contstrainPosition){\r
- var ay = this.targetXY[1], h = this.getSize().height;\r
- if(y <= ay && (y+h) >= ay){\r
- y = ay-h-5;\r
- }\r
- }\r
- return {x : x, y: y};\r
- },\r
-\r
- // private\r
- onDestroy : function(){\r
- Ext.getDoc().un('mousedown', this.onDocMouseDown, this);\r
- Ext.ToolTip.superclass.onDestroy.call(this);\r
- }\r
-});\r
-\r
-Ext.reg('tooltip', Ext.ToolTip);</pre>
+Ext.define('Ext.tip.ToolTip', {
+ extend: 'Ext.tip.Tip',
+ alias: 'widget.tooltip',
+ alternateClassName: 'Ext.ToolTip',
+<span id='Ext-tip-ToolTip-property-triggerElement'> /**
+</span> * @property {HTMLElement} triggerElement
+ * 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.
+ */
+<span id='Ext-tip-ToolTip-cfg-target'> /**
+</span> * @cfg {HTMLElement/Ext.Element/String} target
+ * The target element or string id to monitor for mouseover events to trigger
+ * showing this ToolTip.
+ */
+<span id='Ext-tip-ToolTip-cfg-autoHide'> /**
+</span> * @cfg {Boolean} [autoHide=true]
+ * True to automatically hide the tooltip after the
+ * mouse exits the target element or after the `{@link #dismissDelay}`
+ * has expired if set. If `{@link #closable} = true`
+ * a close tool button will be rendered into the tooltip header.
+ */
+<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.
+ */
+ 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.
+ * Set to 0 for the tooltip to hide immediately.
+ */
+ hideDelay: 200,
+<span id='Ext-tip-ToolTip-cfg-dismissDelay'> /**
+</span> * @cfg {Number} dismissDelay
+ * Delay in milliseconds before the tooltip automatically hides. To disable automatic hiding, set
+ * dismissDelay = 0.
+ */
+ dismissDelay: 5000,
+<span id='Ext-tip-ToolTip-cfg-mouseOffset'> /**
+</span> * @cfg {Number[]} [mouseOffset=[15,18]]
+ * An XY offset from the mouse position where the tooltip should be shown.
+ */
+<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.
+ */
+ 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 ("top", "right", "bottom",
+ * or "left"), 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.
+ * When `anchorToTarget` is true, use `{@link #defaultAlign}` to control tooltip alignment to the
+ * target element. When `anchorToTarget` is false, use `{@link #anchor}` instead to control alignment.
+ */
+ 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. 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,
+<span id='Ext-tip-ToolTip-cfg-delegate'> /**
+</span> * @cfg {String} delegate
+ *
+ * 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.
+ *
+ * See the delegate example in class documentation of {@link Ext.tip.ToolTip}.
+ */
+
+ // private
+ targetCounter: 0,
+ quickShowInterval: 250,
+
+ // private
+ 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) {
+ 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() {
+ var me = this,
+ zIndex;
+
+ me.callParent(arguments);
+ zIndex = parseInt(me.el.getZIndex(), 10) || 0;
+ me.anchorEl.setStyle('z-index', zIndex + 1).setVisibilityMode(Ext.Element.DISPLAY);
+ },
+
+<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 {String/HTMLElement/Ext.Element} t The Element, HtmlElement, or ID of an element to bind to
+ */
+ 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
+ });
+ }
+ if (me.anchor) {
+ me.anchorTarget = me.target;
+ }
+ },
+
+ // private
+ onMouseMove: function(e) {
+ var me = this,
+ t = me.delegate ? e.getTarget(me.delegate) : me.triggerElement = true,
+ xy;
+ if (t) {
+ me.targetXY = e.getXY();
+ if (t === me.triggerElement) {
+ if (!me.hidden && me.trackMouse) {
+ xy = me.getTargetXY();
+ if (me.constrainPosition) {
+ xy = me.el.adjustForConstraints(xy, me.el.getScopeParent());
+ }
+ me.setPagePosition(xy);
+ }
+ } else {
+ me.hide();
+ me.lastActive = new Date(0);
+ me.onTargetOver(e);
+ }
+ } else if ((!me.closable && me.isVisible()) && me.autoHide !== false) {
+ me.hide();
+ }
+ },
+
+ // private
+ getTargetXY: function() {
+ var me = this,
+ mouseOffset;
+ if (me.delegate) {
+ me.anchorTarget = me.triggerElement;
+ }
+ if (me.anchor) {
+ me.targetCounter++;
+ var offsets = me.getOffsets(),
+ xy = (me.anchorToTarget && !me.trackMouse) ? me.el.getAlignToXY(me.anchorTarget, me.getAnchorAlign()) : me.targetXY,
+ dw = Ext.Element.getViewWidth() - 5,
+ dh = Ext.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 < 2 && constrainPosition) {
+ if (axy[0] < scrollX) {
+ if (me.anchorToTarget) {
+ me.defaultAlign = 'l-r';
+ if (me.mouseOffset) {
+ me.mouseOffset[0] *= -1;
+ }
+ }
+ me.anchor = 'left';
+ return me.getTargetXY();
+ }
+ if (axy[0] + sz.width > dw) {
+ if (me.anchorToTarget) {
+ me.defaultAlign = 'r-l';
+ if (me.mouseOffset) {
+ me.mouseOffset[0] *= -1;
+ }
+ }
+ me.anchor = 'right';
+ return me.getTargetXY();
+ }
+ if (axy[1] < scrollY) {
+ if (me.anchorToTarget) {
+ me.defaultAlign = 't-b';
+ if (me.mouseOffset) {
+ me.mouseOffset[1] *= -1;
+ }
+ }
+ me.anchor = 'top';
+ return me.getTargetXY();
+ }
+ if (axy[1] + sz.height > dh) {
+ if (me.anchorToTarget) {
+ me.defaultAlign = 'b-t';
+ if (me.mouseOffset) {
+ me.mouseOffset[1] *= -1;
+ }
+ }
+ me.anchor = 'bottom';
+ return me.getTargetXY();
+ }
+ }
+
+ me.anchorCls = Ext.baseCSSPrefix + 'tip-anchor-' + me.getAnchorPosition();
+ me.anchorEl.addCls(me.anchorCls);
+ me.targetCounter = 0;
+ return axy;
+ } else {
+ mouseOffset = me.getMouseOffset();
+ return (me.targetXY) ? [me.targetXY[0] + mouseOffset[0], me.targetXY[1] + mouseOffset[1]] : mouseOffset;
+ }
+ },
+
+ 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() {
+ var me = this,
+ m;
+ if (me.anchor) {
+ me.tipAnchor = me.anchor.charAt(0);
+ } else {
+ m = me.defaultAlign.match(/^([a-z]+)-([a-z]+)(\?)?$/);
+ //<debug>
+ if (!m) {
+ Ext.Error.raise('The AnchorTip.defaultAlign value "' + me.defaultAlign + '" is invalid.');
+ }
+ //</debug>
+ me.tipAnchor = m[1].charAt(0);
+ }
+
+ 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';
+ }
+ },
+
+ // private
+ getOffsets: function() {
+ var me = this,
+ mouseOffset,
+ offsets,
+ ap = me.getAnchorPosition().charAt(0);
+ if (me.anchorToTarget && !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 - 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;
+ }
+ }
+ mouseOffset = me.getMouseOffset();
+ offsets[0] += mouseOffset[0];
+ offsets[1] += mouseOffset[1];
+
+ return offsets;
+ },
+
+ // private
+ onTargetOver: function(e) {
+ var me = this,
+ t;
+
+ if (me.disabled || e.within(me.target.dom, true)) {
+ return;
+ }
+ t = e.getTarget(me.delegate);
+ if (t) {
+ me.triggerElement = t;
+ me.clearTimer('hide');
+ me.targetXY = e.getXY();
+ me.delayShow();
+ }
+ },
+
+ // private
+ delayShow: function() {
+ var me = this;
+ if (me.hidden && !me.showTimer) {
+ if (Ext.Date.getElapsed(me.lastActive) < me.quickShowInterval) {
+ me.show();
+ } else {
+ me.showTimer = Ext.defer(me.show, me.showDelay, me);
+ }
+ }
+ else if (!me.hidden && me.autoHide !== false) {
+ me.show();
+ }
+ },
+
+ // private
+ onTargetOut: function(e) {
+ var me = this;
+ if (me.disabled || e.within(me.target.dom, true)) {
+ return;
+ }
+ me.clearTimer('show');
+ if (me.autoHide !== false) {
+ me.delayHide();
+ }
+ },
+
+ // private
+ delayHide: function() {
+ var me = this;
+ if (!me.hidden && !me.hideTimer) {
+ me.hideTimer = Ext.defer(me.hide, me.hideDelay, me);
+ }
+ },
+
+<span id='Ext-tip-ToolTip-method-hide'> /**
+</span> * Hides this tooltip if visible.
+ */
+ hide: function() {
+ var me = this;
+ me.clearTimer('dismiss');
+ me.lastActive = new Date();
+ if (me.anchorEl) {
+ me.anchorEl.hide();
+ }
+ me.callParent(arguments);
+ delete me.triggerElement;
+ },
+
+<span id='Ext-tip-ToolTip-method-show'> /**
+</span> * Shows this tooltip at the current event target XY position.
+ */
+ 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) {
+ 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);
+ }
+
+ // 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 && 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 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;
+ }
+ me.anchorEl.alignTo(me.el, anchorPos + '-' + targetPos, offset);
+ },
+
+ // private
+ setPagePosition: function(x, y) {
+ var me = this;
+ me.callParent(arguments);
+ if (me.anchor) {
+ me.syncAnchor();
+ }
+ },
+
+ // private
+ clearTimer: function(name) {
+ name = name + 'Timer';
+ clearTimeout(this[name]);
+ delete this[name];
+ },
+
+ // private
+ clearTimers: function() {
+ var me = this;
+ me.clearTimer('show');
+ me.clearTimer('dismiss');
+ me.clearTimer('hide');
+ },
+
+ // private
+ onShow: function() {
+ var me = this;
+ me.callParent();
+ me.mon(Ext.getDoc(), 'mousedown', me.onDocMouseDown, me);
+ },
+
+ // private
+ onHide: function() {
+ var me = this;
+ me.callParent();
+ me.mun(Ext.getDoc(), 'mousedown', me.onDocMouseDown, me);
+ },
+
+ // private
+ onDocMouseDown: function(e) {
+ var me = this;
+ if (me.autoHide !== true && !me.closable && !e.within(me.el.dom)) {
+ me.disable();
+ Ext.defer(me.doEnable, 100, me);
+ }
+ },
+
+ // private
+ doEnable: function() {
+ if (!this.isDestroyed) {
+ this.enable();
+ }
+ },
+
+ // private
+ onDisable: function() {
+ this.callParent();
+ this.clearTimers();
+ this.hide();
+ },
+
+ 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() {
+ Ext.getDoc().un('mousedown', this.onDocMouseDown, this);
+ this.callParent();
+ }
+});
+</pre>
</body>
-</html>
\ No newline at end of file
+</html>
git.ithinksw.org / extjs.git / blobdiff