Crear o personalizar una temática de formulario adaptable introduction-to-theme
En AEM Forms AEM 6.5, una temática es una biblioteca de cliente de que se utiliza para definir los estilos (aspecto y presentación) de un formulario adaptable. Una temática contiene detalles de estilo para los componentes y paneles. Los estilos incluyen propiedades como colores de fondo, colores de estado, transparencia, alineación y tamaño. Al aplicar una temática, el estilo especificado se refleja en los componentes correspondientes. Una temática se administra de forma independiente sin hacer referencia a un formulario adaptable y se puede reutilizar en varios de estos.
Temas disponibles available-theme
AEM entorno de 6.5 proporciona los temas siguientes para los componentes principales basados en Forms adaptable:
Comprender la estructura de las temáticas understanding-structure-of-theme
Una temática es un paquete que incluye el archivo CSS, los archivos JavaScript y los recursos (como iconos) que definen el estilo de los formularios adaptables. Una temática de formulario adaptable sigue una organización específica, que consta de los siguientes componentes:
-
src/theme.scss
: esta carpeta incluye el archivo CSS que tiene un impacto amplio en toda la temática. Sirve como una ubicación centralizada para definir y administrar el estilo y el comportamiento de la temática. Al realizar ediciones en este archivo, puede realizar cambios que se apliquen universalmente en toda la temática, lo que influye en el aspecto y la funcionalidad tanto de las páginas de AEM Sites como de formularios adaptables. -
src/site
: esta carpeta contiene archivos CSS que se aplican a toda la página de un sitio de AEM. Estos archivos constan de código y estilos que afectan a la funcionalidad y al diseño general de la página del sitio de AEM. Cualquier modificación realizada aquí se reflejará en todas las páginas del sitio. -
src/components
: los archivos CSS de esta carpeta están diseñados para los componentes principales individuales de AEM. Cada carpeta dedicada para un componente incluye un archivo.scss
que aplica estilo a ese componente en particular dentro de un formulario adaptable. Por ejemplo, el archivo/src/components/button/_button.scss
contiene información de estilo para el componente Botón de Forms adaptable. -
src/resources
: esta carpeta contiene archivos estáticos como iconos, logotipos y fuentes. Estos recursos se utilizan para mejorar los elementos visuales y el diseño general del tema.
Crear una temática
AEM Forms 6.5 proporciona los temas que se enumeran a continuación para los componentes principales basados en Forms adaptable.
Puede personalizar cualquiera de estas temáticas para crear una temática.
Personalizar una temática customize-a-theme-core-components-based-adaptive-forms
La personalización de una temática hace referencia al proceso de modificación y personalización de la apariencia de una temática. Al personalizar una temática, cambia sus elementos de diseño, diseño, colores, tipografía y, a veces, el código subyacente. Esto le permite crear un aspecto único y personalizado para su sitio web o aplicación, al tiempo que mantiene la estructura y la funcionalidad básicas proporcionadas por la temática.
- Utilice el Administrador de paquetes para implementar una temática en todas las instancias de autor y Publish.
- Una biblioteca de cliente de temas se importa o exporta mediante el Administrador de paquetes como cualquier otro paquete.
Requisitos previos para personalizar una temática prerequisites
-
Habilitar los componentes principales de Forms adaptable para su entorno.
-
Instale la última versión de Apache Maven .Apache Mavenes una herramienta de automatización de compilaciones que se utiliza comúnmente en proyectos Java™. La instalación de la última versión garantiza que tenga las dependencias necesarias para la personalización de temáticas.
-
Aprenda a crear una biblioteca de cliente en Adobe Experience Manager. AEM proporciona bibliotecas de cliente, que permiten almacenar el código del lado del cliente en el repositorio, organizarlo en categorías y definir cuándo y cómo se debe servir cada categoría de código al cliente.
-
Instale un editor de texto sin formato. Por ejemplo, Microsoft® Visual Studio Code. Utilizar un editor de texto sin formato como Microsoft® Visual Studio Code proporciona un entorno fácil de usar para editar y modificar archivos de temas.
-
Asegúrese de que su entorno de AEM Forms esté en funcionamiento.
Consideraciones para personalizar una temática consideration
-
Asegúrese de usar el tipo de archivo del proyecto utilizado para habilitar los componentes principales de Forms adaptable en su entorno para personalizar las temáticas.
-
Al publicar un formulario adaptable, las bibliotecas de cliente no se publican automáticamente en la instancia de Publish. Asegúrese de publicar manualmente la biblioteca de cliente a la que se hace referencia en un formulario adaptable en los entornos de Publish.
-
El Adobe recomienda no cambiar los nombres de clase de las bibliotecas de cliente.
Personalizar una temática customize-a-theme-core-components
Crear o personalizar una temática es un proceso de varios pasos. Realice los pasos en el orden indicado para crear o personalizar la temática:
Los ejemplos proporcionados en el documento se basan en el tema Lienzo, pero puede clonar cualquier tema y personalizarlo con las mismas instrucciones. Estas instrucciones se aplican a cualquier tema, lo que le permite modificarlas según sus necesidades específicas.
1. Clone el repositorio Git de la temática clone-git-repo-of-theme
Para clonar una temática para componentes principales basados en formularios adaptables, elija una de las siguientes temáticas:
Siga estas instrucciones para clonar una temática:
-
Abra el símbolo del sistema o la ventana de terminal en su entorno de desarrollo local.
-
Ejecuta el comando
git clone
para clonar una temática.code language-none git clone [Path of Git Repository of the theme]
Reemplace la [Ruta del repositorio Git de la temática] con la URL real del repositorio de Git correspondiente de la temática
Por ejemplo, para clonar la temática Lienzo, ejecute el siguiente comando:
code language-none git clone https://github.com/adobe/aem-forms-theme-canvas
-
Seleccione Confiar en los autores de todos los archivos de la carpeta principal y haga clic en Sí, confío en los autores.
Después de ejecutar el comando correctamente, queda una copia local de la temática disponible en la carpeta aem-forms-theme-canvas
del equipo.
2. Personalizar la temática customize-the-theme
Tiene la flexibilidad de personalizar componentes individuales o realizar cambios en el nivel de tema mediante las variables globales de un tema. La modificación de variables globales tiene un efecto en cascada en todos los componentes individuales. Por ejemplo, puede utilizar variables globales para cambiar el color del borde de todos los componentes de un formulario adaptable o aplicar un color de relleno vibrante a los botones de llamada a la acción (CTA). Puede hacer lo siguiente:
Establecer estilos de nivel de temática theme-customization-global-level
El archivo variable.scss
contiene las variables globales del tema. Al actualizar estas variables, puede realizar cambios relacionados con los estilos en el nivel de la temática. Para aplicar estilos de nivel de tema, siga estos pasos:
-
Abra el archivo
<your-theme-sources>/src/site/_variables.scss
para editarlo. -
Cambia el valor de cualquier propiedad. Por ejemplo, el color de error predeterminado es rojo. Para cambiar el color del error de rojo a azul, cambie el código hexadecimal de color de la variable
$error
. Por ejemplo,$error: #196ee5
. -
Guarde y cierre el archivo.
Del mismo modo, puede utilizar el archivo variable.scss
para establecer la familia y el tipo de fuente, los colores de la temática y la fuente, el tamaño de fuente, el espaciado del tema, el icono de error, los estilos de borde del tema y más variables que afectan a varios componentes del formulario adaptable.
Definir estilos de nivel de componente component-based-customization
También tiene la opción de personalizar la fuente, el color, el tamaño y otras propiedades CSS de componentes principales específicos del formulario adaptable, como botones, casillas de verificación, contenedores, pies de página, etc. Al editar el archivo CSS asociado al componente específico, puede alinear su estilo con la marca de su organización. Para personalizar el estilo de un componente, siga estos pasos:
-
Abra el archivo
<your-theme-sources>/src/components/<component>/<component.scss>
para editarlo. Por ejemplo, para cambiar el color de fuente del componente Botón, abra el archivo<your-theme-sources>/src/components/button/button.scss
. -
Cambie el valor de cualquiera según sus necesidades. Por ejemplo, para cambiar el color del componente Botón al pasar el ratón por encima a Verde, cambie el valor de la propiedad
color: $white
en la clasecmp-adaptiveform-button__widget:hover
a código hexadecimal #12b453 o a cualquier otro tono de verde. El código final tiene el siguiente aspecto:code language-none .cmp-adaptiveform-button__widget:hover { background: $dark-gray; color: #12b453; }
-
Guarde y cierre el archivo.
3. Preparar el tema para la implementación generate-the-clientlib
AEM Para implementar una temática en una instancia de, debe convertirse en una biblioteca de cliente. Siga estos pasos para convertir la temática en una biblioteca de cliente:
-
Abra el símbolo del sistema o la ventana de terminal.
-
Navegue hasta la carpeta
<your-theme-sources>
. Por ejemplo,C:\aem-forms-theme-canvas
-
Ejecute el siguiente comando:
code language-none npm run create-clientlib --category=adaptiveform.theme.[yourtheme]
Reemplazar
[yourtheme]
con el nombre de su tema personalizado. Por ejemplo, si el nombre de la temática personalizada escustomcanvastheme
, ejecute el siguiente comandocode language-none npm run create-clientlib --category=adaptiveform.theme.customcanvastheme
Si el comando se ejecuta correctamente, se crea una carpeta de biblioteca de cliente en
themerepo\theme-clientlibs\[yourtheme]
.
4. Implementar el tema en un entorno local deploy-the-theme-on-a-local-environment
Para implementar el tema en el entorno de desarrollo o prueba local, siga estos pasos:
-
Copie la biblioteca de cliente, creada en la sección anterior, en el proyecto Archetype, en la siguiente ruta:
/ui.apps/src/main/content/jcr_root/apps/[AEM Archetype Project Folder]/clientlibs/<yourtheme>
-
Abra el símbolo del sistema o el terminal.
-
AEM Vaya al directorio raíz del proyecto de tipo de archivo de la, el proyecto utilizado para habilitar los componentes principales del formulario adaptable.
-
Ejecute el siguiente comando para implementar el tema personalizado en su entorno:
mvn clean install
5. Implementar un tema en el entorno de producción deploy-theme
Una vez que haya probado correctamente el tema en su entorno de desarrollo local, puede continuar implementando el tema en los entornos de producción, incluidas las instancias de autor y Publish. Siga estos pasos para implementar el tema en los entornos de producción:
- AEM Inicie sesión en su entorno de.
- Abra el Administrador de paquetes. La URL predeterminada es
https://localhost:4502/crx/packmgr/index.jsp
. - Haga clic en Cargar paquete y luego en Examinar.
- Vaya a y seleccione
[AEM Archetype Project Folder]\all\target[appid].all-[version].zip
. Haga clic en Abrir. - Haga clic en Instalar. Repita el paso en todos los entornos de producción.
Una vez instalado el paquete, la temática está disponible para su selección.
http://[Publish Server URL]:[PORT]/system/console
. Esto permite acceder a la instancia de Publish, lo que le permite continuar con el proceso de instalación.Aplicar una temática a un formulario adaptable using-theme-in-adaptive-form
Los pasos para aplicar una temática a un formulario adaptable son los siguientes:
-
AEM Inicie sesión en la instancia local de autor de la.
-
Introduzca sus credenciales en la página de inicio de sesión de Experience Manager. Seleccione Adobe Experience Manager > Formularios > Formularios y documentos.
-
Haga clic en Crear > Forms adaptable.
-
Seleccione una plantilla de componentes principales de Forms adaptable y haga clic en Siguiente. Aparecerá Agregar propiedades
-
Especifique Name para el formulario adaptable.
note note NOTE - De manera predeterminada, el tema
adaptiveform.theme.canvas3
está seleccionado. - Puede elegir una temática diferente del menú desplegable Biblioteca cliente de temáticas.
- De manera predeterminada, el tema
-
Haga clic en Crear.
Las temáticas se utilizan como parte de una plantilla de formulario adaptable para definir el estilo al crear un formulario adaptable.
Eliminar una temática delete-a-theme
Para eliminar temas no utilizados o no deseados:
- Inicie sesión en la instancia de autor.
- Abrir
http://[Publish Server URL]:[PORT]/crx/de/index.jsp
- Navegue hasta
apps/[AEM Archetype Project Folder]/clientlibs/[yourtheme]
. - Elimine la carpeta de la temática y guarde los cambios.
Pregunta más frecuente faq
P: ¿Qué personalización tiene prioridad al realizar personalizaciones en una carpeta de temas tanto a nivel global como a nivel de componente?
R: Cuando se define un estilo tanto en el nivel de tema como de componente, el estilo definido en el nivel de componente tiene prioridad.
Q: ¿Qué pasos se deben seguir si el tema personalizado no está visible en la Biblioteca cliente de temas?
R: Si el tema personalizado no aparece en la lista desplegable Biblioteca cliente de temas, siga estos pasos:
-
Vaya a la ubicación en la que ha agregado la biblioteca de cliente de temas personalizada. La ruta recomendada es
/ui.apps/src/main/content/jcr_root/apps[AEM Archetype Project Folder]/clientlibs/<yourtheme>
. -
Abra el archivo
.content.xml
e incluya los siguientes metadatos:code language-none formstheme:true allowproxy:true
-
Guarde el archivo y vuelva a implementar la temática.
Ver también
- Crear un formulario adaptable basado en componentes principales
- Utilice el editor de reglas para agregar un comportamiento dinámico al formulario
- Crear o personalizar temáticas para componentes principales basados en Forms adaptable
- Crear una plantilla para componentes principales basados en Forms adaptable
- Crear o agregar un formulario adaptable a una página de AEM Sites o a un fragmento de experiencia
- Plantillas temáticas y modelos de datos de formularios de ejemplo