Upgrade to ExtJS 4.0.0 - Released 04/26/2011
[extjs.git] / docs / source / Tip3.html
diff --git a/docs/source/Tip3.html b/docs/source/Tip3.html
new file mode 100644 (file)
index 0000000..d1d06dc
--- /dev/null
@@ -0,0 +1,137 @@
+<!DOCTYPE html><html><head><title>Sencha Documentation Project</title><link rel="stylesheet" href="../reset.css" type="text/css"><link rel="stylesheet" href="../prettify.css" type="text/css"><link rel="stylesheet" href="../prettify_sa.css" type="text/css"><script type="text/javascript" src="../prettify.js"></script></head><body onload="prettyPrint()"><pre class="prettyprint"><pre><span id='Ext-tip.Tip-method-constructor'><span id='Ext-tip.Tip'>/**
+</span></span> * @class Ext.tip.Tip
+ * @extends Ext.panel.Panel
+ * This is the base class for {@link Ext.tip.QuickTip} and {@link Ext.tip.ToolTip} that provides the basic layout and
+ * positioning that all tip-based classes require. This class can be used directly for simple, statically-positioned
+ * tips that are displayed programmatically, or it can be extended to provide custom tip implementations.
+ * @constructor
+ * Create a new Tip
+ * @param {Object} config The configuration options
+ * @xtype tip
+ */
+Ext.define('Ext.tip.Tip', {
+    extend: 'Ext.panel.Panel',
+    requires: [ 'Ext.layout.component.Tip' ],
+    alternateClassName: 'Ext.Tip',
+<span id='Ext-tip.Tip-cfg-closable'>    /**
+</span>     * @cfg {Boolean} closable True to render a close tool button into the tooltip header (defaults to false).
+     */
+<span id='Ext-tip.Tip-cfg-width'>    /**
+</span>     * @cfg {Number} width
+     * Width in pixels of the tip (defaults to auto).  Width will be ignored if it exceeds the bounds of
+     * {@link #minWidth} or {@link #maxWidth}.  The maximum supported value is 500.
+     */
+<span id='Ext-tip.Tip-cfg-minWidth'>    /**
+</span>     * @cfg {Number} minWidth The minimum width of the tip in pixels (defaults to 40).
+     */
+    minWidth : 40,
+<span id='Ext-tip.Tip-cfg-maxWidth'>    /**
+</span>     * @cfg {Number} maxWidth The maximum width of the tip in pixels (defaults to 300).  The maximum supported value is 500.
+     */
+    maxWidth : 300,
+<span id='Ext-tip.Tip-cfg-shadow'>    /**
+</span>     * @cfg {Boolean/String} shadow True or &quot;sides&quot; for the default effect, &quot;frame&quot; for 4-way shadow, and &quot;drop&quot;
+     * for bottom-right shadow (defaults to &quot;sides&quot;).
+     */
+    shadow : &quot;sides&quot;,
+
+<span id='Ext-tip.Tip-cfg-defaultAlign'>    /**
+</span>     * @cfg {String} defaultAlign &lt;b&gt;Experimental&lt;/b&gt;. The default {@link Ext.core.Element#alignTo} anchor position value
+     * for this tip relative to its element of origin (defaults to &quot;tl-bl?&quot;).
+     */
+    defaultAlign : &quot;tl-bl?&quot;,
+<span id='Ext-tip.Tip-cfg-constrainPosition'>    /**
+</span>     * @cfg {Boolean} constrainPosition If true, then the tooltip will be automatically constrained to stay within
+     * the browser viewport. Defaults to false.
+     */
+    constrainPosition : true,
+
+<span id='Ext-tip.Tip-property-frame'>    /**
+</span>     * @inherited
+     */
+    frame: false,
+
+    // private panel overrides
+    autoRender: true,
+    hidden: true,
+    baseCls: Ext.baseCSSPrefix + 'tip',
+    floating: {
+        shadow: true,
+        shim: true,
+        constrain: true
+    },
+    focusOnToFront: false,
+    componentLayout: 'tip',
+
+    closeAction: 'hide',
+
+    ariaRole: 'tooltip',
+
+    initComponent: function() {
+        this.callParent(arguments);
+
+        // Or in the deprecated config. Floating.doConstrain only constrains if the constrain property is truthy.
+        this.constrain = this.constrain || this.constrainPosition;
+    },
+
+<span id='Ext-tip.Tip-method-showAt'>    /**
+</span>     * Shows this tip at the specified XY position.  Example usage:
+     * &lt;pre&gt;&lt;code&gt;
+// Show the tip at x:50 and y:100
+tip.showAt([50,100]);
+&lt;/code&gt;&lt;/pre&gt;
+     * @param {Array} xy An array containing the x and y coordinates
+     */
+    showAt : function(xy){
+        var me = this;
+        this.callParent();
+        // Show may have been vetoed.
+        if (me.isVisible()) {
+            me.setPagePosition(xy[0], xy[1]);
+            if (me.constrainPosition || me.constrain) {
+                me.doConstrain();
+            }
+            me.toFront(true);
+        }
+    },
+
+<span id='Ext-tip.Tip-method-showBy'>    /**
+</span>     * &lt;b&gt;Experimental&lt;/b&gt;. Shows this tip at a position relative to another element using a standard {@link Ext.core.Element#alignTo}
+     * anchor position value.  Example usage:
+     * &lt;pre&gt;&lt;code&gt;
+// Show the tip at the default position ('tl-br?')
+tip.showBy('my-el');
+
+// Show the tip's top-left corner anchored to the element's top-right corner
+tip.showBy('my-el', 'tl-tr');
+&lt;/code&gt;&lt;/pre&gt;
+     * @param {Mixed} el An HTMLElement, Ext.core.Element or string id of the target element to align to
+     * @param {String} position (optional) A valid {@link Ext.core.Element#alignTo} anchor position (defaults to 'tl-br?' or
+     * {@link #defaultAlign} if specified).
+     */
+    showBy : function(el, pos) {
+        this.showAt(this.el.getAlignToXY(el, pos || this.defaultAlign));
+    },
+
+<span id='Ext-tip.Tip-method-initDraggable'>    /**
+</span>     * @private
+     * @override
+     * Set Tip draggable using base Component's draggability
+     */
+    initDraggable : function(){
+        var me = this;
+        me.draggable = {
+            el: me.getDragEl(),
+            delegate: me.header.el,
+            constrain: me,
+            constrainTo: me.el.dom.parentNode
+        };
+        // Important: Bypass Panel's initDraggable. Call direct to Component's implementation.
+        Ext.Component.prototype.initDraggable.call(me);
+    },
+
+    // Tip does not ghost. Drag is &quot;live&quot;
+    ghost: undefined,
+    unghost: undefined
+});
+</pre></pre></body></html>
\ No newline at end of file