Project Documentation

Summary

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

Usage

<t:stylesheet path="String"/>

Instructions

see examples/css.jsp for an example!

Attributes

Name Type Supports EL? Description
binding String 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 An identifier for this particular component instance within a component view.

The id must be unique within the scope of the tag's enclosing NamingContainer (eg h:form or f:subview). The id is not necessarily unique across all components in the current view

This value must be a static value, ie not change over the lifetime of a component. It cannot be defined via an EL expression; only a string is permitted.

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:
screen
Intended for non-paged computer screens.
tty
Intended for media using a fixed-pitch character grid, such as teletypes, terminals, or portable devices with limited display capabilities.
tv
Intended for television-type devices (low resolution, color, limited scrollability).
projection
Intended for projectors.
handheld
Intended for handheld devices (small screen, monochrome, bitmapped graphics, limited bandwidth).
print
Intended for paged, opaque material and for documents viewed on screen in print preview mode.
braille
Intended for braille tactile feedback devices.
aural
Intended for speech synthesizers.
all
Suitable for all devices.
Could be a comma separated list. See also http://www.w3.org/TR/REC-html40/types.html#type-media-descriptors
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.