Create new RichFaces Documentation Jira issue

This will launch the RichFaces Jira page - to complete your feedback please login if needed, and submit the Jira.

JBoss.orgCommunity Documentation

6.2.4.  < a4j:loadStyle > available since 3.0.0

The <a4j:loadStyle> component allows to load a style sheet file from alternative sources like a jar file, etc. It inserts stylesheet links to the head element.

Table 6.33. a4j : loadStyle attributes

Attribute Name Description
binding JSF: The attribute takes a value-binding expression for a component property of a backing bean
id JSF: Every component may have a unique id that is automatically created if omitted
mediaThis attribute defines the device to which it is necessary to apply style registration. The possible values are "all", "screen" (by default), "print", "projection", "projection", "braille" and "speech".
rendered JSF: If "false", this component is not rendered
srcDefines the context relative path to the style sheet file.

Table 6.34. Component identification parameters

NameValue
component-typeorg.ajax4jsf.LoadStyle
component-familyorg.ajax4jsf.LoadStyle
component-classorg.ajax4jsf.component.html.HtmlLoadStyle
renderer-typeorg.ajax4jsf.LoadStyleRenderer

To create the simplest variant on a page use the following syntax:

Example:


<a4j:loadStyle src="styles/style.css"/>

Example:

import org.ajax4jsf.component.html.HtmlLoadStyle;

...
HtmlLoadScript myStyle = new HtmlLoadStyle();
...

The main attribute of the <a4j:loadStylet> is "src" , wich defines the context relative path to the script. The value of the attribute does not require a prefix of an application. Leading slash in the path means the root of the web context. It is also possible to use resource:/// prefix to access the script file using RichFaces resource framework.

Example:


<a4j:loadStyle src="resource:///org/mycompany/assets/script/focus.js" />

The "src" attribute passses value to the getResourceURL() method of the ViewHandler of the application, The result is passed through the encodeResourceURL() method of the ExternalContext.

Vizit the Script page at RichFaces LiveDemo for examples of component usage abd their sources.