Project Documentation


Tag name: <t:stylesheet>
UIComponent class: org.apache.myfaces.custom.stylesheet.Stylesheet
Tag class: org.apache.myfaces.custom.stylesheet.StylesheetTag
Component type: org.apache.myfaces.Stylesheet
Component family: javax.faces.Output
Renderer type: org.apache.myfaces.Stylesheet
Renderer class: org.apache.myfaces.custom.stylesheet.StylesheetRenderer

Renders the path to a common CSS-file


<t:stylesheet path="String"/>


see examples/css.jsp for an example!


Name Type Supports EL? Description
binding org.apache.myfaces.custom.stylesheet.Stylesheet Only EL Identifies a backing bean property (of type UIComponent or appropriate subclass) to bind to this component instance. This value must be an EL expression.
enabledOnUserRole String Yes If user is in given role, this component will be rendered normally. If not, no hyperlink is rendered but all nested tags (=body) are rendered.
filtered boolean Yes Cause EL expressions in the stylesheet to be evaluated.

When true, any EL expression in the stylesheet will be evaluated and replaced by its string representation on the first access. The stylesheet will be processed only once. Every subsequent request will get a cached view.

id String Yes Get a string which uniquely identifies this UIComponent within the scope of the nearest ancestor NamingContainer component. The id is not necessarily unique across all components in the current view.
inline boolean Yes Inline the stylesheet file content as in contrast to referencing it as a link.

The file referenced by the path attribute is loaded, and its content is written to the page wrapped in an <script> tag.

When this option is enabled, the path property must contain an absolute path within the current webapp. External urls ("http://*") and paths relative to the current page are not supported.

media String Yes Define the target media of the styles:
Intended for non-paged computer screens.
Intended for media using a fixed-pitch character grid, such as teletypes, terminals, or portable devices with limited display capabilities.
Intended for television-type devices (low resolution, color, limited scrollability).
Intended for projectors.
Intended for handheld devices (small screen, monochrome, bitmapped graphics, limited bandwidth).
Intended for paged, opaque material and for documents viewed on screen in print preview mode.
Intended for braille tactile feedback devices.
Intended for speech synthesizers.
Suitable for all devices.
Could be a comma separated list. See also
path String Yes URL for CSS-file.

If this path starts with a slash, then the webapp context path will be prepended to it. This makes it simple to reference stylesheets at an absolute path within the webapp. A value like "/styles/style.css" becomes "/webappname/styles/style.css".

If this path does not start with a slash, then it is output unaltered. This supports absolute urls ("http://host/path/style.css"). It also supports having css files relative to the current page ("style.css" or "styles/style.css") but this needs to be used with care as the standard JSF postback/internal-forward navigation style can cause browsers to use an inappropriate base url when resolving relative references.

rendered boolean Yes A boolean value that indicates whether this component should be rendered. Default value: true.
visibleOnUserRole String Yes If user is in given role, this component will be rendered normally. If not, nothing is rendered and the body of this tag will be skipped.