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 estándar de Granite están disponibles en:
/libs/granite/ui/components/foundation/form/*
Estos campos de formulario de la interfaz de usuario de Granite son de especial interés, ya que se utilizan para cuadros de diálogo de componentes.
Para obtener más información sobre los campos, consulte la Documentación de Granite UI.
Utilice el marco de Granite UI Foundation para desarrollar o ampliar componentes de Granite. Tiene dos elementos:
del lado del servidor:
una colección de componentes de base
ayuda para el desarrollo de aplicaciones
lado del cliente:
El componente genérico de la interfaz de usuario de Granite field
consta 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 más detalles.
Para ver ejemplos, consulte:
cqgems/customizingfield/components/colorpicker
granite/ui/components/foundation/form
Como este mecanismo utiliza JSP, i18n y XSS no se incluyen de serie. Esto significa que tendrá que internacionalizar y escapar de sus cadenas. El siguiente directorio contiene los campos genéricos de una instancia estándar, puede utilizarlos como referencia:
/libs/granite/ui/components/foundation/form
directory
El campo personalizado solo debe anular la variable render.jsp
, donde se proporciona el marcado para el componente. Puede considerar el JSP (es decir, el script de renderización) como un envoltorio para el marcado.
Cree un nuevo componente que use el sling:resourceSuperType
propiedad de la que heredar:
/libs/granite/ui/components/foundation/form/field
Anule la secuencia de comandos:
render.jsp
En esta secuencia de comandos, se 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 de Granite del lado del servidor.
Al personalizar, el único contrato que must el cumplimiento es leer el valor del formulario (inicializado en init.jsp
) de la solicitud utilizando:
// 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
.
En este momento, JSP es el método preferido para las secuencias de comandos, ya que el paso de información de un componente a otro (que es bastante frecuente en el contexto de los formularios o campos) no se consigue fácilmente en HTL.
Para añadir un comportamiento específico del lado del cliente a su componente:
Crear una clientlib de categoría cq.authoring.dialog
.
Crear una clientlib de categoría cq.authoring.dialog
y defina su JS
/ CSS
dentro de él.
Defina su JS
/ CSS
dentro de la clientlib.
En este momento, la interfaz de usuario de Granite no proporciona ningún oyente ni gancho listos para usar que pueda utilizar directamente para agregar el comportamiento de JS. Por lo tanto, para añadir un comportamiento JS adicional al componente, debe implementar un vínculo JS a una clase personalizada que luego asigne al componente durante la generación del marcado.