## 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.