--- /dev/null
+/*!
+ * Ext JS Library 3.0.0
+ * Copyright(c) 2006-2009 Ext JS, LLC
+ * licensing@extjs.com
+ * http://www.extjs.com/license
+ */
+/**\r
+ * @class Ext.Tip\r
+ * @extends Ext.Panel\r
+ * This is the base class for {@link Ext.QuickTip} and {@link Ext.Tooltip} that provides the basic layout and\r
+ * positioning that all tip-based classes require. This class can be used directly for simple, statically-positioned\r
+ * tips that are displayed programmatically, or it can be extended to provide custom tip implementations.\r
+ * @constructor\r
+ * Create a new Tip\r
+ * @param {Object} config The configuration options\r
+ */\r
+Ext.Tip = Ext.extend(Ext.Panel, {\r
+ /**\r
+ * @cfg {Boolean} closable True to render a close tool button into the tooltip header (defaults to false).\r
+ */\r
+ /**\r
+ * @cfg {Number} width\r
+ * Width in pixels of the tip (defaults to auto). Width will be ignored if it exceeds the bounds of\r
+ * {@link #minWidth} or {@link #maxWidth}. The maximum supported value is 500.\r
+ */\r
+ /**\r
+ * @cfg {Number} minWidth The minimum width of the tip in pixels (defaults to 40).\r
+ */\r
+ minWidth : 40,\r
+ /**\r
+ * @cfg {Number} maxWidth The maximum width of the tip in pixels (defaults to 300). The maximum supported value is 500.\r
+ */\r
+ maxWidth : 300,\r
+ /**\r
+ * @cfg {Boolean/String} shadow True or "sides" for the default effect, "frame" for 4-way shadow, and "drop"\r
+ * for bottom-right shadow (defaults to "sides").\r
+ */\r
+ shadow : "sides",\r
+ /**\r
+ * @cfg {String} defaultAlign <b>Experimental</b>. The default {@link Ext.Element#alignTo} anchor position value\r
+ * for this tip relative to its element of origin (defaults to "tl-bl?").\r
+ */\r
+ defaultAlign : "tl-bl?",\r
+ autoRender: true,\r
+ quickShowInterval : 250,\r
+\r
+ // private panel overrides\r
+ frame:true,\r
+ hidden:true,\r
+ baseCls: 'x-tip',\r
+ floating:{shadow:true,shim:true,useDisplay:true,constrain:false},\r
+ autoHeight:true,\r
+\r
+ closeAction: 'hide',\r
+\r
+ // private\r
+ initComponent : function(){\r
+ Ext.Tip.superclass.initComponent.call(this);\r
+ if(this.closable && !this.title){\r
+ this.elements += ',header';\r
+ }\r
+ },\r
+\r
+ // private\r
+ afterRender : function(){\r
+ Ext.Tip.superclass.afterRender.call(this);\r
+ if(this.closable){\r
+ this.addTool({\r
+ id: 'close',\r
+ handler: this[this.closeAction],\r
+ scope: this\r
+ });\r
+ }\r
+ },\r
+\r
+ /**\r
+ * Shows this tip at the specified XY position. Example usage:\r
+ * <pre><code>\r
+// Show the tip at x:50 and y:100\r
+tip.showAt([50,100]);\r
+</code></pre>\r
+ * @param {Array} xy An array containing the x and y coordinates\r
+ */\r
+ showAt : function(xy){\r
+ Ext.Tip.superclass.show.call(this);\r
+ if(this.measureWidth !== false && (!this.initialConfig || typeof this.initialConfig.width != 'number')){\r
+ this.doAutoWidth();\r
+ }\r
+ if(this.constrainPosition){\r
+ xy = this.el.adjustForConstraints(xy);\r
+ }\r
+ this.setPagePosition(xy[0], xy[1]);\r
+ },\r
+\r
+ // protected\r
+ doAutoWidth : function(){\r
+ var bw = this.body.getTextWidth();\r
+ if(this.title){\r
+ bw = Math.max(bw, this.header.child('span').getTextWidth(this.title));\r
+ }\r
+ bw += this.getFrameWidth() + (this.closable ? 20 : 0) + this.body.getPadding("lr");\r
+ this.setWidth(bw.constrain(this.minWidth, this.maxWidth));\r
+ \r
+ // IE7 repaint bug on initial show\r
+ if(Ext.isIE7 && !this.repainted){\r
+ this.el.repaint();\r
+ this.repainted = true;\r
+ }\r
+ },\r
+\r
+ /**\r
+ * <b>Experimental</b>. Shows this tip at a position relative to another element using a standard {@link Ext.Element#alignTo}\r
+ * anchor position value. Example usage:\r
+ * <pre><code>\r
+// Show the tip at the default position ('tl-br?')\r
+tip.showBy('my-el');\r
+\r
+// Show the tip's top-left corner anchored to the element's top-right corner\r
+tip.showBy('my-el', 'tl-tr');\r
+</code></pre>\r
+ * @param {Mixed} el An HTMLElement, Ext.Element or string id of the target element to align to\r
+ * @param {String} position (optional) A valid {@link Ext.Element#alignTo} anchor position (defaults to 'tl-br?' or\r
+ * {@link #defaultAlign} if specified).\r
+ */\r
+ showBy : function(el, pos){\r
+ if(!this.rendered){\r
+ this.render(Ext.getBody());\r
+ }\r
+ this.showAt(this.el.getAlignToXY(el, pos || this.defaultAlign));\r
+ },\r
+\r
+ initDraggable : function(){\r
+ this.dd = new Ext.Tip.DD(this, typeof this.draggable == 'boolean' ? null : this.draggable);\r
+ this.header.addClass('x-tip-draggable');\r
+ }\r
+});\r
+\r
+// private - custom Tip DD implementation\r
+Ext.Tip.DD = function(tip, config){\r
+ Ext.apply(this, config);\r
+ this.tip = tip;\r
+ Ext.Tip.DD.superclass.constructor.call(this, tip.el.id, 'WindowDD-'+tip.id);\r
+ this.setHandleElId(tip.header.id);\r
+ this.scroll = false;\r
+};\r
+\r
+Ext.extend(Ext.Tip.DD, Ext.dd.DD, {\r
+ moveOnly:true,\r
+ scroll:false,\r
+ headerOffsets:[100, 25],\r
+ startDrag : function(){\r
+ this.tip.el.disableShadow();\r
+ },\r
+ endDrag : function(e){\r
+ this.tip.el.enableShadow(true);\r
+ }\r
+});/**\r
+ * @class Ext.ToolTip\r
+ * @extends Ext.Tip\r
+ * A standard tooltip implementation for providing additional information when hovering over a target element.\r
+ * @constructor\r
+ * Create a new Tooltip\r
+ * @param {Object} config The configuration options\r
+ */\r
+Ext.ToolTip = Ext.extend(Ext.Tip, {\r
+ /**\r
+ * When a Tooltip is configured with the {@link #delegate} option to cause selected child elements of the {@link #target}\r
+ * Element to each trigger a seperate show event, this property is set to the DOM element which triggered the show.\r
+ * @type DOMElement\r
+ * @property triggerElement\r
+ */\r
+ /**\r
+ * @cfg {Mixed} target The target HTMLElement, Ext.Element or id to monitor for mouseover events to trigger\r
+ * showing this ToolTip.\r
+ */\r
+ /**\r
+ * @cfg {Boolean} autoHide True to automatically hide the tooltip after the mouse exits the target element\r
+ * or after the {@link #dismissDelay} has expired if set (defaults to true). If {@link closable} = true a close\r
+ * tool button will be rendered into the tooltip header.\r
+ */\r
+ /**\r
+ * @cfg {Number} showDelay Delay in milliseconds before the tooltip displays after the mouse enters the\r
+ * target element (defaults to 500)\r
+ */\r
+ showDelay: 500,\r
+ /**\r
+ * @cfg {Number} hideDelay Delay in milliseconds after the mouse exits the target element but before the\r
+ * tooltip actually hides (defaults to 200). Set to 0 for the tooltip to hide immediately.\r
+ */\r
+ hideDelay: 200,\r
+ /**\r
+ * @cfg {Number} dismissDelay Delay in milliseconds before the tooltip automatically hides (defaults to 5000).\r
+ * To disable automatic hiding, set dismissDelay = 0.\r
+ */\r
+ dismissDelay: 5000,\r
+ /**\r
+ * @cfg {Array} mouseOffset An XY offset from the mouse position where the tooltip should be shown (defaults to [15,18]).\r
+ */\r
+ /**\r
+ * @cfg {Boolean} trackMouse True to have the tooltip follow the mouse as it moves over the target element (defaults to false).\r
+ */\r
+ trackMouse : false,\r
+ /**\r
+ * @cfg {Boolean} anchorToTarget True to anchor the tooltip to the target element, false to\r
+ * anchor it relative to the mouse coordinates (defaults to true). When anchorToTarget is\r
+ * true, use {@link #defaultAlign} to control tooltip alignment to the target element. When\r
+ * anchorToTarget is false, use {@link #anchorPosition} instead to control alignment.\r
+ */\r
+ anchorToTarget: true,\r
+ /**\r
+ * @cfg {Number} anchorOffset A numeric pixel value used to offset the default position of the\r
+ * anchor arrow (defaults to 0). When the anchor position is on the top or bottom of the tooltip,\r
+ * anchorOffset will be used as a horizontal offset. Likewise, when the anchor position is on the\r
+ * left or right side, anchorOffset will be used as a vertical offset.\r
+ */\r
+ anchorOffset: 0,\r
+ /**\r
+ * @cfg {String} delegate <p>Optional. A {@link Ext.DomQuery DomQuery} selector which allows selection of individual elements\r
+ * within the {@link #target} element to trigger showing and hiding the ToolTip as the mouse moves within the target.</p>\r
+ * <p>When specified, the child element of the target which caused a show event is placed into the {@link #triggerElement} property\r
+ * before the ToolTip is shown.</p>\r
+ * <p>This may be useful when a Component has regular, repeating elements in it, each of which need a Tooltip which contains\r
+ * information specific 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 referenced prior to the first show.\r
+ listeners: { // Change content dynamically depending on which element 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
+});</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
+ /**\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
+ this.target = Ext.get(this.target);\r
+ this.target.un('mouseover', this.onTargetOver, this);\r
+ this.target.un('mouseout', this.onTargetOut, this);\r
+ this.target.un('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.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
+ /**\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
+ /**\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
+ },\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
+ * @class Ext.QuickTip\r
+ * @extends Ext.ToolTip\r
+ * A specialized tooltip class for tooltips that can be specified in markup and automatically managed by the global\r
+ * {@link Ext.QuickTips} instance. See the QuickTips class header for additional usage details and examples.\r
+ * @constructor\r
+ * Create a new Tip\r
+ * @param {Object} config The configuration options\r
+ */\r
+Ext.QuickTip = Ext.extend(Ext.ToolTip, {\r
+ /**\r
+ * @cfg {Mixed} target The target HTMLElement, Ext.Element or id to associate with this quicktip (defaults to the document).\r
+ */\r
+ /**\r
+ * @cfg {Boolean} interceptTitles True to automatically use the element's DOM title value if available (defaults to false).\r
+ */\r
+ interceptTitles : false,\r
+\r
+ // private\r
+ tagConfig : {\r
+ namespace : "ext",\r
+ attribute : "qtip",\r
+ width : "qwidth",\r
+ target : "target",\r
+ title : "qtitle",\r
+ hide : "hide",\r
+ cls : "qclass",\r
+ align : "qalign",\r
+ anchor : "anchor"\r
+ },\r
+\r
+ // private\r
+ initComponent : function(){\r
+ this.target = this.target || Ext.getDoc();\r
+ this.targets = this.targets || {};\r
+ Ext.QuickTip.superclass.initComponent.call(this);\r
+ },\r
+\r
+ /**\r
+ * Configures a new quick tip instance and assigns it to a target element. The following config values are\r
+ * supported (for example usage, see the {@link Ext.QuickTips} class header):\r
+ * <div class="mdetail-params"><ul>\r
+ * <li>autoHide</li>\r
+ * <li>cls</li>\r
+ * <li>dismissDelay (overrides the singleton value)</li>\r
+ * <li>target (required)</li>\r
+ * <li>text (required)</li>\r
+ * <li>title</li>\r
+ * <li>width</li></ul></div>\r
+ * @param {Object} config The config object\r
+ */\r
+ register : function(config){\r
+ var cs = Ext.isArray(config) ? config : arguments;\r
+ for(var i = 0, len = cs.length; i < len; i++){\r
+ var c = cs[i];\r
+ var target = c.target;\r
+ if(target){\r
+ if(Ext.isArray(target)){\r
+ for(var j = 0, jlen = target.length; j < jlen; j++){\r
+ this.targets[Ext.id(target[j])] = c;\r
+ }\r
+ } else{\r
+ this.targets[Ext.id(target)] = c;\r
+ }\r
+ }\r
+ }\r
+ },\r
+\r
+ /**\r
+ * Removes this quick tip from its element and destroys it.\r
+ * @param {String/HTMLElement/Element} el The element from which the quick tip is to be removed.\r
+ */\r
+ unregister : function(el){\r
+ delete this.targets[Ext.id(el)];\r
+ },\r
+ \r
+ /**\r
+ * Hides a visible tip or cancels an impending show for a particular element.\r
+ * @param {String/HTMLElement/Element} el The element that is the target of the tip.\r
+ */\r
+ cancelShow: function(el){\r
+ var at = this.activeTarget;\r
+ el = Ext.get(el).dom;\r
+ if(this.isVisible()){\r
+ if(at && at.el == el){\r
+ this.hide();\r
+ }\r
+ }else if(at && at.el == el){\r
+ this.clearTimer('show');\r
+ }\r
+ },\r
+\r
+ // private\r
+ onTargetOver : function(e){\r
+ if(this.disabled){\r
+ return;\r
+ }\r
+ this.targetXY = e.getXY();\r
+ var t = e.getTarget();\r
+ if(!t || t.nodeType !== 1 || t == document || t == document.body){\r
+ return;\r
+ }\r
+ if(this.activeTarget && t == this.activeTarget.el){\r
+ this.clearTimer('hide');\r
+ this.show();\r
+ return;\r
+ }\r
+ if(t && this.targets[t.id]){\r
+ this.activeTarget = this.targets[t.id];\r
+ this.activeTarget.el = t;\r
+ this.anchor = this.activeTarget.anchor;\r
+ if(this.anchor){\r
+ this.anchorTarget = t;\r
+ }\r
+ this.delayShow();\r
+ return;\r
+ }\r
+ \r
+ var ttp, et = Ext.fly(t), cfg = this.tagConfig;\r
+ var ns = cfg.namespace;\r
+ if(this.interceptTitles && t.title){\r
+ ttp = t.title;\r
+ t.qtip = ttp;\r
+ t.removeAttribute("title");\r
+ e.preventDefault();\r
+ } else{\r
+ ttp = t.qtip || et.getAttribute(cfg.attribute, ns);\r
+ }\r
+ if(ttp){\r
+ var autoHide = et.getAttribute(cfg.hide, ns);\r
+ this.activeTarget = {\r
+ el: t,\r
+ text: ttp,\r
+ width: et.getAttribute(cfg.width, ns),\r
+ autoHide: autoHide != "user" && autoHide !== 'false',\r
+ title: et.getAttribute(cfg.title, ns),\r
+ cls: et.getAttribute(cfg.cls, ns),\r
+ align: et.getAttribute(cfg.align, ns)\r
+ \r
+ };\r
+ this.anchor = et.getAttribute(cfg.anchor, ns);\r
+ if(this.anchor){\r
+ this.anchorTarget = t;\r
+ }\r
+ this.delayShow();\r
+ }\r
+ },\r
+\r
+ // private\r
+ onTargetOut : function(e){\r
+ this.clearTimer('show');\r
+ if(this.autoHide !== false){\r
+ this.delayHide();\r
+ }\r
+ },\r
+\r
+ // inherit docs\r
+ showAt : function(xy){\r
+ var t = this.activeTarget;\r
+ if(t){\r
+ if(!this.rendered){\r
+ this.render(Ext.getBody());\r
+ this.activeTarget = t;\r
+ }\r
+ if(t.width){\r
+ this.setWidth(t.width);\r
+ this.body.setWidth(this.adjustBodyWidth(t.width - this.getFrameWidth()));\r
+ this.measureWidth = false;\r
+ } else{\r
+ this.measureWidth = true;\r
+ }\r
+ this.setTitle(t.title || '');\r
+ this.body.update(t.text);\r
+ this.autoHide = t.autoHide;\r
+ this.dismissDelay = t.dismissDelay || this.dismissDelay;\r
+ if(this.lastCls){\r
+ this.el.removeClass(this.lastCls);\r
+ delete this.lastCls;\r
+ }\r
+ if(t.cls){\r
+ this.el.addClass(t.cls);\r
+ this.lastCls = t.cls;\r
+ }\r
+ if(this.anchor){\r
+ this.constrainPosition = false;\r
+ }else if(t.align){ // TODO: this doesn't seem to work consistently\r
+ xy = this.el.getAlignToXY(t.el, t.align);\r
+ this.constrainPosition = false;\r
+ }else{\r
+ this.constrainPosition = true;\r
+ }\r
+ }\r
+ Ext.QuickTip.superclass.showAt.call(this, xy);\r
+ },\r
+\r
+ // inherit docs\r
+ hide: function(){\r
+ delete this.activeTarget;\r
+ Ext.QuickTip.superclass.hide.call(this);\r
+ }\r
+});/**\r
+ * @class Ext.QuickTips\r
+ * <p>Provides attractive and customizable tooltips for any element. The QuickTips\r
+ * singleton is used to configure and manage tooltips globally for multiple elements\r
+ * in a generic manner. To create individual tooltips with maximum customizability,\r
+ * you should consider either {@link Ext.Tip} or {@link Ext.ToolTip}.</p>\r
+ * <p>Quicktips can be configured via tag attributes directly in markup, or by\r
+ * registering quick tips programmatically via the {@link #register} method.</p>\r
+ * <p>The singleton's instance of {@link Ext.QuickTip} is available via\r
+ * {@link #getQuickTip}, and supports all the methods, and all the all the\r
+ * configuration properties of Ext.QuickTip. These settings will apply to all\r
+ * tooltips shown by the singleton.</p>\r
+ * <p>Below is the summary of the configuration properties which can be used.\r
+ * For detailed descriptions see {@link #getQuickTip}</p>\r
+ * <p><b>QuickTips singleton configs (all are optional)</b></p>\r
+ * <div class="mdetail-params"><ul><li>dismissDelay</li>\r
+ * <li>hideDelay</li>\r
+ * <li>maxWidth</li>\r
+ * <li>minWidth</li>\r
+ * <li>showDelay</li>\r
+ * <li>trackMouse</li></ul></div>\r
+ * <p><b>Target element configs (optional unless otherwise noted)</b></p>\r
+ * <div class="mdetail-params"><ul><li>autoHide</li>\r
+ * <li>cls</li>\r
+ * <li>dismissDelay (overrides singleton value)</li>\r
+ * <li>target (required)</li>\r
+ * <li>text (required)</li>\r
+ * <li>title</li>\r
+ * <li>width</li></ul></div>\r
+ * <p>Here is an example showing how some of these config options could be used:</p>\r
+ * <pre><code>\r
+// Init the singleton. Any tag-based quick tips will start working.\r
+Ext.QuickTips.init();\r
+\r
+// Apply a set of config properties to the singleton\r
+Ext.apply(Ext.QuickTips.getQuickTip(), {\r
+ maxWidth: 200,\r
+ minWidth: 100,\r
+ showDelay: 50,\r
+ trackMouse: true\r
+});\r
+\r
+// Manually register a quick tip for a specific element\r
+Ext.QuickTips.register({\r
+ target: 'my-div',\r
+ title: 'My Tooltip',\r
+ text: 'This tooltip was added in code',\r
+ width: 100,\r
+ dismissDelay: 20\r
+});\r
+</code></pre>\r
+ * <p>To register a quick tip in markup, you simply add one or more of the valid QuickTip attributes prefixed with\r
+ * the <b>ext:</b> namespace. The HTML element itself is automatically set as the quick tip target. Here is the summary\r
+ * of supported attributes (optional unless otherwise noted):</p>\r
+ * <ul><li><b>hide</b>: Specifying "user" is equivalent to setting autoHide = false. Any other value will be the\r
+ * same as autoHide = true.</li>\r
+ * <li><b>qclass</b>: A CSS class to be applied to the quick tip (equivalent to the 'cls' target element config).</li>\r
+ * <li><b>qtip (required)</b>: The quick tip text (equivalent to the 'text' target element config).</li>\r
+ * <li><b>qtitle</b>: The quick tip title (equivalent to the 'title' target element config).</li>\r
+ * <li><b>qwidth</b>: The quick tip width (equivalent to the 'width' target element config).</li></ul>\r
+ * <p>Here is an example of configuring an HTML element to display a tooltip from markup:</p>\r
+ * <pre><code>\r
+// Add a quick tip to an HTML button\r
+<input type="button" value="OK" ext:qtitle="OK Button" ext:qwidth="100"\r
+ ext:qtip="This is a quick tip from markup!"></input>\r
+</code></pre>\r
+ * @singleton\r
+ */\r
+Ext.QuickTips = function(){\r
+ var tip, locks = [];\r
+ return {\r
+ /**\r
+ * Initialize the global QuickTips instance and prepare any quick tips.\r
+ * @param {Boolean} autoRender True to render the QuickTips container immediately to preload images. (Defaults to true) \r
+ */\r
+ init : function(autoRender){\r
+ if(!tip){\r
+ if(!Ext.isReady){\r
+ Ext.onReady(function(){\r
+ Ext.QuickTips.init(autoRender);\r
+ });\r
+ return;\r
+ }\r
+ tip = new Ext.QuickTip({elements:'header,body'});\r
+ if(autoRender !== false){\r
+ tip.render(Ext.getBody());\r
+ }\r
+ }\r
+ },\r
+\r
+ /**\r
+ * Enable quick tips globally.\r
+ */\r
+ enable : function(){\r
+ if(tip){\r
+ locks.pop();\r
+ if(locks.length < 1){\r
+ tip.enable();\r
+ }\r
+ }\r
+ },\r
+\r
+ /**\r
+ * Disable quick tips globally.\r
+ */\r
+ disable : function(){\r
+ if(tip){\r
+ tip.disable();\r
+ }\r
+ locks.push(1);\r
+ },\r
+\r
+ /**\r
+ * Returns true if quick tips are enabled, else false.\r
+ * @return {Boolean}\r
+ */\r
+ isEnabled : function(){\r
+ return tip !== undefined && !tip.disabled;\r
+ },\r
+\r
+ /**\r
+ * Gets the global QuickTips instance.\r
+ */\r
+ getQuickTip : function(){\r
+ return tip;\r
+ },\r
+\r
+ /**\r
+ * Configures a new quick tip instance and assigns it to a target element. See\r
+ * {@link Ext.QuickTip#register} for details.\r
+ * @param {Object} config The config object\r
+ */\r
+ register : function(){\r
+ tip.register.apply(tip, arguments);\r
+ },\r
+\r
+ /**\r
+ * Removes any registered quick tip from the target element and destroys it.\r
+ * @param {String/HTMLElement/Element} el The element from which the quick tip is to be removed.\r
+ */\r
+ unregister : function(){\r
+ tip.unregister.apply(tip, arguments);\r
+ },\r
+\r
+ /**\r
+ * Alias of {@link #register}.\r
+ * @param {Object} config The config object\r
+ */\r
+ tips :function(){\r
+ tip.register.apply(tip, arguments);\r
+ }\r
+ }\r
+}();
\ No newline at end of file
git.ithinksw.org / extjs.git / blobdiff