创建和使用主题 creating-and-using-themes

Adobe 建议使用现代、可扩展的数据捕获核心组件,以创建新的自适应表单将自适应表单添加到 AEM Sites 页面。这些组件代表有关创建自适应表单的重大改进,确保实现令人印象深刻的用户体验。本文介绍了使用基础组件创作自适应表单的旧方法。

版本
文章链接
AEM as a Cloud Service
单击此处
AEM 6.5
本文

简介 introduction

您可以创建并应用主题来使自适应表单或交互式通信风格化。 主题包含组件和面板的样式详细信息。 样式包括背景颜色、状态颜色、透明度、对齐方式和大小等属性。应用主题时,指定的样式反映在相应的组件上。 主题是独立管理的,无需引用自适应表单或交互式通信。

您可以:

  • 创建主题
  • 编辑和复制现有主题
  • 下载现有主题并将其上传到AEM Forms服务器
  • 管理主题的依赖关系

创建、下载或上传主题 creating-downloading-or-uploading-a-theme

通过AEM Forms,您可以创建、下载或上传主题。 创建主题的方式与创建表单、文档和信件等其他资产类似。 该主题将另存为单独的实体,并包含类似于表单的元属性。 作为单独实体的主题允许在多个自适应表单和交互式通信中重用。 您还可以将主题移动到AEM Forms的其他实例中并重复使用。

创建主题 creating-a-theme

执行以下步骤可创建主题:

  1. 单击 Adobe Experience Manager,单击 Forms,然后单击 主题.

  2. 在“主题”页面中,单击 创建>主题.
    将启动创建主题的向导。

  3. 在创建主题向导的基本选项卡中,提供 标题名称 主题的。 这些是必填字段。

  4. 在“高级”选项卡中,您将获得两个字段:

    • Clientlib位置:存储库中存储主题的clientlibs的位置。

    • Clientlib类别:提供文本字段以输入主题的clientlib类别名称。

  5. 单击 创建 然后单击 编辑 在主题编辑器中打开主题,或单击 完成 以返回主题页面。

下载主题 downloading-a-theme

您可以将主题导出为zip文件,并在其他项目或AEM实例中使用这些主题。 要下载主题,请执行以下操作:

  1. 单击 Adobe Experience Manager,单击 Forms,然后单击 主题.

  2. 在“主题”页面中, 选择 主题,然后单击 下载. 此时将显示一个对话框,其中包含主题的详细信息。

  3. 单击 下载. 主题将下载为zip文件。

NOTE
如果下载的主题具有与之关联的自适应表单,并且关联的自适应表单基于自定义模板,则也要下载自定义模板。 将下载的主题和自适应表单上传到AEM Forms服务器时,还应上传相关的自定义模板。

上传主题 uploading-a-theme

您可以在项目中将创建的主题与样式预设一起使用。 您可以通过将其他人创建的主题包上传到您的项目来导入这些主题包。

要上传主题,请执行以下操作:

  1. 单击 Adobe Experience Manager,单击 Forms,然后单击 主题.

  2. 在“主题”页面中,单击 “创建”>“文件上传”.

  3. 在“文件上传”提示符下,浏览并选择计算机上的主题包,然后单击 上传.
    上传的主题可在主题页面中找到。

主题的元数据 metadata-of-a-theme

主题的元属性列表(可在主题的属性页面中找到)。

ID
名称
可以编辑
属性说明
1.
标题
主题的显示名称。
2.
描述
有关主题的描述。
3.
类型
  • 资源类型。
  • 值始终为“主题”。
4.
创建时间
主题创建日期
5.
作者姓名
主题的作者。 在创建主题时计算。
6.
上次修改日期
上次修改主题的日期。
7.
状态
主题状态(已修改/已发布)。
8.
准时发布
自动发布主题的时间。
9.
发布关闭时间
自动取消发布主题的时间。
10.
标记
附加到用于标识的主题的标签,用于改进搜索。
11.
引用
链接
  • 包含“引用者”部分。 列出使用主题的表单。
  • 由于主题未引用任何其他资源,因此没有“引用”部分。
