How to Configure the document Tag

Organizing Content on Web Pages 8-17 attribute specifies the width of the start facet. Child components in top and bottom facets are stretched up to the height set by topHeight and bottomHeight attributes, respectively, and child components in start and end facets are stretched up to the width set by startWidth and endWidth attributes, respectively. Instead of setting a numeric dimension, you can set the topHeight, bottomHeight, startWidth and endWidth attributes to auto and the browser will determine the amount of space required to display the content in the facets. If you do not explicitly specify a value, by default, the value for the topHeight, bottomHeight, startWidth, and endWidth attributes is 50 pixels each. The widths of the top and bottom facets, and the heights of the start and end facets are derived from the width and height of the parent component of panelStretchLayout. 3. By default, the panelStretchLayout component stretches to fill available browser space. If you want to place the panelStretchLayout component inside a component that does not stretch its children, then you need to configure the panelStretchLayout component to not stretch. You configure whether the component will stretch or not using the dimensionsFrom attribute. To do so, expand the Other section, and set DimensionsFrom to one of the following: ■ children: Instead of stretching, the panelStretchLayout component will get its dimensions from its child component. Note: If you set a facet to use auto as a value for the width or height of that facet, the child component does not have to be able to stretch. In fact, it must use a stable, standalone width that is not dependent upon the width of the facet. For example, you should not use auto on a facet whose child component can stretch their children automatically. These components have their own built-in stretched widths by default which will then cause them to report an unstable offsetWidth value, which is used by the browser to determine the amount of space. Additionally, you should not use auto in conjunction with a child component that uses a percentage length for its width. The facet content cannot rely on percentage widths or be any component that would naturally consume the entire width of its surrounding container. Tip: If a facet does not contain a child component, it is not rendered and therefore does not take up any space. You must place a child component into a facet in order for that facet to occupy the configured space. 8-18 Web User Interface Developers Guide for Oracle Application Development Framework ■ parent: the size of the panelStretchLayout component will be determined in the following order: – From the inlineStyle attribute. – If no value exists for inlineStyle, then the size is determined by the parent container that is, the panelStretchLayout component will stretch. – If the parent container is not configured or not able to stretch its children, the size will be determined by the skin. ■ auto: If the parent component to the panelStretchLayout component allows stretching of its child, then the panelStretchLayout component will stretch to fill the parent. If the parent does not stretch its children then the size of the panelStretchLayout component will be based on the size of its child component. 4. To place content in the component, drag and drop the desired component into any of the facets. If you want the child component to stretch, it must be a component that supports being stretched. See Section 8.3.2, What You May Need to Know About Geometry Management and the panelStretchLayout Component, for more details. Because facets accept one child only, if you want to add more than one child component, wrap the child components inside a container component, for example, a panelGroupLayout component. This component must also be able to be stretched in order for all contained components to stretch.

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

The panelStretchLayout component can stretch its child components and it can also be stretched. The following components can be stretched inside the facets of the panelStretchLayout component: ■ inputText when configured to stretch Note: If you use this setting, you cannot use a percentage to set the height of the top and bottom facets. If you do, those facets will try to get their dimensions from the size of this panelStretchLayout component, which will not be possible, as the panelStretchLayout component will be getting its height from its contents, resulting in a circular dependency If a percentage is used for either facet, it will be disregarded and the default 50px will be used instead. Additionally, you cannot set the height of the panelStretchLayout component for example through the inlineStyle or styleClass attributes if you use this setting. Doing so would cause conflict between the panelStretchLayout height and the child component height. Tip: If any facet is not visible in the visual editor: 1. Right-click the panelStretchLayout component in the Structure window. 2. From the context menu, choose Facets - Panel Stretch Layout facet name . Facets in use on the page are indicated by a checkmark in front of the facet name.