SPLIT attribute

The SPLIT attribute forces a horizontal box to show only one child container.

Syntax

SPLIT[@screen-size]
where screen-size can be:
{ SMALL | MEDIUM | LARGE }
  1. screen-size is a screen size selector that indicates when the box is to be split, depending on the size of the screen. Several SPLIT@screen-size attributes can be used for the same element.

Usage

When the SPLIT attribute takes effect, the HBOX or VBOX displays only one child container at a time. The child containers can for example be a GRID, a TABLE or a SCROLLGRID.

The SPLIT attribute only takes effect when the orientation of the box is horizontal. This applies to:
  • HBOX elements without an ORIENTATION attribute.
  • HBOX or VBOX elements with ORIENTATION=HORIZONTAL
  • HBOX or VBOX elements with ORIENTATION@screen-size=HORIZONTAL and the screen-size applies.

On mobile devices, when the box is split, the end user can use the swipe gesture to move between child containers. To deny the swipe gesture, use the NOSWIPE attribute.

When SPLIT is in action with desktop / web browser front ends, is it possible to move between child containers by using a specific widget. The type of widget can be controlled with the navigationArrows / navigationDots style attributes.

The SPLIT and SPLITTER attributes are similar concepts, but are not to be used together: SPLITTER makes only sense when several child containers are displayed at the same time.

Example

HBOX hb1 ( SPLIT@SMALL )
GRID grid1
...
TABLE table1
...
END