12.
Clientlib 位置
  • “/etc”中存储与此主题对应的clientlibs的用户定义存储库路径。
  • 默认值 — “/etc/clientlibs/fd/themes”+主题资源的相对路径。
  • 如果该位置不存在,则会自动生成文件夹层次结构。
  • 更改此值后,clientlib节点结构将移至输入的新位置。
    注意: 如果更改默认clientlib位置,请在CRXDE存储库中分配 crx:replicate, rep:write, rep:glob:*, rep:itemNames:: js.txt, jcr:read forms-userscrx:replicatejcr:read fd-service 在新位置。 另外通过添加添加其他ACL deny jcr:addChildNodes 对象 forms-user
13.
Clientlib 类别名称
  • 此主题的用户定义clientlib类别名称。
  • 如果该名称已被其他现有主题使用,则会显示错误。
  • 默认值 — 使用主题位置计算。
  • 更改此值后,将在相应的clientlib节点上更新类别名称。 不需要更新jsp文件中的Clientlib类别名称,因为引用使用了clientlib类别名称。

关于主题编辑器 about-the-theme-editor

AEM Forms附带主题编辑器。 它是一个便于企业用户和Web设计人员/开发人员使用的界面,提供了轻松指定各种自适应表单和交互式通信元素样式所需的功能。 创建主题时,该主题将存储为一个单独的实体,如表单、交互式通信、字母、文档片段和数据字典。

通过主题编辑器,可自定义主题中样式化组件的样式。 您可以自定义表单或交互式通信在设备上的外观。

主题编辑器分为两个面板:

  • 画布 — 显示在右侧。 它显示了一个自适应表单或交互式通信示例,其中所有样式更改都会立即反映。 也可以直接从画布中选择对象来查找与其关联的样式,并编辑这些样式。 顶部的设备分辨率标尺控制画布。 从标尺中选择分辨率断点将显示相应分辨率的示例表单预览或交互式通信。 画布将进行详细讨论 以下.

  • 侧栏 — 显示在左侧。 它包括以下项:

    • 选择器: 显示选定用于设置样式的组件及其可设置样式的属性。 选择器表示某个类型的所有组件。 如果为样式选择主题中的文本框组件,则表单或交互式通信中的所有文本框将继承样式。 选择器允许您选择通用组件或特定组件来设置样式。 例如,字段组件是通用组件,文本框是特定组件。

      设置常规组件的样式:
      字段可以是数字框字段(如年龄)或文本框字段(如地址)。
      设置字段样式时,所有字段(如年龄、姓名、地址)都会设置样式。

      设置特定组件的样式:特定组件影响特定类别的对象。 在主题中设置数字框组件的样式时,只有中的数字框对象会继承该样式。

      例如,文本框字段(如地址)的长度较长,而数字框字段(如年龄)的长度较短。 您可以选择数字框字段,缩短其长度并应用于表单。 表单中的所有数字框字段的宽度都会缩小。

      使用特定的背景颜色自定义所有字段组件时,所有字段(如年龄、名称和地址)将继承背景颜色。 如果选择数字框(如年龄)并减小其宽度,则所有数字框的宽度(如年龄)都会减小,家庭中的人数也会减少。 文本框的宽度不会更改。

    • 状态: 允许您自定义处于特定状态的对象的样式。 例如,您可以指定对象在默认、集中、禁用、悬停或错误状态时的外观。

    • 属性类别: 样式属性分为不同的类别。 例如,Dimension和位置、文本、背景、边框和效果。 在每个类别下,您都会提供样式信息。 例如,在“背景”下,您可以提供“背景颜色”和“图像和渐变”。

    • 高级: 允许您将自定义CSS添加到对象,这将覆盖可视化控件定义的属性(如果存在重叠)。

    • 查看CSS:用于查看选定组件的CSS

    此外,在侧栏的底部有一个箭头。 单击箭头时,您会获得两个其他选项: 模拟成功模拟错误。 对这些选项以及上述选项进行了详细讨论 以下.

突出显示边栏和画布的主题编辑器。 答: 侧栏 B. 画布

设置组件样式 styling-components

