facesdoc.HTML_BASIC.javax.faces.Outputjavax.faces.Head.html Maven / Gradle / Ivy
Show all versions of javax.faces-api Show documentation
<font size="-1">component-family:</font> javax.faces.Output <font size="-1">renderer-type:</font> javax.faces.Head
HTML_BASIC render-kit
component-family: javax.faces.Output renderer-type: javax.faces.Head
Render the markup for a
<head> element.
Decode Behavior
No action is required during decode for this renderer.
Encode Behavior
Render the starting <head> element tag. Any
attributes declared on the element must be passed through unmodified to
the rendered output. At some
point before rendering the closing </head> element
tag, render any resources that have been targeted for this "head"
element:
- Obtain a
UIViewRoot instance.
- Obtain a
List of component resources targeted for
this "head" element with a call to UIViewRoot.getComponentResources()
with the String "head" as the argument.
- Iterate over the returned
List of UIComponent instances
and call encodeAll on each UIComponent instance.
Any attributes declared on the element must be passed through
unmodified to the rendered output.
Note that due to the cascading nature of CSS files, the order
in which these files have been added to the view must be preserved
when rendering the references to the files within the
<head> element. Also, the end result of the
rendered <head> section must be that any CSS
files referenced due to previous calls to
addComponentResource() do not adversely interfere
with any CSS files manually placed in this section by the page
author.
Render the ending </head> element tag.
This renderer is not responsible for rendering its children.
Note:
Attributes with a pass-through value of
true are not interpreted by the renderer and are passed
straight through to the rendered markup, without checking for validity. Attributes with a
pass-through value of false are interpreted
by the renderer, and may or may not be checked for validity by the renderer.
Attributes
attribute-name
pass-through
attribute-class
description
default-value
dir
true
java.lang.String
Direction indication for text that does not inherit directionality.
Valid values are "LTR" (left-to-right) and "RTL" (right-to-left).
undefined
lang
true
java.lang.String
Code describing the language used in the generated markup
for this component.
undefined
xmlns
true
java.lang.String
An XML Namespace to be passed through to the rendered element
undefined
Copyright (c) 2003-2010 Oracle America, Inc. All Rights Reserved.