Dojo: The Definitive Guide

BorderContainer

Warning

BorderContainer is a new layout dijit introduced in version 1.1 that resulted in LayoutContainer and SplitContainer getting deprecated because BorderContainer is essentially a union of the two. Although you may see examples on the web using LayoutContainer and SplitContainer, it is not a good idea to start building an application with deprecated features. For this reason, these two deprecated widgets are not covered in this book.

A BorderContainer provides an easy way to define a layout that normally involves several layout tiles that occur on the top/bottom/left/right/center, top/bottom/center, or left/right/center of the page. These tiles may have resizable handles, so the BorderContainer is an especially notable value-added widget in that it simplifies what could have otherwise been a grueling workload into a really simple widgetized solution. As you might have guessed, it is called a "border" container because up to four tiles surround its border with the center filling in to whatever is leftover.

Table 14-4 shows the API.

Table 14-4. BorderContainer API

Name	Type	Comment
design	String	Valid values include "headline" (the default) or "sidebar" and determine whether the top and bottom tiles extend the width and height or the top and bottom of the container.
liveSplitters	Boolean	Whether to continuously resize while the mouse drags or to resize on the onmouseup event.
persist	Boolean	Whether to save splitter positions as a cookie.

When using a BorderContainer, the additional ...