您可以在多个自适应表单和交互式通信中使用主题,这会导入您在主题中指定的组件格式。 您可以设置各种组件的样式,如标题、描述、面板、字段、图标和文本框。 使用小组件配置主题中的组件属性。 虽然CSS覆盖部分允许您编写CSS代码或提供自定义选择器,但并不要求您事先了解CSS或LESS。 在侧栏中选择组件时,将显示“CSS覆盖”部分。

侧栏中的可样式化组件

侧栏中的选项,用于选择和设置不同组件的样式。

单击侧边栏中某个组件的编辑按钮会选择画布中的组件,并允许您使用侧边栏中的选项设置组件样式。

某些组件(如文本框、数字框、单选按钮和复选框)在“字段”等类属组件下分类。 例如,要自定义单选按钮的样式。 要选择用于样式设置的单选按钮,请选择 字段>小组件>单选按钮.

单击 全部展开 在侧栏中,查看、选择和设置之前不可见的已分类组件的样式。

样式化面板布局 styling-panel-layouts-br

AEM Forms中的主题支持对表单和交互式通信中面板布局中的元素进行样式设置。 支持在现成布局和自定义布局中设计元素的样式。

现成的面板包括:

  • 左侧选项卡

  • 顶部选项卡

  • 可折叠项

  • 响应式

  • 向导

  • 移动设备布局

    • 标题中的面板标题
    • 标题中没有面板标题

选择器会因每个布局而异。
从主题编辑器设计自定义布局的样式涉及:

  • 为可设置样式的布局定义组件以及用于唯一标识这些组件的CSS选择器
  • 定义可以应用于这些组件的CSS属性
  • 从用户界面以交互方式定义这些组件的样式

不同屏幕大小的不同样式 different-styles-for-different-screen-sizes-br

桌面版和移动设备版面可以具有略微不同的样式,也可以具有完全不同的样式。 对于移动设备,平板电脑和手机共享相似的布局(组件大小除外)。

使用主题编辑器断点为不同屏幕大小定义替代样式。 您可以选择开始构建主题的基本设备或分辨率,并自动生成其他分辨率的样式变体。 您可以显式修改所有分辨率的样式。

NOTE
该主题首先使用表单或交互式通信创建,然后应用于不同的表单或交互式通信。 主题创建中使用的断点可能与应用主题的表单或交互式通信不同。 CSS媒体查询基于主题创建中使用的表单或交互式通信,而不是应用主题的表单或交互式通信。

选择对象时侧栏中的样式属性上下文更改 styling-properties-context-changes-in-sidebar-on-selecting-objects

在画布中选择组件时,其样式设置属性会列在侧栏中。 选择对象类型及其状态,然后提供其样式。

主题编辑器中最近使用的样式 recently-used-styles-in-theme-editor

主题编辑器可缓存多达10种应用于组件的样式。 您可以将缓存的样式与主题的其他组件一起使用。 最近使用的样式将作为列表框显示在侧边栏中选定组件的正下方。 最初,最近使用的样式列表为空。

asset-library

在设置组件样式时,将缓存样式并将其列在列表框中。 在此示例中,文本框的标签被设置为更改字体大小和颜色。 可以按照类似步骤选择图像或更改颜色来设置组件的样式。 观察更改字段标签样式时,如何缓存样式并将其列在列表框中。

为可用于其他组件的组件缓存的字体样式

在此示例中,字段标签的样式发生了更改,并且当为样式选择了响应面板描述时,列表条目会添加到资产库中。 资源库中的条目可用于更改响应面板描述的样式。

将样式添加到资产库后,该样式可用于其他主题和 样式模式 表单编辑器UI或交互式通信编辑器UI的页面。 同样,使用表单编辑器或交互式通信编辑器UI的样式模式来设置组件的样式时,将缓存该样式并可在主题中使用。

通过资产库旁边的加号按钮,您可以使用提供的名称永久保存样式。 加号按钮可保存样式,即使您未单击侧边栏中的“保存”按钮以将样式应用于组件也是如此。 在样式模式中,保存样式以供以后使用的加号按钮不可用。

为资源库提供自定义样式名称

当您为样式提供自定义名称时,该样式将绑定到主题,并且不再可用于其他主题。 要删除保存的样式:

  1. 在“画布”工具栏上,单击 主题选项 theme-options > 管理样式.

  2. 在“管理样式”对话框中,选择一个保存的样式,然后单击 删除.

    删除保存的样式

