Crear o personalizar una temática de formulario adaptable introduction-to-theme

Versión
Vínculo del artículo
AEM as a Cloud Service
Haga clic aquí
AEM 6.5
Este artículo

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.

    Estructura de la temática Lienzo

  • 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.

NOTE
  • 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:

  1. Abra el símbolo del sistema o la ventana de terminal en su entorno de desarrollo local.

  2. 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
    
  3. 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:

  1. Abra el archivo <your-theme-sources>/src/site/_variables.scss para editarlo.

  2. 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.

    Ejemplo: color de error establecido en azul

  3. 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:

  1. 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.

  2. 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 clase cmp-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;
     }
    
  3. Guarde y cierre el archivo.

NOTE
Cuando se define un estilo tanto en el nivel de tema como de componente, el estilo definido en el nivel de componente tiene prioridad.

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:

  1. Abra el símbolo del sistema o la ventana de terminal.

  2. Navegue hasta la carpeta <your-theme-sources>. Por ejemplo, C:\aem-forms-theme-canvas

  3. 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 es customcanvastheme, ejecute el siguiente comando

    code 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].

    Generación de biblioteca de cliente

    Ubicación de la biblioteca de cliente

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:

  1. 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>

  2. Abra el símbolo del sistema o el terminal.

  3. 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.

  4. Ejecute el siguiente comando para implementar el tema personalizado en su entorno:

    mvn clean install

    Compilación de biblioteca de cliente

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:

  1. AEM Inicie sesión en su entorno de.
  2. Abra el Administrador de paquetes. La URL predeterminada es https://localhost:4502/crx/packmgr/index.jsp.
  3. Haga clic en Cargar paquete y luego en Examinar.
  4. Vaya a y seleccione [AEM Archetype Project Folder]\all\target[appid].all-[version].zip. Haga clic en Abrir.
  5. 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.

Biblioteca de cliente de temas

NOTE
Si tiene dificultades para acceder al cuadro de diálogo de inicio de sesión en una instancia de publicación para instalar el paquete a través del Administrador de paquetes, intente iniciar sesión a través de la siguiente URL: 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:

  1. AEM Inicie sesión en la instancia local de autor de la.

  2. Introduzca sus credenciales en la página de inicio de sesión de Experience Manager. Seleccione  Adobe Experience Manager  > Formularios  > Formularios y documentos.

  3. Haga clic en Crear > Forms adaptable.

  4. Seleccione una plantilla de componentes principales de Forms adaptable y haga clic en Siguiente. Aparecerá Agregar propiedades

  5. 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.
  6. 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:

  1. Inicie sesión en la instancia de autor.
  2. Abrir http://[Publish Server URL]:[PORT]/crx/de/index.jsp
  3. Navegue hasta apps/[AEM Archetype Project Folder]/clientlibs/[yourtheme].
  4. 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:

  1. 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>.

  2. Abra el archivo .content.xml e incluya los siguientes metadatos:

    code language-none
        formstheme:true
        allowproxy:true
    
  3. Guarde el archivo y vuelva a implementar la temática.

Ver también

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2