Column.html
9.42 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
<!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>
<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(); highlight();">
<pre class="prettyprint lang-js"><span id='Ext-layout-container-Column'>/**
</span> * This is the layout style of choice for creating structural layouts in a multi-column format where the width of each
* column can be specified as a percentage or fixed width, but the height is allowed to vary based on the content. This
* class is intended to be extended or created via the layout:'column' {@link Ext.container.Container#layout} config,
* and should generally not need to be created directly via the new keyword.
*
* ColumnLayout does not have any direct config options (other than inherited ones), but it does support a specific
* config property of `columnWidth` that can be included in the config of any panel added to it. The layout will use
* the columnWidth (if present) or width of each panel during layout to determine how to size each panel. If width or
* columnWidth is not specified for a given panel, its width will default to the panel's width (or auto).
*
* The width property is always evaluated as pixels, and must be a number greater than or equal to 1. The columnWidth
* property is always evaluated as a percentage, and must be a decimal value greater than 0 and less than 1 (e.g., .25).
*
* The basic rules for specifying column widths are pretty simple. The logic makes two passes through the set of
* contained panels. During the first layout pass, all panels that either have a fixed width or none specified (auto)
* are skipped, but their widths are subtracted from the overall container width.
*
* During the second pass, all panels with columnWidths are assigned pixel widths in proportion to their percentages
* based on the total **remaining** container width. In other words, percentage width panels are designed to fill
* the space left over by all the fixed-width and/or auto-width panels. Because of this, while you can specify any
* number of columns with different percentages, the columnWidths must always add up to 1 (or 100%) when added
* together, otherwise your layout may not render as expected.
*
* @example
* // All columns are percentages -- they must add up to 1
* Ext.create('Ext.panel.Panel', {
* title: 'Column Layout - Percentage Only',
* width: 350,
* height: 250,
* layout:'column',
* items: [{
* title: 'Column 1',
* columnWidth: 0.25
* },{
* title: 'Column 2',
* columnWidth: 0.55
* },{
* title: 'Column 3',
* columnWidth: 0.20
* }],
* renderTo: Ext.getBody()
* });
*
* // Mix of width and columnWidth -- all columnWidth values must add up
* // to 1. The first column will take up exactly 120px, and the last two
* // columns will fill the remaining container width.
*
* Ext.create('Ext.Panel', {
* title: 'Column Layout - Mixed',
* width: 350,
* height: 250,
* layout:'column',
* items: [{
* title: 'Column 1',
* width: 120
* },{
* title: 'Column 2',
* columnWidth: 0.7
* },{
* title: 'Column 3',
* columnWidth: 0.3
* }],
* renderTo: Ext.getBody()
* });
*/
Ext.define('Ext.layout.container.Column', {
extend: 'Ext.layout.container.Container',
alias: ['layout.column'],
alternateClassName: 'Ext.layout.ColumnLayout',
type: 'column',
itemCls: Ext.baseCSSPrefix + 'column',
targetCls: Ext.baseCSSPrefix + 'column-layout-ct',
// Columns with a columnWidth have their width managed.
columnWidthSizePolicy: {
setsWidth: 1,
setsHeight: 0
},
childEls: [
'innerCt'
],
manageOverflow: 2,
renderTpl: [
'<div id="{ownerId}-innerCt" class="',Ext.baseCSSPrefix,'column-inner">',
'{%this.renderBody(out,values)%}',
'<div class="',Ext.baseCSSPrefix,'clear"></div>',
'</div>',
'{%this.renderPadder(out,values)%}'
],
getItemSizePolicy: function (item) {
if (item.columnWidth) {
return this.columnWidthSizePolicy;
}
return this.autoSizePolicy;
},
beginLayout: function() {
this.callParent(arguments);
this.innerCt.dom.style.width = '';
},
calculate: function (ownerContext) {
var me = this,
containerSize = me.getContainerSize(ownerContext),
state = ownerContext.state;
if (state.calculatedColumns || (state.calculatedColumns = me.calculateColumns(ownerContext))) {
if (me.calculateHeights(ownerContext)) {
me.calculateOverflow(ownerContext, containerSize);
return;
}
}
me.done = false;
},
calculateColumns: function (ownerContext) {
var me = this,
containerSize = me.getContainerSize(ownerContext),
innerCtContext = ownerContext.getEl('innerCt', me),
items = ownerContext.childItems,
len = items.length,
contentWidth = 0,
blocked, availableWidth, i, itemContext, itemMarginWidth, itemWidth;
// Can never decide upon necessity of vertical scrollbar (and therefore, narrower
// content width) until the component layout has published a height for the target
// element.
if (!ownerContext.heightModel.shrinkWrap && !ownerContext.targetContext.hasProp('height')) {
return false;
}
// No parallel measurement, cannot lay out boxes.
if (!containerSize.gotWidth) { //\\ TODO: Deal with target padding width
ownerContext.targetContext.block(me, 'width');
blocked = true;
} else {
availableWidth = containerSize.width;
innerCtContext.setWidth(availableWidth);
}
// we need the widths of the columns we don't manage to proceed so we block on them
// if they are not ready...
for (i = 0; i < len; ++i) {
itemContext = items[i];
// this is needed below for non-calculated columns, but is also needed in the
// next loop for calculated columns... this way we only call getMarginInfo in
// this loop and use the marginInfo property in the next...
itemMarginWidth = itemContext.getMarginInfo().width;
if (!itemContext.widthModel.calculated) {
itemWidth = itemContext.getProp('width');
if (typeof itemWidth != 'number') {
itemContext.block(me, 'width');
blocked = true;
}
contentWidth += itemWidth + itemMarginWidth;
}
}
if (!blocked) {
availableWidth = (availableWidth < contentWidth) ? 0 : availableWidth - contentWidth;
for (i = 0; i < len; ++i) {
itemContext = items[i];
if (itemContext.widthModel.calculated) {
itemMarginWidth = itemContext.marginInfo.width; // always set by above loop
itemWidth = itemContext.target.columnWidth;
itemWidth = Math.floor(itemWidth * availableWidth) - itemMarginWidth;
itemWidth = itemContext.setWidth(itemWidth); // constrains to min/maxWidth
contentWidth += itemWidth + itemMarginWidth;
}
}
ownerContext.setContentWidth(contentWidth);
}
// we registered all the values that block this calculation, so abort now if blocked...
return !blocked;
},
calculateHeights: function (ownerContext) {
var me = this,
items = ownerContext.childItems,
len = items.length,
blocked, i, itemContext;
// in order for innerCt to have the proper height, all the items must have height
// correct in the DOM...
blocked = false;
for (i = 0; i < len; ++i) {
itemContext = items[i];
if (!itemContext.hasDomProp('height')) {
itemContext.domBlock(me, 'height');
blocked = true;
}
}
if (!blocked) {
ownerContext.setContentHeight(me.innerCt.getHeight() + ownerContext.targetContext.getPaddingInfo().height);
}
return !blocked;
},
finishedLayout: function (ownerContext) {
var bc = ownerContext.bodyContext;
// Owner may not have a body - this seems to only be needed for Panels.
if (bc && (Ext.isIE6 || Ext.isIE7 || Ext.isIEQuirks)) {
// Fix for https://sencha.jira.com/browse/EXTJSIV-4979
bc.el.repaint();
}
this.callParent(arguments);
},
getRenderTarget : function() {
return this.innerCt;
}
});
</pre>
</body>
</html>