dijit/_Container

Introduction

Use this mixin for widgets that contain (or sometimes contain) a list of child widgets, in order to be able to adjust the list of child widgets via addChild() and removeChild().

_Container can be used as a superclass for any widget with this.containerNode defined, but it's especially useful for widgets like dijit/layout/BorderContainer and dijit/layout/TabContainer which contain (only) a set of child widgets.

When a widget that extends _Container contains nothing but a set of child widgets (or contains nothing at all), you can use the addChild() and removeChild() API to adjust the list of widget children.

Example

require([
    "dojo/_base/declare", "dojo/dom-construct", "dojo/_base/window",
    "dijit/_WidgetBase", "dijit/_Container", "dijit/form/Button", "dojo/domReady!"
], function(declare, domConstruct, win, _WidgetBase, _Container, Button){
    var MyToolbar = declare([_WidgetBase, _Container], { });

    var toolbar = new MyToolbar();
    toolbar.placeAt(win.body());
    toolbar.addChild(new Button({label: "click me"}));
    toolbar.addChild(new Button({label: "click me"}));
    domConstruct.place("<p>Widgets in toolbar: " + toolbar.getChildren().length + "</p>", win.body());
});