创建自定义自适应表单主题 creating-custom-adaptive-form-themes

创建节点类型 cq:ClientLibraryFolder 在 /apps节点。

例如，创建以下节点：

/apps/myAfThemes/forestTheme

添加多值字符串属性 categories ，并相应地设置其值。

例如，将属性设置为： af.theme.forest.

添加两个文件夹， less 和 css和文件 css.txt 到步骤1中创建的节点：

• less 文件夹：包含 less 变量文件，在其中定义 less 变量和 less mixins 用于管理.css样式的属性。

  此文件夹包括 less 变量文件， less mixin文件， less 使用mixin和变量定义样式的文件。 还有这些 less 然后文件会以styles.less格式导入。

• css文件夹：包含.css文件，您可以在其中定义要在主题中使用的静态样式。

更少变量文件：这些是您在其中定义或覆盖在定义CSS样式中使用的变量的文件。

自适应表单提供以下定义的现成变量 .less 文件：

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

自适应表单还提供中定义的第三方变量：

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

您可以使用 less 自适应表单随附的变量，您可以覆盖这些变量，也可以新建 less 变量。

覆盖变量的示例：

@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;

要覆盖 less变量：

1. 导入默认自适应表单变量：

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

2. 然后导入包含被覆盖变量的较少文件。

新变量定义示例：

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

更少的mixin文件： 您可以定义接受变量作为参数的函数。 这些函数的输出是生成的样式。 请在不同的样式中使用这些mixin，以避免重复CSS样式。

自适应表单提供中定义的现成mixin：

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

自适应表单还提供中定义的第三方mixin：

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

示例mixin定义：

.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;
}

Styles.less文件： 使用此文件可包含所有 less 必须在客户端库中使用的文件（变量、mixin、样式）。

在以下示例中 styles.less 文件，导入语句可以按任意顺序放置。

用于导入以下项的语句 .less 文件是必需的：

• 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%;
}

此 css.txt 包含要为库下载的.css文件的路径。

例如：

#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

要包含在中创建的主题，请执行以下操作 创建自适应表单主题 部分，创建类型为的自定义页面 cq:Component.

例如，/apps/myAfCustomizations/myAfPages/forestPage

1. 添加 sling:resourceSuperType 属性并将其值设置为 fd/af/components/page/base.

   

2. 要在页面中使用主题，必须将覆盖文件library.jsp添加到节点。

   然后，您可以导入在本文的创建自适应表单主题部分中创建的主题。

   以下示例代码片段导入 af.theme.forest 主题。

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

3. 可选：在自定义页面中，根据需要覆盖header.jsp、footer.jsp和body.jsp。

创建自定义模板(例如： /apps/myAfCustomizations/myAfTemplates/forestTemplate)的jcr：content指向在上一步中创建的自定义页面(例如： myAfCustomizations/myAfPages/forestPage).

使用上一步中创建的模板创建自适应表单。 自适应表单的外观由本文创建自适应表单主题部分中创建的主题定义。