Creación de un nuevo componente de campo de interfaz de usuario de Granite

La interfaz de usuario de Granite proporciona una serie de componentes diseñados para utilizarse en formularios; se denominan campos en el vocabulario de la interfaz de usuario de Granite. Los componentes de formulario Granite estándar están disponibles en:

/libs/granite/ui/components/foundation/form/*

Utilice la estructura Granite UI Foundation para desarrollar y/o ampliar componentes Granite. Tiene dos elementos:

• servidor:

  • una colección de componentes de base

    • base: modular, composable, legible, reutilizable
    • componentes: componentes Sling

  • ayuda para el desarrollo de aplicaciones

• cliente:

  • una colección de clientlibs que proporcionan algún vocabulario (es decir, la extensión del lenguaje HTML) para lograr patrones de interacción genéricos a través de una IU basada en Hypermedia

El componente genérico de la interfaz de usuario Granite field se compone de dos archivos de interés:

• init.jsp:: gestiona el procesamiento genérico; etiquetado, descripción y proporciona el valor del formulario que necesitará al procesar el campo.
• render.jsp:: aquí es donde se realiza la representación real del campo y debe anularse para el campo personalizado; está incluido por init.jsp.

Consulte la documentación de la interfaz de usuario de Granite: Campo si desea obtener más detalles.

Para ver ejemplos, consulte:

• cqgems/customizingfield/components/colorpicker

  • proporcionado por la Muestra de código

• granite/ui/components/foundation/form

Creación de la secuencia de comandos del lado del servidor para el componente

El campo personalizado solo debe anular la secuencia de comandos render.jsp, donde se proporciona la marca para el componente. Puede considerar el JSP (es decir, la secuencia de comandos de procesamiento) como un envoltorio para el marcado.

1. Cree un nuevo componente que utilice la propiedad sling:resourceSuperType para heredar de:

   /libs/granite/ui/components/foundation/form/field

2. Anular la secuencia de comandos:

   render.jsp

   En esta secuencia de comandos, debe generar el marcado de hipermedios (es decir, el marcado enriquecido, que contiene la asequibilidad de los hipermedios) para que el cliente sepa cómo interactuar con el elemento generado. Esto debe seguir el estilo de codificación de la interfaz de usuario Granite en el lado del servidor.

   Al personalizar, el único contrato que debe cumplir es leer el valor del formulario (inicializado en init.jsp) de la solicitud mediante:

   // Delivers the value of the field (read from the content)
   ValueMap vm = (ValueMap) request.getAttribute(Field.class.getName());
   vm.get("value, String.class");
   

   Para obtener más información, consulte la implementación de los campos predeterminados de la interfaz de usuario de Granite; por ejemplo, /libs/granite/ui/components/foundation/form/textfield.

   NOTA

   Por el momento, JSP es el método de secuencias de comandos preferido, ya que en HTL no es fácil pasar información de un componente a otro (algo bastante frecuente en el contexto de los campos o formularios).

Creación de la biblioteca de cliente para el componente

Para agregar un comportamiento específico del lado del cliente a su componente:

1. Cree una clientlib de categoría cq.authoring.dialog.

2. Cree una clientlib de categoría cq.authoring.dialog y defina su JS/ CSS interior.

   Defina su JS/ CSS dentro de la clientlib.

   NOTA

   En este momento, la interfaz de usuario de Granite no proporciona ningún detector o ganchos listos para usar que pueda utilizar directamente para añadir el comportamiento de JS. Por lo tanto, para agregar un comportamiento JS adicional a su componente, debe implementar un enlace JS en una clase personalizada que luego asigne a su componente durante la generación de marcado.