Tag focus

Focus component allows to set focus based on validation of components or alternatively it can preserve focus on currently focused form input.

Focus can be bound to form (in case of placement to h:form) or to whole view (when placed outside of forms) - in latter case, all forms will be managed by one Focus. There can be at most one Focus per form. When there is one view-scoped Focus and form defines own Focus, form-scoped Focus settings will be used.

Focus is applied each time the component is rendered - for each full page submit and for each partial page request (in case of ajaxRendered=true). Alternatively, you can use JavaScript API: applyFocus() function will immediately cause.

Tag Information
Component type org.richfaces.Focus
Tag Name rich:focus
Renderer Type org.richfaces.FocusRenderer
Handler Class None

Name Required Type Description
ajaxRendered false boolean Defines whether focus state should be updated during each AJAX request automatically. (default: true)
binding false javax.faces.component.UIComponent The value binding expression used to wire up this component to a component property of a JavaBean class
converter false javax.faces.convert.Converter Converter instance registered with this component.
delayed false boolean Defines whether focus should not be applied after initial page load, but will need to be triggered by JavaScript function from Focus API: applyFocus() or via re-rendering (postback).
id false java.lang.String The component identifier for this component. This value must be unique within the closest parent component that is a naming container.
preserve false boolean Defines whether focus should be preserved on last focused input before request was done (default: false)
rendered false boolean Flag indicating whether or not this component should be rendered (during Render Response Phase), or processed on any subsequent form submit. The default value for this property is true.
validationAware false boolean

Defines if focus should respect validation of inputs.

If true, only invalid form fields will be focused when focus applied.

(default: true)

value false java.lang.Object The current value of this component.

Output Generated by Tag Library Documentation Generator.