实时预览、保存和放弃更改 live-preview-save-and-discard-changes

在样式中所做的修改会立即反映在画布中加载的表单或交互式通信中。 实时预览允许您以交互方式定义并查看样式的影响。 当您更改组件的样式时, 完成 在侧栏中启用了按钮。 要保留更改,请使用 完成 按钮。

NOTE
在字段中输入无效字符时,字段边界颜色将更改为红色,并在屏幕左上角显示错误消息。 例如,如果在接受数字字符作为输入的文本框中输入字母,则输入框边界颜色将更改为红色。 如果不解决顶部显示的错误,则无法保存此类主题。

使用其他自适应表单或交互式通信的主题 theme-with-another-adaptive-form-or-interactive-communication

创建主题时,将使用主题编辑器附带的表单来创建主题。 在此表单中提供组件的样式。 您可以选择自己选择的表单或交互式通信来提供样式并预览其结果,而不是主题编辑器附带的表单。

替换主题编辑器画布中的当前表单或交互式通信:

  1. 在主题编辑器面板中,单击 主题选项 theme-options > 配置.

  2. 在常规选项卡中,浏览并选择表单或交互式通信 自适应表单/文档 字段。

重做/撤消 redo-undo

您可以撤消或重做意外发生的不必要的更改。 使用画布中的重做/撤消按钮。

重做和撤消操作

画布中的“撤消/重做”按钮

在主题编辑器中为组件设置样式时,会显示重做/撤消按钮。

使用主题编辑器 using-the-theme-editor

通过主题编辑器,可以编辑您创建或上传的主题。 导航到 Forms和文档>主题,然后选择主题并将其打开。 主题将在主题编辑器中打开。

如上所述,主题编辑器包含两个面板:侧栏和画布。
主题编辑器

在主题编辑器中自定义文本框构件组件的成功状态样式。 组件在画布中处于选中状态,其状态在侧栏中处于选中状态。 侧边栏中可用的样式选项用于自定义组件的外观。

使用画布 using-canvas

主题是使用现成表单创建的,或使用您选择的表单或交互式通信创建的。 画布显示表单或交互式通信的预览,这些表单或交互式通信用于使用主题中指定的自定义项创建主题。 表单上方的标尺用于根据设备的显示大小确定布局。

在“画布”工具栏中,您会看到:

  • 切换侧面板 切换侧面板 :用于显示或隐藏侧栏。

  • 主题选项 theme-options :提供三个选项

    • 配置:提供用于选择预览表单或交互式通信、基本clientlib和Adobe Fonts配置的选项。
    • 查看主题CSS:为所选主题生成CSS。
    • 管理样式:提供用于管理文本和图像样式的选项
    • 帮助:运行主题编辑器的图像引导式教程。
  • 模拟器 标尺 :模拟不同显示大小的主题外观。 在模拟器中将显示大小视为断点。 您可以选择断点并为其指定样式。 例如,台式机和平板电脑是两个断点。 您可以为每个断点指定不同的样式。

在画布中选择组件时,您会看到其顶部的组件工具栏。 通过组件工具栏,您可以选择组件,或切换到通用组件。 例如,在面板中选择一个数字文本框。 您会在组件工具栏中看到以下选项:

  • 数值框小组件:用于选择组件以自定义其在侧栏中的外观。

  • 字段小组件:用于选择用于样式的通用组件。 在此示例中,将选择所有文本输入组件(文本框/数字框/数字步进器/日期输入)来设置样式。

  • 字段级 :用于切换到常规组件以进行样式设置。 如果选择数字框并选择此图标,则字段组件处于选中状态。 如果选择字段组件并选择此图标,则面板将被选中。 如果不断点击此图标进行选择,则最终将选择用于样式设置的布局。

NOTE
组件工具栏中可用的选项因您选择的组件而异。

组件工具栏

Canvas中数字框上的组件工具栏

使用侧栏 using-rail

主题编辑器中的侧边栏提供了用于自定义主题中组件的样式以及使用选择器的选项。 选择器允许您选择一组组件或单个组件,并且您可以在侧栏中搜索选择器。 您可以为自定义组件编写选择器。

