A spacer that is used in layout and rendered as a transparent image.
Easily used as a transparent layout spacer
Horizontal or vertical spacing is managed by an attribute
Easily customizable sizes parameters
Table 6.423. rich : spacer attributes
Attribute Name | Description |
---|---|
binding | The attribute takes a value-binding expression for a component property of a backing bean |
height | The height of the spacer defined in pixels. The default value is 1 pixel |
id | Every component may have a unique id that is automatically created if omitted |
onclick | HTML: a script expression; a pointer button is clicked |
ondblclick | HTML: a script expression; a pointer button is double-clicked |
onkeydown | HTML: a script expression; a key is pressed down |
onkeypress | HTML: a script expression; a key is pressed and released |
onkeyup | HTML: a script expression; a key is released |
onmousedown | HTML: script expression; a pointer button is pressed down |
onmousemove | HTML: a script expression; a pointer is moved within |
onmouseout | HTML: a script expression; a pointer is moved away |
onmouseover | HTML: a script expression; a pointer is moved onto |
onmouseup | HTML: script expression; a pointer button is released |
rendered | If "false", this component is not rendered |
style | CSS style(s) is/are to be applied when this component is rendered |
styleClass | Corresponds to the HTML class attribute |
title | HTML: An advisory title for this element. Often used by the user agent as a tooltip |
width | The width of the spacer defined in pixels. The default value is 1 pixel |
Table 6.424. Component identification parameters
Name | Value |
---|---|
component-type | org.richfaces.spacer |
component-class | org.richfaces.component.html.HtmlSpacer |
component-family | org.richfaces.spacer |
renderer-type | org.richfaces.SpacerRenderer |
tag-class | org.richfaces.taglib.SpacerTag |
To create the simplest variant on a page use the following syntax::
Example:
...
<rich:spacer/>
...
Example:
import org.richfaces.component.html.HtmlSpacer;
...
HtmlSpacer mySpacer = new HtmlSpacer();
...
<rich:spacer> is a simple layout component which represents a transparent spacer. Thus, the main attributes that define its style are "style" and "styleClass".
In addition, the attributes are responsible for the component size: "width" and "height".
Moreover, to add e.g. some JavaScript effects, events defined on it are used.
onmouseover
onclick
onmouseout
etc.
On the component generation, the framework presents a default rich-spacer class in styleClass of a generated component, i.e. in order to redefine appearance of all spacers at once, it's necessary to redefine this class in your own CSS (replacing in the result properties defined in a skin with your own).
To define appearance of the particular spacer, it's possible to write your own CSS classes and properties in the component style attributes ( "style", "styleClass" ) modifying component property.
Here you can see the example of <rich:spacer> usage and sources for the given example.