Focus Manager

The <icecore:focusManager> component manages where focuSs will be applied on page load. The focus will move to the first invalid component, in this case when the required field is not filled in.

Source Code

focusManager.xhtml
FocusManagerBean.java

focusManager.xhtml

// MPL License text (see http://www.mozilla.org/MPL/)



<ui:composition xmlns="http://www.w3.org/1999/xhtml"

                xmlns:h="http://java.sun.com/jsf/html"

                xmlns:f="http://java.sun.com/jsf/core"

                xmlns:c="http://java.sun.com/jsp/jstl/core"

                xmlns:ace="http://www.icefaces.org/icefaces/components"

                xmlns:icecore="http://www.icefaces.org/icefaces/core"

                xmlns:ui="http://java.sun.com/jsf/facelets"

                template="/resources/templates/content-template.xhtml">

    <ui:param name="title" value="#{msgs['example.core.focusManager.title']}"/>

    <ui:param name="description" value="#{msgs['example.core.focusManager.description']}"/>

    <ui:param name="resourceValue" value="#{focusManagerBean.exampleResource}"/>

    

    <ui:param name="wikiResources" value="#{focusManagerResources.wikiResources}"/>

    <ui:param name="tldResources" value="#{focusManagerResources.tldResources}"/>



    <ui:define name="example">

        <style type="text/css">

            .ui-button { padding: 0.15em; }

            .required-input { color: red; }

        </style>



        <h:form id="form">

            <ace:selectMenu id="focusInput" value="#{focusManagerBean.focusedComponent}" label="Focus on:" labelPosition="left">

                <f:selectItem itemValue="" itemLabel="*first input component*"/>

                <f:selectItem itemValue="A" itemLabel="A"/>

                <f:selectItem itemValue="B" itemLabel="B"/>

                <f:selectItem itemValue="C" itemLabel="C"/>

                <f:selectItem itemValue="D" itemLabel="D"/>

                <ace:ajax execute="@this"/>

            </ace:selectMenu>

            <button type="button" onclick="window.location.reload();">Reload page</button>

            <ace:panel>

                <icecore:focusManager for="#{focusManagerBean.focusedComponent}">

                    <h:panelGrid columns="2">

                        <h:outputLabel for="A" value="A: "/>

                        <ace:textEntry id="A" value="#{focusManagerBean.a}"/>

                        <h:outputLabel for="B" value="B: "/>

                        <ace:textEntry id="B" value="#{focusManagerBean.b}"/>

                        <h:outputLabel for="C" value="C: "/>

                        <ace:textEntry id="C" value="#{focusManagerBean.c}"

                                       required="true" requiredIndicator="(Required)"

                                       indicatorPosition="right"

                                       styleClass="required-input">

                        </ace:textEntry>

                        <h:outputLabel for="D" value="D: "/>

                        <ace:textEntry id="D" value="#{focusManagerBean.d}"

                                       required="true" requiredIndicator="(Required)"

                                       indicatorPosition="right"

                                       styleClass="required-input">

                        </ace:textEntry>

                        <ace:pushButton id="submitButton" value="Submit"/>

                        <div/>

                    </h:panelGrid>

                    <h:panelGrid width="100%">

                        <ace:message for="C" id="messageC" />

                        <ace:message for="D" id="messageD"/>

                    </h:panelGrid>

                </icecore:focusManager>

            </ace:panel>

        </h:form>

    </ui:define>

</ui:composition>

FocusManagerBean.java

/* MPL License text (see http://www.mozilla.org/MPL/) */





package org.icefaces.samples.showcase.example.core.focusManager;



import org.icefaces.samples.showcase.metadata.annotation.*;

import org.icefaces.samples.showcase.metadata.context.ComponentExampleImpl;



import javax.annotation.PostConstruct;

import javax.faces.bean.CustomScoped;

import javax.faces.bean.ManagedBean;

import java.io.Serializable;



@ComponentExample(

        title = "example.core.focusManager.title",

        description = "example.core.focusManager.description",

        example = "/resources/examples/core/focusManager/focusManager.xhtml"

)

@ExampleResources(

        resources ={

            // xhtml

            @ExampleResource(type = ResourceType.xhtml,

                    title="focusManager.xhtml",

                    resource = "/resources/examples/core/focusManager/focusManager.xhtml"),

            // Java Source

            @ExampleResource(type = ResourceType.java,

                    title="FocusManagerBean.java",

                    resource = "/WEB-INF/classes/org/icefaces/samples/showcase"+

                    "/example/core/focusManager/FocusManagerBean.java")

        }

)

@Menu(

    title = "menu.core.focusManager.subMenu.title",

    menuLinks = {

            @MenuLink(title = "menu.core.focusManager.subMenu.main",

                    isDefault = true,

                    exampleBeanName = FocusManagerBean.BEAN_NAME)

    }

)

@ManagedBean(name = FocusManagerBean.BEAN_NAME)

@CustomScoped(value = "#{window}")

public class FocusManagerBean extends ComponentExampleImpl<FocusManagerBean> implements Serializable {

    public static final String BEAN_NAME = "focusManagerBean";

    public String getBeanName() { return BEAN_NAME; }



    private String focusedComponent = "";

    private String a, b, c, d = "";



    public FocusManagerBean() {

        super(FocusManagerBean.class);

    }



    @PostConstruct

    public void initMetaData() {

        super.initMetaData();

    }



    public String getFocusedComponent() {

        return focusedComponent;

    }



    public void setFocusedComponent(String focusedComponent) {

        this.focusedComponent = focusedComponent;

    }



    public String getA() {

        return a;

    }



    public void setA(String a) {

        this.a = a;

    }



    public String getB() {

        return b;

    }



    public void setB(String b) {

        this.b = b;

    }



    public String getC() {

        return c;

    }



    public void setC(String c) {

        this.c = c;

    }



    public String getD() {

        return d;

    }



    public void setD(String d) {

        this.d = d;

    }

}

ICE Core

WIKI Documentation

TLD Documentation

focusManager.xhtml

FocusManagerBean.java

A:
B:
C:	(Required)
D:	(Required)