从侧栏中的画布或选择器中选择组件时,侧栏会显示可用于为其自定义样式的所有选项。
以下是您在选择组件时可在侧栏中看到的选项:

  • 状态
  • 属性表
  • 模拟错误/成功

状态 state

状态是用户与组件交互的指示器。 例如,当用户在文本框中输入错误数据时,文本框的状态将更改为错误状态。 主题编辑器允许您为特定状态指定样式。

用于自定义状态样式的选项因组件而异。

属性表 property-sheet

属性
使用
尺寸及位置

允许您在主题中样式对齐、大小、定位和组件放置。

选项包括显示设置、填充、边距、宽度、高度和Z索引。

您还可以使用布局模式,通过简单的拖放界面来定义组件的宽度。 有关更多信息,请参阅 使用布局模式调整组件大小.

文本

允许您自定义主题组件中的文本样式。

例如,您想更改在文本框中输入的文本的外观。

选项包括字体系列、粗细、颜色、大小、行高、文本对齐、字母间距、文本缩进、下划线、斜体、文本转换、垂直对齐、基线和方向。

背景
允许您使用图像或颜色填充组件背景。
边框

允许您选择组件的边框外观。 例如,希望文本框具有深红色、粗边框和虚线。

您的选项包括边框的宽度、样式、半径和颜色。

效果
允许向元件添加特殊效果,如不透明度、混合模式和阴影。
高级

允许您添加:

  • 属性 ::before::after 伪元素,用于在选择器的默认内容之后或之前添加内容并使其设置样式。
    请参阅 CSS Pseudo元素.
  • 将自定义CSS代码内联到组件并编写自定义选择器。

添加自定义CSS代码时,它会覆盖您使用侧边栏中的选项添加的自定义。

模拟错误/成功 simulate-error-success

侧栏底部提供了模拟错误和成功选项。 您可以使用侧栏底部的显示/隐藏箭头查看它们。 使用主题编辑器,您可以设置组件的各种状态的样式。

例如,在表单中添加数字字段,并在主题编辑器中指定其样式。 当用户在字段中键入字母数字值时,您希望更改文本框的背景颜色。 选择主题中的数值字段,然后使用侧栏中的状态选项。 在侧栏中选择“错误”状态,然后将背景颜色更改为红色。 要预览行为,您可以使用侧边栏中提供的“模拟错误”选项。 “模拟错误”和“成功”选项详述如下:

  • 模拟成功:您可以查看组件在为成功状态指定样式时的外观。 例如,在表单中,客户设置密码。 用户可以按照您提供的指南设置密码。 当用户按照您提供的所有指南键入密码时,文本框将变为绿色。 当文本框变为绿色时,它处于成功状态。 您可以为处于成功状态的元件指定样式,并使用“模拟成功”选项模拟其外观。

  • 模拟错误:您可以看到在为错误状态指定组件样式时组件的外观。 例如,在表单中,客户设置密码。 用户可以按照您提供的指南设置密码。 当用户键入的密码未遵循您提供的所有准则时,文本框将变为红色。 当文本框变为红色时,它处于错误状态。 可为处于错误状态的元件指定样式,并使用“模拟错误”选项模拟其外观。

设置组件的样式 styling-a-component

例如,您的表单中有两种类型的文本框:一种仅接受数字值,另一种接受字母数字值。 您可以自定义仅接受数字值的文本框(数字框)的样式。

执行以下步骤可自定义特定组件(本示例中的数字框)的样式:

  1. 在主题编辑器中,选择画布中的数字框。

  2. 选择数字框后,您可以看到包含三个选项的组件工具栏:

    • 数值框小组件
    • 字段小组件 字段级
  3. 选择 数值框小组件.

  4. 侧栏标题将更改为数值框小组件,并显示用于自定义其外观的选项。
    使用 Dimension和位置 侧栏中的选项,用于自定义组件的大小。 确保国家 默认.

不要选择 数值框小组件,选择 字段小组件 ,然后执行上述步骤。 在为选择维度时 字段小组件 选项,除数字框之外的所有文本框都具有相同的大小。

为给定状态设置字段样式 styling-fields-given-state

