Creación de temáticas de formularios adaptables personalizadas

Requisitos previos

• Conocimiento del marco LESS (CSS más inteligente)
• Cómo crear una biblioteca de cliente en Adobe Experience Manager
• Creación de una plantilla de formulario adaptable para utilizar el tema que cree

Tema de formulario adaptable

Un tema de formulario adaptable es una biblioteca de cliente AEM que se utiliza para definir los estilos (aspecto y presentación) de un formulario adaptable.

Puede crear una plantilla adaptable y aplicar el tema a la plantilla. A continuación, utilice esta plantilla personalizada para crear un formulario adaptable.

Para crear un tema de formulario adaptable

Figura:Ejemplo de tema de bosque

1. Cree un nodo de tipo cq:ClientLibraryFolder en el nodo /apps.

   Por ejemplo, cree el nodo siguiente:

   /apps/myAfThemes/forestTheme

2. Añada una propiedad de cadena con varios valores categories en el nodo y defina su valor correctamente.

   Por ejemplo, establezca la propiedad en: af.theme.forest.

   

3. Añada dos carpetas, less y css, y un archivo css.txt al nodo creado en el paso 1:

   • less carpeta: Contiene los archivos less variables en los que se definen las less variables y less mixins que se utilizan para administrar los estilos .css.

     Esta carpeta consta de less archivos variables, less archivos mixtos, less archivos que definen estilos usando mezclas y variables. Y todos estos menos archivos se importan en estilos.less.

   • csscarpeta: Contiene los archivos .css en los que se definen los estilos estáticos que se utilizarán en el tema.

   Menos archivos de variables: Estos son los archivos en los que se definen o anulan las variables que se utilizan para definir estilos CSS.

   Los formularios adaptables proporcionan variables OOTB definidas en los siguientes archivos .less:

   • /apps/clientlibs/fd/af/guidetheme/common/less/globalvariables.less
   • /apps/clientlibs/fd/af/guidetheme/common/less/layoutvariables.less

   Los formularios adaptables también proporcionan variables de terceros definidas en:

   /apps/clientlibs/fd/af/third-party/less/variables.less

   Puede utilizar las menos variables proporcionadas con los formularios adaptables, puede anular estas variables o puede crear nuevas menos variables.

   NOTA

   Al importar los archivos del preprocesador menor, en la instrucción import especifique la ruta relativa de los archivos.

   Variables de anulación de muestra:

   @button-background-color: rgb(19, 102, 44);
   @button-border-color: rgb(19, 102, 44);
   @button-border-size: 0px;
   @button-padding: 10px 15px;
   @button-font-color: #ffffff;
   

   Para anular las variables less:

   1. Importar variables de formulario adaptable predeterminadas:

      /apps/clientlibs/fd/af/guidetheme/common/less/globalvariables.less/apps/clientlibs/fd/af/guidetheme/common/less/layoutvariables.less

   2. A continuación, importe el archivo menos que incluya variables anuladas.

   Ejemplo de nuevas definiciones de variables:

   @button-focus-bg-color: rgb(40, 208, 90);
   @button-hover-bg-color: rgb(30, 156, 67);
   

   Menos archivos de mezcla: puede definir las funciones que aceptan variables como argumentos. El resultado de estas funciones son los estilos resultantes. Utilice estas mezclas en diferentes estilos para evitar la repetición de estilos CSS.

   Los formularios adaptables proporcionan mezclas de OOTB definidas en:

   • /apps/clientlibs/fd/af/guidetheme/common/less/adaptiveforms-mixins.less

   Los formularios adaptables también proporcionan mezclas de terceros definidas en:

   • /apps/clientlibs/fd/af/third-party/less/mixins.less

   Definición de mezcla de muestra:

   .rounded-corners (@radius) {
     -webkit-border-radius: @radius;
     -moz-border-radius: @radius;
     -ms-border-radius: @radius;
     -o-border-radius: @radius;
     border-radius: @radius;
   }
   
   .border(@color, @type, @size) {
      border: @color @size @type;
   }
   

   Archivo Styles.less: utilice este archivo para incluir todos los menos archivos (variables, mezclas, estilos) que necesite utilizar en la biblioteca del cliente.

   En el siguiente archivo de ejemplo styles.less, la sentencia import se puede colocar en cualquier orden.

   Las instrucciones para importar los siguientes archivos .less son obligatorias:

   • globalvariables.less
   • layoutvariables.less
   • components.less
   • layouts.less

   @import "../../../clientlibs/fd/af/guidetheme/common/less/globalvariables.less";
   @import "../../../clientlibs/fd/af/guidetheme/common/less/layoutvariables.less";
   @import "forestTheme-variables";
   @import "../../../clientlibs/fd/af/guidetheme/common/less/components.less";
   @import "../../../clientlibs/fd/af/guidetheme/common/less/layouts.less";
   
   /* custom styles */
   
   .guidetoolbar {
     input[type="button"], button, .button {
       .rounded-corners (@button-radius);
       &:hover {
         background-color: @button-hover-bg-color;
       }
       &:focus {
         background-color: @button-focus-bg-color;
       }
     }
   }
   
   form {
       background-image: url(../images/forest.png);
    background-repeat: no-repeat;
    background-size: 100%;
   }
   

   El css.txt contiene las rutas de los archivos .css que se van a descargar para la biblioteca.

   Por ejemplo:

   #base=/apps/clientlibs/fd/af/third-party/css
   bootstrap.css
   
   #base=less
   styles.less
   
   #base=/apps/clientlibs/fd/xfaforms/xfalib/css
   datepicker.css
   listboxwidget.css
   scribble.css
   dialog.css
   

   NOTA

   El archivo style.less no es obligatorio. Esto significa que no necesita crear este archivo si no ha definido ningún estilo personalizado, variable o mezcla.

   Sin embargo, si no crea un archivo style.less, en el archivo css.txt, debe quitar el comentario de la línea siguiente:

   #base=less

   Y comenta la siguiente línea:

   styles.less

Para utilizar un tema en un formulario adaptable

Después de crear un tema de formulario adaptable, realice los siguientes pasos para utilizar este tema en un formulario adaptable:

1. Para incluir el tema creado en la sección para crear un tema de formulario adaptable, cree una página personalizada de tipo cq:Component.

   Por ejemplo, /apps/myAfCustomizations/myAfPages/forestPage

   1. Añada una propiedad sling:resourceSuperType y defina su valor como fd/af/components/page/base.

      

   2. Para utilizar un tema en la página, debe agregar un archivo de sobrescritura library.jsp al nodo.

      A continuación, importe el tema creado en Para crear una sección de tema de formulario adaptable de este artículo.

      El siguiente fragmento de código de ejemplo importa el tema af.theme.forest.

      <%@include file="/libs/fd/af/components/guidesglobal.jsp?lang=es"%>
      <cq:includeClientLib categories="af.theme.forest"/>
      

   3. Opcional: En la página personalizada, reemplace header.jsp, filename.jsp y body.jsp, según sea necesario.

2. Cree una plantilla personalizada (por ejemplo: /apps/myAfCustomizations/myAfTemplates/forestTemplate) cuyo jcr:content apunta a una página personalizada creada en el paso anterior (por ejemplo: myAfCustomizations/myAfPages/forestPage).

   

3. Cree un formulario adaptable con la plantilla creada en el paso anterior. El aspecto del formulario adaptable se define mediante el tema creado en Para crear una sección de tema de formulario adaptable de este artículo.