Crear temáticas de formularios adaptables personalizadas

Requisitos previos

• Conocimiento del marco de trabajo LESS (CSS más inteligente)
• Crear una biblioteca de cliente en Adobe Experience Manager
• Crear una plantilla de formulario adaptable para utilizar la temática que cree

Temática del formulario adaptable

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

Puede crear una plantilla adaptable y aplicar la temática a la plantilla. Puede utilizar esta plantilla personalizada para crear una formulario adaptable.

Crear una temática de formulario adaptable

Figura: Ejemplo de la temática Forest

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

   Por ejemplo, cree el siguiente nodo:

   /apps/myAfThemes/forestTheme

2. Agregue una propiedad categories de cadena de varios valores al nodo y establezca su valor apropiadamente.

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

   

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

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

     Esta carpeta consta de less archivos de variables, less archivos de mezcla, less archivos que definen estilos mediante mezclas y variables. Y todos estos less los archivos se importan en styles.less.

   • css carpeta: Contiene los archivos .css en los que se definen los estilos estáticos que se utilizarán en la temática.

   Archivos de variables Less: estos son los archivos donde se definen o anulan las variables que se utilizan para definir estilos CSS.

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

   • /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 usar el complemento less que se proporcionan con los formularios adaptables, puede anular estas variables o crear nuevas less variables.

   NOTA

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

   Variables de anulación de ejemplo:

   @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 la variable less:

   1. Importe 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 Less 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);
   

   Archivos de mezcla Less: 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 less archivos (variables, mezclas, estilos) que debe utilizar en la biblioteca de cliente.

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

   Instrucciones para importar lo siguiente .less Los archivos son obligatorios:

   • 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 es necesario crear este archivo si no se ha definido ningún estilo, variable o mezcla personalizado.

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

   #base=less

   E incluir la siguiente línea:

   styles.less

Usar una temática en un formulario adaptable

Después de crear una temática de formulario adaptable, realice los siguientes pasos para utilizarlo de forma adaptativa:

1. Para incluir la temática creada en para crear una temática de formulario adaptable, cree una página personalizada de tipo cq:Component.

   Por ejemplo, /apps/myAfCustomizations/myAfPages/forestPage.

   1. Agregue una propiedad sling:resourceSuperType y establezca su valor como fd/af/components/page/base.

      

   2. Para utilizar una temática en la página, debe agregar un archivo de anulación library.jsp al nodo.

      A continuación, puede importar la temática creada en la sección Crear una temática de formulario adaptable de este artículo.

      El siguiente fragmento de código de ejemplo importa la temática af.theme.forest.

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

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

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

   

3. Crear un formulario adaptable mediante la plantilla creada en el paso anterior. El aspecto del formulario adaptable se define mediante la temática creada en la sección Crear una temática del formulario adaptable de este artículo.