Box

Box
Prev	Components	Next

The box model of XUL is used to divide a portion of the display into a series of boxes. Components inside of a box will orient themselves horizontally or vertically. By combining a series of boxes and separators, you can control the layout of the visual presentation.

A box can lay out its children in one of two orientations, either horizontally or vertically. A horizontal box lines up its components horizontally and a vertical box orients its components vertically. You can think of a box as one row or one column from an HTML table.

    <zk>
    <box orient="vertical">    
        <button label="Button 1"/>        
        <button label="Button 2"/>        
    </box>    
    <box orient="horizontal">    
        <button label="Button 3"/>        
        <button label="Button 4"/>        
    </box>    
</zk>

Class Name

org.zkoss.zul.Box

Supported Child Components

*ALL

Supported Events

*NONE

Properties

Property	Description	Data Type	Default Value
`heights`	Sets the widths/heights, which is a list of numbers separated by comma to denote the width/height of each cell in a box.	`java.lang.String`	`<null>`
`ori` `ent`	Sets the orient. Values: `horizontal` \| `ver` `tical`	`java.lang.String`	`<null>`
`spacing`	Sets the spacing.(such as " `0` ", " `5px` ", " `3pt` " or " `1em` ")	`java.lang.String`	`<null>`
`val` `ign`	Sets the vertical alignment of the adjacent cells of a box. Value: `top\|middle\|bottom`	`java.lang.String`	`top`
`widths`	Sets the widths/heights, which is a list of numbers separated by comma to denote the width/height of each cell in a box.	`java.lang.String`	`<empty>`

Methods

Name	Description	Return Data Type
`getChildInnerAttrs(org.zkoss.zk.ui.Component)`	Returns the inner attributes used to wrap the children (never null).	`java.lang.String`
`getChildOuterAttrs(org.zkoss.zk.ui.Component)`	Returns the outer attributes used to wrap the children (never null).	`java.lang.String`
`onDrawNewChild(org.zkoss.zk.ui.Component, java.lang.StringBuffer)`		`void`

Inherited From

Inherited From
org.zkoss.zul.impl.XulElement
org.zkoss.zk.ui.HtmlBasedComponent
org.zkoss.zk.ui.AbstractComponent

Prev	Up	Next
Borderlayout	Home	Button