define("dijit/layout/LayoutContainer", [ "dojo/_base/kernel", // kernel.deprecated "dojo/_base/lang", "dojo/_base/declare", // declare "../_WidgetBase", "./_LayoutWidget", "./utils" // layoutUtils.layoutChildren ], function(kernel, lang, declare, _WidgetBase, _LayoutWidget, layoutUtils){ // module: // dijit/layout/LayoutContainer var LayoutContainer = declare("dijit.layout.LayoutContainer", _LayoutWidget, { // summary: // Deprecated. Use `dijit/layout/BorderContainer` instead. // description: // Provides Delphi-style panel layout semantics. // // A LayoutContainer is a box with a specified size (like style="width: 500px; height: 500px;"), // that contains children widgets marked with "layoutAlign" of "left", "right", "bottom", "top", and "client". // It takes it's children marked as left/top/bottom/right, and lays them out along the edges of the box, // and then it takes the child marked "client" and puts it into the remaining space in the middle. // // Left/right positioning is similar to CSS's "float: left" and "float: right", // and top/bottom positioning would be similar to "float: top" and "float: bottom", if there were such // CSS. // // Note that there can only be one client element, but there can be multiple left, right, top, // or bottom elements. // // See `LayoutContainer.ChildWidgetProperties` for details on the properties that can be set on // children of a `LayoutContainer`. // // example: // | // |
// |
header text
// |
table of contents
// |
client area
// |
// // Lays out each child in the natural order the children occur in. // Basically each child is laid out into the "remaining space", where "remaining space" is initially // the content area of this widget, but is reduced to a smaller rectangle each time a child is added. // tags: // deprecated baseClass: "dijitLayoutContainer", constructor: function(){ kernel.deprecated("dijit.layout.LayoutContainer is deprecated", "use BorderContainer instead", 2.0); }, layout: function(){ layoutUtils.layoutChildren(this.domNode, this._contentBox, this.getChildren()); }, addChild: function(/*dijit/_WidgetBase*/ child, /*Integer?*/ insertIndex){ this.inherited(arguments); if(this._started){ layoutUtils.layoutChildren(this.domNode, this._contentBox, this.getChildren()); } }, removeChild: function(/*dijit/_WidgetBase*/ widget){ this.inherited(arguments); if(this._started){ layoutUtils.layoutChildren(this.domNode, this._contentBox, this.getChildren()); } } }); LayoutContainer.ChildWidgetProperties = { // summary: // This property can be specified for the children of a LayoutContainer. // layoutAlign: String // "none", "left", "right", "bottom", "top", and "client". // See the LayoutContainer description for details on this parameter. layoutAlign: 'none' }; // Since any widget can be specified as a LayoutContainer child, mix it // into the base widget class. (This is a hack, but it's effective.) // This is for the benefit of the parser. Remove for 2.0. Also, hide from doc viewer. lang.extend(_WidgetBase, /*===== {} || =====*/ LayoutContainer.ChildWidgetProperties); return LayoutContainer; });