使用组件工具栏,还可以为其不同状态指定组件的样式。 例如,如果某个组件被禁用,则它处于禁用状态。 可在主题编辑器中样式的组件的常用状态为:默认、集中、已禁用、错误、成功和悬停。 您可以在画布中选择组件,然后使用侧边栏中的状态选项自定义其外观。

执行以下步骤以自定义处于特定状态的组件的样式:

  1. 在画布中选择组件,然后从组件工具栏中选择相应的选项。
    侧栏显示用于自定义组件样式的选项。
  2. 在侧栏中选择一个状态。 例如,“错误”状态。
  3. 使用选项,例如 边框,背景 以自定义组件的外观。
  4. 使用 模拟错误 选项来查看样式在编辑时的外观。

在指定组件的状态后自定义组件的样式时,将只针对指定状态显示组件的自定义设置。 例如,如果在选择了悬停状态时自定义组件的样式。 在将指针移动到渲染表单或应用主题的交互式通信中的组件上时,将显示组件的自定义设置。

要模拟错误和成功以外的状态行为,请使用预览模式。 要使用预览模式,请单击 预览 在页面工具栏中。

为较小的显示设置布局样式 styling-layouts-for-smaller-displays

使用画布中的标尺为显示较小的设备选择断点。 点击模拟器 标尺 在画布中查看标尺和断点。 利用断点,可预览属于不同设备(如手机和平板电脑)的显示大小的表单或交互式通信。 主题编辑器支持多种显示大小。

要为不同的断点设置组件的样式:

  1. 在画布中,选择标尺上方的断点。
    断点表示移动设备及其显示大小。
  2. 使用侧边栏在主题中为选定的显示大小自定义表单或交互式通信组件的样式。
  3. 确保已保存自定义。

您可以为多个设备设置表单或交互式通信组件的样式。 桌面和移动设备的表单和交互式通信组件可以具有完全不同的样式。

在主题中使用Web字体 using-web-fonts-in-a-theme

现在,您可以在自适应表单或交互式通信中使用Web服务中提供的字体。 开箱即用 Adobe FontsAdobe的Web字体服务作为配置提供。 要使用Adobe Fonts,请创建一个套件,在其中添加字体,然后从获取套件ID Adobe Fonts.

执行以下步骤以在AEM中配置Adobe Fonts:

  1. 在创作实例中,单击 adobeexperiencemanager Adobe Experience Manager >工具 锤子 >部署>Cloud Service。

  2. Cloud Service 页面,导航到并打开 Adobe Fonts 选项。 打开配置文件夹,然后单击 创建.

  3. 创建配置 对话框,为配置指定标题,然后单击 创建.

    您将被重定向到配置页面。

  4. 在出现的编辑组件对话框中,提供您的Kit ID并单击 确定.

执行以下步骤来配置主题以使用Adobe Fonts配置:

  1. 在创作实例上,在主题编辑器中打开主题。

  2. 在主题编辑器中,导航到 主题选项 theme-options > 配置.

  3. Adobe Fonts配置 字段,选择套件,然后单击 保存.

    现在,您可以看到字体已添加到主题的font-family属性中。

在主题编辑器中列出并选择字体 listing-and-selecting-fonts-in-theme-editor

您可以使用主题配置服务向主题编辑器添加更多字体。 执行以下步骤以添加字体:

  1. 使用管理权限登录到AEM Web Console。 AEM Web控制台的URL为 https://'[server]:[port]'/system/console/configMgr.

  2. 打开 自适应表单主题配置服务.

    theme-config

  3. 单击+,指定字体名称,然后单击 保存. 字体已添加并在主题编辑器中可用。

在主题编辑器中选择字体 selecting-fonts-in-theme-editor

可以使用+按钮添加字体。 添加字体时,该字体会列在侧栏中。

主题编辑器中列出的新字体

除了主题配置选项之外,您还可以从主题编辑器本身添加字体。 在侧栏下的字体系列字段中键入要使用的字体,然后按键盘上的返回键。

在主题编辑器中键入和选择字体

选取字体时,会将其添加到字体系列列表下。 您可以使用主题编辑器中的“蒙版”选项来禁用或启用列出的字体。

多字体

