What You May Need to Know About Geometry Management and the panelStretchLayout Component

Organizing Content on Web Pages 8-21 Figure 8–8 panelSplitter with a Vertical Split Expanded Clicking the arrow button on a splitter collapses the panel that holds the header contents, and the logo and name are no longer shown, as shown in Figure 8–9 . Figure 8–9 File Explorer Uses panelSplitter with a Vertical Split You place components inside the facets of the panelSplitter component. The panelSplitter component uses geometry management to stretch its child components at runtime. This means when the user collapses one panel, the contents in the other panel are explicitly resized to fill up available space. 8-22 Web User Interface Developers Guide for Oracle Application Development Framework

8.4.1 How to Use the panelSplitter Component

The panelSplitter component lets you create two panes separated by a splitter. Each splitter component has two facets, namely, first and second, which correspond to the first panel and second panel, respectively. Child components can reside inside the facets only. To create more than two panes, you nest the panelSplitter components. To create and use the panelSplitter component: 1. In the Component Palette, from the Layout panel, drag and drop a Panel Splitter onto the JSF page.

2. In the Property Inspector, expand the Common section.

3. Set Orientation to vertical to create two vertical panes one on top of the other.

By default, the value is horizontal, which means horizontal panes are placed left-to-right or right-to-left, depending on the language reading direction.

4. Set SplitterPosition and PositionedFromEnd to determine the initial placement of

the splitter. By default, the value of the splitterPosition attribute is 200 pixels, and the positionedFromEnd attribute is false. This setting means that ADF Faces measures the initial position of the adjustable splitter from the start or top panel depending on the orientation attribute value. For example, if the orientation attribute is set to horizontal, the splitterPosition attribute is 200 and the positionedFromEnd attribute is false all default values, then ADF Faces places the splitter 200 pixels from the start panel, as shown in Figure 8–10 . Figure 8–10 Splitter Position Measured from Start Panel If the positionedFromEnd attribute is set to true, then ADF Faces measures the initial position of the splitter from the end or bottom panel, depending on the orientation value. Figure 8–11 shows the position of the splitter measured 200 pixels from the end panel. Note: While the user can change the values of the splitterPosition and collapsed attributes by resizing or collapsing the panes, those values will not be retained once the user leaves the page unless you configure your application to use change persistence. For information about enabling and using change persistence, see Chapter 31, Allowing User Customization on JSF Pages.