Árbol de componentes JSF

EGL permite actualizar dinámicamente el aspecto de los controles JSF que se visualizan en un navegador Web. Por ejemplo, puede cambiar el color de un recuadro de texto si el usuario especifica información no válida en dicho recuadro. Estos cambios se producen en el servidor de aplicaciones Web, afectando a la información disponible para el JSP que, a su vez, presenta la página Web al navegador.

EGL accede a los componentes JSF a través del árbol de componentes JSF de la página, una estructura basada en XML que identifica los componentes JSF especificados en el archivo JSP. Al utilizar el árbol de componentes JSF, se asocia una variable EGL con el componente JSF al que se desea acceder. A continuación, puede realizar sobre esa variable EGL las mismas funciones que puede realizar en el propio componente JSF, como por ejemplo cambiar el estilo y otras propiedades. Para obtener una lista completa de los componentes JSF y de las funciones disponibles para cada uno de ellos, consulte la documentación de Java Server Faces en http://java.sun.com/j2ee/javaserverfaces/1.1_01/docs/api/index.html.

En general, puede acceder a los controles de JSF de una página Web siguiendo estos pasos. Para obtener más información y un ejemplo completo, consulte la sección Acceso a un componente JSF desde un pageHandler.
  1. Cree un proyecto Web EGL con soporte de interfaz de componentes JSF o añada soporte de interfaz de componentes JSF a un proyecto Web EGL existente. Consulte la sección Añadir soporte de interfaz de componentes JSF a un proyecto Web EGL.
  2. Cree un archivo Faces JSP y añádale uno o varios componentes JSF.
  3. En el archivo de código de página de la página, añada el siguiente código. Si ha creado el archivo Faces JSP después de añadir soporte para la interfaz de componentes JSF al proyecto, este código se añadirá al archivo de código de página automáticamente.
    • Añada la siguiente sentencia import:
      import com.ibm.egl.jsf.*
    • Dentro del pageHandler de la página, cree una variable de tipo UIViewRoot.
    • Especifique el nombre de la variable UIViewRoot en la propiedad viewRootVar de pageHandler.
  4. Cree una variable del tipo de control JSF al que desee acceder o haga que lo cree automáticamente el asistente de código fuente. Para obtener más información, consulte la sección Acceso a un componente JSF con el asistente de código fuente. Por ejemplo, una variable de tipo HtmlInputText hace referencia a un campo de entrada JSF de la página. El código que sigue crea una variable de tipo HtmlInputText:
    myControl HtmlInputText;
  5. Enlace la variable con el componente JSF, utilizando la variable UIViewRoot. Por ejemplo, el código que sigue enlaza una variable de tipo HtmlInputText con un campo de entrada de texto JSF denominado inputField1 dentro de un formulario denominado form1:
    myControl = myViewRoot.findComponent("form1:inputField1");
  6. Utilice la variable para cambiar el componente JSF. Por ejemplo, el código que sigue cambia el texto de un campo de entrada al color rojo:
    myControl.setStyle("color : red");

Conceptos relacionados
Propiedad viewRootVar

Tareas relacionadas
Añadir soporte de interfaz de componentes JSF a un proyecto Web EGL
Acceso a un componente JSF desde un pageHandler
Cambiar la clase de estilo de un componente JSF
Cambiar el estilo de un componente JSF
Cambiar el destino de un enlace JSF
Habilitar e inhabilitar componentes JSF
Establecer el tamaño de una imagen JSF
Establecer manejadores de eventos para un componente JSF
Establecer propiedades de tabla de datos JSF

Consulta relacionada
Componentes de acceso del árbol de componentes

Comentarios
(C) Copyright IBM Corporation 2000, 2005. Reservados todos los derechos.