您可以看到组件字体更改。

“字体系列”字段支持多种字体。 键入字体时,浏览器会查找该字体并将其应用于所选的组件。 如果浏览器找不到字体,则会在系列中查找该字体旁边的字体。 您可以首先键入要查找的特定字体。 如果找不到要使用的字体,可以在族中键入类属字体并使用它。

在主题编辑器中应用的蒙版样式 mask-styles-applied-in-theme-editor

您可以遮罩应用于主题的样式。 在主题编辑器侧边栏中,您可以使用 toggle_eye 图标以禁用应用的样式。 例如,如果在表单或交互式通信中更改组件的尺寸,则可以使用属性左侧的掩码按钮禁用它。 在保存主题时,将保留所选的掩码选项。

主题编辑器侧边栏中可用的蒙版选项

下面的示例显示了主题中蒙版和未蒙版的样式。

蒙版和未蒙版的样式

将主题应用于表单或交互式通信 applying-a-theme-to-a-form-or-interactive-communication-br

要将主题应用于自适应表单,请执行以下操作:

  1. 在编辑模式下打开表单。 要在编辑模式下打开表单,请选择一个表单,然后单击 打开.

  2. 在编辑模式下,选择一个组件,然后单击 字段级 > 自适应表单容器,然后单击 cmppr .

    您可以在侧栏中编辑表单的属性。

  3. 在侧栏中,单击 样式.

  4. 从中选择主题 自适应表单主题 下拉列表,然后单击 完成 复选按钮 .

要将主题应用于交互式通信,请执行以下操作:

  1. 在编辑模式下打开交互式通信。 要在编辑模式下打开交互式通信,请选择一个表单,然后单击 打开.

  2. 在编辑模式下,选择一个组件,然后单击 字段级 >文档容器,然后单击 cmppr .

    您可以在侧栏中编辑表单的属性。

  3. 在侧栏中,在 基本,从中选择主题 主题 下拉列表,然后单击 完成 复选按钮

在运行时更改表单主题 change-theme-of-a-form-at-runtime

主题为表单的不同组件设置样式。 您可以使用 themeOverride 属性以动态更改表单主题。 表单的典型URL为:

https://<server>:<port>/content/forms/af/test.html

可以使用themeOverride参数在运行时应用主题。

https://<server>:<port>/content/forms/af/test.html?themeOverride=/content/dam/formsanddocuments-themes/simpleEnrollmentTheme

themeOverride 选项允许您提供主题的路径。 它会更改表单的主题,并使用更新的样式刷新表单。

使用主题获取特定外观 specific-af-appearance

对于AEM Forms以及默认的现成画布主题,还有许多其他主题。 如果要使用其他主题设计表单或交互式通信以及其他更改,请从Theme Library文件夹复制主题。 将复制的主题粘贴到主题库文件夹之外,并根据所需的更改编辑复制的主题。

要复制主题,请执行以下步骤:

  1. 在创作实例中,导航到 Adobe Experience Manager > Forms >主题.
  2. 打开主题库文件夹。
  3. 在“主题库”文件夹中,将指针悬停在相应的现成主题上,然后选择 复制.
  4. 将复制的主题粘贴到主题库文件夹之外。
  5. 自定义复制的主题。

自定义主题后,将其应用于表单或交互式通信。

NOTE
请勿修改主题库文件夹中可用的主题。 此文件夹包含系统主题。 安装AEM Forms的较新版本或修补程序时,将覆盖您对这些主题所做的任何更改。

对其他自适应表单用例的影响 impact-on-other-adaptive-form-use-cases

  • 发布/取消发布表单: 发布表单时,也会发布应用于的主题(如果尚未发布)
  • 导入/导出表单: 在导入或导出表单时,也会自动导入或导出与其关联的主题。
  • 表单的引用: 表单引用中的“引用”部分包含额外的主题条目。
  • 表单的上次修改时间: 在更改相关主题时更新。
  • A/B测试: 在A/B测试中,您可以将不同的主题应用于表单的两个版本。 两个主题的信息分别存储在两个引导容器上。

CSS生成序列 css-generation-sequence

