Horizontal Rule

A horizontal line that is used to separate information.

 

Component at design time

Drag and drop an

Horizontal Rule component onto the page:

The

Horizontal Rule component looks like this on the page:

 

Component at runtime

The

Horizontal Rule component looks like this on the page during runtime:

 

Properties and All Attributes views

The Properties view for a component shows the most common set of attributes you can set on a component, and, depending on the component, you might also see options for adding controls, actions, or other components. To open the Properties view, click

Window | Show View | Properties.

These common attributes for the Horizontal Rule component display on the h:outputSeparator tab in the Properties view. See the All Horizontal Rule attributes table for a complete list of attributes.

The All Attributes view shows a table of all the attributes you can set on a component, which includes those attributes you can access from the Properties view. To switch to the All Attributes view, click the

All Attributes icon in the upper right corner of the Properties view.

Table 1. All Horizontal Rule attributes

Attribute name

Represented in Properties view by

Description

align

Alignment

Specifies whether the component should be aligned to the left, center or right.

binding

Not represented

An expression that binds the component's instance (usually a user interface component) to a bean property (usually in the backing file).

color

Coloring

Specifies the color of the selected component in 6 digit hexadecimal RGB values beginning with a # symbol, or by entering a color name, for example, black, white, blue, and so on.

height

Size: Height

Specifies the height of the component in pixels.

id

ID

Assigns a name to a component. Should be a unique name within a JSP.

noshade

Display using 3-D shading

Check to give the component a three-dimensional, shaded appearance. If noshade is set to true, the component is rendered in a solid color. If left blank, the browser used will display the tag in its default way.

rendered

Not represented

Can be set to true or false:

  • false - Component will not be rendered to the browser at runtime.

  • true - Component will get rendered. This is the default value.

styleClass

Style: Classes

Space-separated list of CSS style classes to be applied when this element is rendered. This value must be passed through as the class attribute on generated markup. Defines the classes (such as style sheets) of the selected component. This may be done manually, or by clicking the button and selecting the desired Classes from within the window.

style

Style: Props

Specifies CSS style information for the component (for example, style="font-size : 8pt ; color : red"). Defines the properties (such as font and color) of the selected component. This may be done manually, or by clicking the button and selecting the desired properties from within the window.

title

Not represented

Specifies the title text, shown in browser as a tooltip at runtime. Used by a browser as the alternative text of a component if the alternative text is not specified.

width

Size: Width

Specifies the width of the component in either pixels or percentage. To specify percentage is to be used append % to the value.