Upgrade to ExtJS 3.3.1 - Released 11/30/2010
[extjs.git] / docs / output / Ext.layout.AbsoluteLayout.html
1 <div class="body-wrap" xmlns:ext="http://www.extjs.com"><div class="top-tools"><a class="inner-link" href="#Ext.layout.AbsoluteLayout-props"><img src="resources/images/default/s.gif" class="item-icon icon-prop">Properties</a>&#13;<a class="inner-link" href="#Ext.layout.AbsoluteLayout-methods"><img src="resources/images/default/s.gif" class="item-icon icon-method">Methods</a>&#13;<a class="inner-link" href="#Ext.layout.AbsoluteLayout-events"><img src="resources/images/default/s.gif" class="item-icon icon-event">Events</a>&#13;<a class="inner-link" href="#Ext.layout.AbsoluteLayout-configs"><img src="resources/images/default/s.gif" class="item-icon icon-config">Config Options</a>&#13;<a class="bookmark" href="../docs/?class=Ext.layout.AbsoluteLayout"><img src="resources/images/default/s.gif" class="item-icon icon-fav">Direct Link</a>&#13;</div><div class="inheritance res-block"><pre class="res-block-inner"><a href="output/Ext.layout.ContainerLayout.html" ext:member="" ext:cls="Ext.layout.ContainerLayout">ContainerLayout</a>
2   <img src="resources/elbow-end.gif"><a href="output/Ext.layout.AnchorLayout.html" ext:member="" ext:cls="Ext.layout.AnchorLayout">AnchorLayout</a>
3     <img src="resources/elbow-end.gif">AbsoluteLayout</pre></div><h1>Class <a href="source/AbsoluteLayout.html#cls-Ext.layout.AbsoluteLayout">Ext.layout.AbsoluteLayout</a></h1><table cellspacing="0"><tr><td class="label">Package:</td><td class="hd-info">Ext.layout</td></tr><tr><td class="label">Defined In:</td><td class="hd-info"><a href="source/AbsoluteLayout.html#cls-Ext.layout.AbsoluteLayout">AbsoluteLayout.js</a></td></tr><tr><td class="label">Class:</td><td class="hd-info"><a href="source/AbsoluteLayout.html#cls-Ext.layout.AbsoluteLayout">AbsoluteLayout</a></td></tr><tr><td class="label">Extends:</td><td class="hd-info"><a href="output/Ext.layout.AnchorLayout.html" ext:cls="Ext.layout.AnchorLayout" ext:member="">AnchorLayout</a></td></tr></table><div class="description"><p>This is a layout that inherits the anchoring of <b><a href="output/Ext.layout.AnchorLayout.html" ext:cls="Ext.layout.AnchorLayout">Ext.layout.AnchorLayout</a></b> and adds the
4 ability for x/y positioning using the standard x and y component config options.</p>
5 <p>This class is intended to be extended or created via the <tt><b><a href="output/Ext.Container.html#Ext.Container-layout" ext:member="layout" ext:cls="Ext.Container">layout</a></b></tt>
6 configuration property.  See <tt><b><a href="output/Ext.Container.html#Ext.Container-layout" ext:member="layout" ext:cls="Ext.Container">Ext.Container.layout</a></b></tt> for additional details.</p>
7 <p>Example usage:</p>
8 <pre><code><b>var</b> form = <b>new</b> Ext.form.FormPanel({
9     title: <em>'Absolute Layout'</em>,
10     layout:<em>'absolute'</em>,
11     layoutConfig: {
12         <i>// layout-specific configs go here</i>
13         extraCls: <em>'x-abs-layout-item'</em>,
14     },
15     baseCls: <em>'x-plain'</em>,
16     url:<em>'save-form.php'</em>,
17     defaultType: <em>'textfield'</em>,
18     items: [{
19         x: 0,
20         y: 5,
21         xtype:<em>'<b>label</b>'</em>,
22         text: <em>'Send To:'</em>
23     },{
24         x: 60,
25         y: 0,
26         name: <em>'to'</em>,
27         anchor:<em>'100%'</em>  <i>// anchor width by percentage</i>
28     },{
29         x: 0,
30         y: 35,
31         xtype:<em>'<b>label</b>'</em>,
32         text: <em>'Subject:'</em>
33     },{
34         x: 60,
35         y: 30,
36         name: <em>'subject'</em>,
37         anchor: <em>'100%'</em>  <i>// anchor width by percentage</i>
38     },{
39         x:0,
40         y: 60,
41         xtype: <em>'textarea'</em>,
42         name: <em>'msg'</em>,
43         anchor: <em>'100% 100%'</em>  <i>// anchor width and height</i>
44     }]
45 });</code></pre></div><div class="hr"></div><a id="Ext.layout.AbsoluteLayout-configs"></a><h2>Config Options</h2><table cellspacing="0" class="member-table"><tbody><tr><th colspan="2" class="sig-header">Config Options</th><th class="msource-header">Defined By</th></tr><tr class="config-row expandable inherited"><td class="micon"><a href="#expand" class="exi">&nbsp;</a></td><td class="sig"><a id="Ext.layout.AnchorLayout-anchor"></a><b><a href="source/AnchorLayout.html#cfg-Ext.layout.AnchorLayout-anchor">anchor</a></b> : String<div class="mdesc"><div class="short">This configuation option is to be applied to child items of a container managed by
46 this layout (ie. configured with l...</div><div class="long"><p>This configuation option is to be applied to <b>child <tt>items</tt></b> of a container managed by
47 this layout (ie. configured with <tt>layout:'anchor'</tt>).</p><br/>
48 <p>This value is what tells the layout how an item should be anchored to the container. <tt>items</tt>
49 added to an AnchorLayout accept an anchoring-specific config property of <b>anchor</b> which is a string
50 containing two values: the horizontal anchor value and the vertical anchor value (for example, '100% 50%').
51 The following types of anchor values are supported:<div class="mdetail-params"><ul>
52 <li><b>Percentage</b> : Any value between 1 and 100, expressed as a percentage.<div class="sub-desc">
53 The first anchor is the percentage width that the item should take up within the container, and the
54 second is the percentage height.  For example:<pre><code><i>// two values specified</i>
55 anchor: <em>'100% 50%'</em> <i>// render item complete width of the container and</i>
56                    <i>// 1/2 height of the container</i>
57 <i>// one value specified</i>
58 anchor: <em>'100%'</em>     <i>// the width value; the height will <b>default</b> to auto</i></code></pre></div></li>
59 <li><b>Offsets</b> : Any positive or negative integer value.<div class="sub-desc">
60 This is a raw adjustment where the first anchor is the offset from the right edge of the container,
61 and the second is the offset from the bottom edge. For example:<pre><code><i>// two values specified</i>
62 anchor: <em>'-50 -100'</em> <i>// render item the complete width of the container</i>
63                    <i>// minus 50 pixels and</i>
64                    <i>// the complete height minus 100 pixels.</i>
65 <i>// one value specified</i>
66 anchor: <em>'-50'</em>      <i>// anchor value is assumed to be the right offset value</i>
67                    <i>// bottom offset will <b>default</b> to 0</i></code></pre></div></li>
68 <li><b>Sides</b> : Valid values are <tt>'right'</tt> (or <tt>'r'</tt>) and <tt>'bottom'</tt>
69 (or <tt>'b'</tt>).<div class="sub-desc">
70 Either the container must have a fixed size or an anchorSize config value defined at render time in
71 order for these to have any effect.</div></li>
72 <li><b>Mixed</b> : <div class="sub-desc">
73 Anchor values can also be mixed as needed.  For example, to render the width offset from the container
74 right edge by 50 pixels and 75% of the container's height use:
75 <pre><code>anchor: <em>'-50 75%'</em></code></pre></div></li>
76 </ul></div></div></div></td><td class="msource"><a href="output/Ext.layout.AnchorLayout.html#anchor" ext:member="#anchor" ext:cls="Ext.layout.AnchorLayout">AnchorLayout</a></td></tr><tr class="config-row expandable inherited"><td class="micon"><a href="#expand" class="exi">&nbsp;</a></td><td class="sig"><a id="Ext.layout.AnchorLayout-defaultAnchor"></a><b><a href="source/AnchorLayout.html#cfg-Ext.layout.AnchorLayout-defaultAnchor">defaultAnchor</a></b> : String<div class="mdesc"><div class="short">default anchor for all child container items applied if no anchor or specific width is set on the child item.  Defaul...</div><div class="long">default anchor for all child container items applied if no anchor or specific width is set on the child item.  Defaults to '100%'.</div></div></td><td class="msource"><a href="output/Ext.layout.AnchorLayout.html#defaultAnchor" ext:member="#defaultAnchor" ext:cls="Ext.layout.AnchorLayout">AnchorLayout</a></td></tr><tr class="config-row expandable inherited"><td class="micon"><a href="#expand" class="exi">&nbsp;</a></td><td class="sig"><a id="Ext.layout.ContainerLayout-extraCls"></a><b><a href="source/ContainerLayout.html#cfg-Ext.layout.ContainerLayout-extraCls">extraCls</a></b> : String<div class="mdesc"><div class="short">An optional extra CSS class that will be added to the container. This can be useful for adding
77 customized styles to t...</div><div class="long"><p>An optional extra CSS class that will be added to the container. This can be useful for adding
78 customized styles to the container or any of its children using standard CSS rules. See
79 <a href="output/Ext.Component.html" ext:cls="Ext.Component">Ext.Component</a>.<a href="output/Ext.Component.html#Ext.Component-ctCls" ext:member="ctCls" ext:cls="Ext.Component">ctCls</a> also.</p>
80 <p><b>Note</b>: <tt>extraCls</tt> defaults to <tt>''</tt> except for the following classes
81 which assign a value by default:
82 <div class="mdetail-params"><ul>
83 <li><a href="output/Ext.layout.AbsoluteLayout.html" ext:cls="Ext.layout.AbsoluteLayout">Absolute Layout</a> : <tt>'x-abs-layout-item'</tt></li>
84 <li><a href="output/Ext.layout.Box.html" ext:cls="Ext.layout.Box">Box Layout</a> : <tt>'x-box-item'</tt></li>
85 <li><a href="output/Ext.layout.ColumnLayout.html" ext:cls="Ext.layout.ColumnLayout">Column Layout</a> : <tt>'x-column'</tt></li>
86 </ul></div>
87 To configure the above Classes with an extra CSS class append to the default.  For example,
88 for ColumnLayout:<pre><code>extraCls: <em>'x-column custom-class'</em></code></pre>
89 </p></div></div></td><td class="msource"><a href="output/Ext.layout.ContainerLayout.html#extraCls" ext:member="#extraCls" ext:cls="Ext.layout.ContainerLayout">ContainerLayout</a></td></tr><tr class="config-row  inherited"><td class="micon"><a href="#expand" class="exi">&nbsp;</a></td><td class="sig"><a id="Ext.layout.ContainerLayout-renderHidden"></a><b><a href="source/ContainerLayout.html#cfg-Ext.layout.ContainerLayout-renderHidden">renderHidden</a></b> : Boolean<div class="mdesc">True to hide each contained item on render (defaults to false).</div></td><td class="msource"><a href="output/Ext.layout.ContainerLayout.html#renderHidden" ext:member="#renderHidden" ext:cls="Ext.layout.ContainerLayout">ContainerLayout</a></td></tr></tbody></table><a id="Ext.layout.AbsoluteLayout-props"></a><h2>Public Properties</h2><table cellspacing="0" class="member-table"><tbody><tr><th colspan="2" class="sig-header">Property</th><th class="msource-header">Defined By</th></tr><tr class="property-row expandable inherited"><td class="micon"><a href="#expand" class="exi">&nbsp;</a></td><td class="sig"><a id="Ext.layout.ContainerLayout-fieldTpl"></a><b><a href="source/ContainerLayout.html#prop-Ext.layout.ContainerLayout-fieldTpl">fieldTpl</a></b> : Ext.Template<div class="mdesc"><div class="short">The Ext.Template used by Field rendering layout classes (such as
90 Ext.layout.FormLayout) to create the DOM structure o...</div><div class="long">The <a href="output/Ext.Template.html" ext:cls="Ext.Template">Ext.Template</a> used by Field rendering layout classes (such as
91 <a href="output/Ext.layout.FormLayout.html" ext:cls="Ext.layout.FormLayout">Ext.layout.FormLayout</a>) to create the DOM structure of a fully wrapped,
92 labeled and styled form Field. A default Template is supplied, but this may be
93 overriden to create custom field structures. The template processes values returned from
94 <a href="output/Ext.layout.FormLayout.html#Ext.layout.FormLayout-getTemplateArgs" ext:member="getTemplateArgs" ext:cls="Ext.layout.FormLayout">Ext.layout.FormLayout.getTemplateArgs</a>.</div></div></td><td class="msource"><a href="output/Ext.layout.ContainerLayout.html#fieldTpl" ext:member="#fieldTpl" ext:cls="Ext.layout.ContainerLayout">ContainerLayout</a></td></tr><tr class="property-row expandable inherited"><td class="micon"><a href="#expand" class="exi">&nbsp;</a></td><td class="sig"><a id="Ext.layout.ContainerLayout-if"></a><b><a href="source/ContainerLayout.html#prop-Ext.layout.ContainerLayout-if">if</a></b> : Object<div class="mdesc"><div class="short">This monitorResize flag will be renamed soon as to avoid confusion
95 with the Container version which hooks onWindowRes...</div><div class="long">This monitorResize flag will be renamed soon as to avoid confusion
96 with the Container version which hooks onWindowResize to doLayout
97 monitorResize flag in this context attaches the resize event between
98 a container and it's layout</div></div></td><td class="msource"><a href="output/Ext.layout.ContainerLayout.html#if" ext:member="#if" ext:cls="Ext.layout.ContainerLayout">ContainerLayout</a></td></tr></tbody></table><a id="Ext.layout.AbsoluteLayout-methods"></a><h2>Public Methods</h2><table cellspacing="0" class="member-table"><tbody><tr><th colspan="2" class="sig-header">Method</th><th class="msource-header">Defined By</th></tr><tr class="method-row expandable inherited"><td class="micon"><a href="#expand" class="exi">&nbsp;</a></td><td class="sig"><a id="Ext.layout.ContainerLayout-parseMargins"></a><b><a href="source/ContainerLayout.html#method-Ext.layout.ContainerLayout-parseMargins">parseMargins</a></b>(&nbsp;<code>Number|String&nbsp;v</code>&nbsp;)
99     :
100                                         Object<div class="mdesc"><div class="short">Parses a number or string representing margin sizes into an object. Supports CSS-style margin declarations
101 (e.g. 10, ...</div><div class="long">Parses a number or string representing margin sizes into an object. Supports CSS-style margin declarations
102 (e.g. 10, "10", "10 10", "10 10 10" and "10 10 10 10" are all valid options and would return the same result)<div class="mdetail-params"><strong>Parameters:</strong><ul><li><code>v</code> : Number|String<div class="sub-desc">The encoded margins</div></li></ul><strong>Returns:</strong><ul><li><code>Object</code><div class="sub-desc">An object with margin sizes for top, right, bottom and left</div></li></ul></div></div></div></td><td class="msource"><a href="output/Ext.layout.ContainerLayout.html#parseMargins" ext:member="#parseMargins" ext:cls="Ext.layout.ContainerLayout">ContainerLayout</a></td></tr></tbody></table><a id="Ext.layout.AbsoluteLayout-events"></a><h2>Public Events</h2><div class="no-members">This class has no public events.</div></div>