当您选择查看CSS时,主题编辑器会收集所有样式信息并构建CSS。 它按以下顺序收集信息:

  1. 在主题的基本客户端库中定义的样式。
  2. 用户定义的样式,使用侧边栏中的属性指定。
  3. 使用“CSS覆盖”选项提供的CSS样式。

例如,文本框的背景颜色为基本客户端库中的蓝色。 可使用侧栏中的属性将其更改为粉红色。 在生成CSS时,您会看到文本框的背景颜色显示为粉红色。 使用属性更改背景颜色后,另一位作者使用CSS覆盖选项将背景颜色文本框更改为白色。 在生成CSS时,您会在生成的CSS中将背景颜色显示为白色。

调试样式 debugging-styles

在主题编辑器中为组件指定样式时,将生成CSS。 当为类属组件设置样式时,其中包含的多个组件也会设置样式。 例如,为字段设置样式时,其中的文本框和标签也会设置样式。 当在字段中设置文本框的样式时,它将获得自己的CSS。 如果要调试为字段和组件生成的CSS,主题编辑器会提供允许您查看CSS的选项。

您可以使用以下选项查看生成的CSS:

  • 查看CSS 侧栏中的选项:在主题中选择组件时,您可以在侧栏中看到查看CSS选项。 它显示生成的CSS,包括的CSS ::before::after 伪元素。
  • 查看主题CSS 选项在画布工具栏中:在画布工具栏中,单击 theme-options > 查看主题CSS. 您可以看到根据在主题编辑器中定义的属性生成的整个主题CSS。

疑难解答、建议和最佳实践 troubleshooting-recommendations-and-best-practices

  • 避免使用其他主题中的资源

    编辑主题时,您可以浏览和添加其他主题中的资产(如图像)。 例如,您正在编辑页面的背景。 例如,当您选择 页面 编辑按钮 > 背景 > 添加 > 图像,您将看到一个对话框,它允许您浏览并在其他主题中添加图像。

  • 如果从其他主题添加资产,并且移动或删除了其他主题,则您可能会遇到当前主题的问题。 建议您避免浏览和添加其他主题中的资产。

  • 使用基本clientlib、主题编辑器和内联样式

    • 基础clientlib

      基础客户端库包含样式信息。 在主题中的客户端库中使用样式信息。

      1. 导航到 Experience Manager> Forms >主题.
      2. 在“主题”页面中,选择一个主题,然后单击 查看属性.
      3. 在打开的“属性”页面中,单击 高级.
      4. 在“高级”选项卡的“客户端库位置”字段中,浏览并选择要使用的客户端库。
      5. 单击​ 保存

      在客户端库中指定的样式将在使用该样式的主题中导入。 例如,在客户端库中为文本框、数字框和开关指定样式。 在主题中导入客户端库时,将导入文本框、数字框和开关的样式。 然后,您可以使用主题编辑器来设置其他组件的样式。
      您还可以创建主题、创建主题的副本,然后修改复制的主题中提供的样式以用于类似用例。
      请参阅 使用主题获取特定外观

    • 主题编辑器:

      通过主题编辑器,可创建主题以设置表单或交互式通信的样式。 您可以在主题中指定组件的样式,以便在您开发的多个表单或交互式通信之间实现外观和感觉的一致性。 建议在主题中指定样式信息,然后将主题应用于表单。

    • 内联样式:

      处理表单时,您可以使用表单或交互式通信多渠道编辑器中的“样式”模式来设置组件的样式。 使用样式模式更改表单组件样式将覆盖主题中指定的样式。 如果要更改特定表单的某些组件的样式,请参阅 组件的内联样式.

  • 使用客户端库

    如果要创建客户端库以导入样式信息,请参阅 使用客户端库. 创建客户端库后,您可以使用上述步骤将其导入主题。

  • 更改容器面板布局宽度

    不建议更改容器面板布局宽度。 指定容器面板的宽度时,其将变为静态并且不会适应不同的显示。

  • 何时使用表单编辑器或主题编辑器来处理页眉和页脚

    如果要使用字体样式、背景和透明度等样式选项来设置页眉和页脚的样式,请使用主题编辑器。
    如果要提供徽标图像、标题中的公司名称以及页脚中的版权信息等信息,请使用表单编辑器选项。

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