自适应表单的样式结构 styling-constructs-for-adaptive-forms

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

先决条件 prerequisites

了解CSS和LESS框架。

可自定义的内容 what-can-be-customized

本文列出了自适应表单的公开可用css类。 您可以使用这些类设置自适应表单各种组件的样式。 创作组件(如显示警告的对话框和状态栏)的样式超出了本文的范围。 仅当您无法通过以下方式设置组件的样式时,才使用这些样式构造创建样式(使用CSS或更少): 主题编辑器.

在自适应表单中自定义样式 customizing-styles-in-adaptive-forms

LESS框架简化了自定义自适应表单中样式的用例。 该框架允许您使用一组变量和函数(mixin)定义样式。 LESS框架有助于减小捆绑代码的大小并提高其可重用性。

您可以通过以下方式自定义自适应表单样式:

  • 更改主题
  • 更改组件的样式

更改主题 changing-theme

您可以更改自适应表单的主题,以确保其外观与嵌入了自适应表单的网页一致。

使用CSS属性更改自适应表单的整体外观通常是主题更改的一部分。 对自适应表单的“确定和感觉”所做的重大更改(如组件布局和放置的更改)不被视为主题更改。

根据引导,以下几组CSS属性定义了网页的主题:

  • 背景颜色
  • 边框(类型、颜色、粗细)
  • 字体颜色
  • 边距
  • 边距
  • 字体大小
  • 行高

目前,仅针对自适应表单中各种元素的这些属性定义了LESS变量。

更改组件样式 changing-component-style

可更改元素的外观、布局、位置和可见性。 要完成此任务,请创建或更新您的自定义.css文件,以包含本文中列出的样式构造。

要将样式应用于自适应表单,请在中打开自适应表单进行编辑,打开自适应表单容器的属性,在基本选项卡中指定自定义CSS文件的路径。 自适应表单的样式构造是默认的,并且被自定义.css文件中列出的构造覆盖。

组件 components

本文中讨论的组件具有预定义的CSS类。 您可以编辑变量以修改CSS类中的样式。 或者,您可以重写整个类。 本节介绍可以使用变量修改的组件和样式中的类。

容器样式 container-styling

容器是顶级组件。 其他面板和字段位于容器组件下。

CSS 类
guideContainerNode
变量说明
变量说明
container-bgColor
容器的背景颜色
container-padding
容器的边距
container-margin
容器的边距
container-fontColor
容器的字体颜色

字段样式 field-styling

自适应表单包括各种类型的字段。 每个字段都有一个唯一的类名称,即字段的名称。 该字段还具有公共类名称 guideFieldNode.

字段包括标签、小组件、帮助描述(长描述和短描述)和字段帮助图标(问号)。

CSS 类
guideFieldNode
变量
描述
field-padding
字段的内边距
field-error-font-color
字段错误消息的字体颜色
field-error-font-size
字段错误消息的字体大小

标签样式 label-styling

HTML元素 标签 用于字段包括类 左侧top 标签在顶部还是左侧。

CSS 类
guideFieldLabel
变量
描述
label-font-color
字段标签的字体颜色
label-font-size
字段标签的字体大小
label-line-height
字段标签的CSS行高属性
label-font-weight
字段标签的CSS字体粗细属性
label-margin
字段标签的边距

使用以下方式应用标签的CSS规则 guideFieldLabel 标签。 如果您是作者,请覆盖此规则以使自定义更改可见。

构件样式 widgets-styling

根据其类型,构件还包含类。 通常,小组件包括 guideFieldWidget 类。 随HTML一起提供的小组件通常使用标准HTML元素输入和选择。 样式设置会相应地完成。 您不能通过更改变量来设置自定义小组件的样式。

CSS 类
guideFieldWidget
变量``
描述
widgets-bg-color
构件的背景颜色(复选框和单选按钮不起作用)
widgets-border-color
构件的边框颜色
widgets-border-thickness
构件的边框大小
widgets-border-radius
构件的边框半径
widgets-border-type
构件的边框类型
widget-border-focus-type
构件边框的焦点类型
widgets-border
小部件的合并边框样式
widgets-font-color
构件内文本的颜色
widgets-font-size
构件内文本的大小
widgets-line-height
构件的CSS lineheight属性
widgets-padding
构件的CSS填充属性
widgets-focus-border-color
小组件聚焦时的边框颜色
widgets-mandatory-border-color
必填字段的构件边框颜色
widgets-mandatory-bg-color
必填字段小组件的背景颜色
widgets-disabled-bg-color
禁用字段时构件的背景颜色
widgets-disabled-font-color
字段被禁用时的小部件的字体颜色
widgets-disabled-border-color
字段被禁用时构件的边框颜色
widget-height
小部件的高度(复选框和单选按钮无法正常使用)
checkbutton-height
复选框和单选按钮的高度。
listboxwidget-height
多选下拉菜单的最大高度

构件样式设置的限制 limitations-in-widget-styling

焦点、必填和禁用的字段的样式受变量限制。 但是,您可以通过覆盖样式来更改它。 提供了使用变量的限制,主要是为了控制变量的数量。 如果字段由于处于前面讨论的任何状态而发生显着变化,则可以放松该限制。

帮助描述 help-description

作者可以使用短描述组件和长描述组件在字段中指定帮助内容。 两个组件都有一个公共类 .guideHelpDescription 和另一堂课 .long/ .short,具体取决于描述的类型。 帮助内容包含在段落元素中,用于覆盖描述的样式。 使用以widgetshelp开头的变量修改帮助说明(长说明和短说明),如下表所述:

变量
描述
widgets-help-long-bg-color
小组件长时间帮助的背景颜色
widgets-help-long-border-color
构件长帮助的边框颜色
widgets-help-long-border-indicator-color
小组件长帮助的左指示器边框颜色
widgets-help-short-bg-color
小部件的简短帮助的背景颜色
widgets-help-short-color
小部件的简短帮助的字体颜色
widgets-help-short-tooltip-bg-color
构件简短工具提示的背景颜色帮助
widgets-help-short-tooltip-color
小部件的简短工具提示帮助的字体颜色

条款和条件 terms-and-conditions

条款和条件(TnC) ``)小组件允许您指定条款和条件。 您可以使用下表所述的变量自定义构件。

变量
描述
tnc-unvisited
未访问的tnc链接的字体颜色。
tnc-visited
已访问的tnc链接的字体颜色。

按钮 button

按钮也是小组件。 但是,它们的样式与小组件略有不同。 在自适应表单中,以下任意值构成按钮:

  • 输入[类型=文本]
  • 按钮
  • 带类的元素.button

按钮的HTML代码:

<button type="button" >

<span class="iconButtonicon"></

span>

<span class="iconButtonlabel"></

span>

</button>

CSS 类
描述
iconButton-icon
提供按钮的图标
iconButton-label
样式按钮标签/标题
变量``
描述
button-border-size
按钮的边框大小
button-border-type
边框类型
button-padding
按钮的CSS填充属性
button-font-size
按钮的字体大小
button-background-color
按钮的背景颜色
button-font-color
按钮的字体颜色
button-border-color
按钮的边框颜色
button-large-padding
大按钮(具有类.buttonlarge的按钮)的边距
button-large-font-size
大按钮的字体大小
button-small-padding
小按钮(具有类.buttonsmall的按钮)的边距
button-small-font-size
小按钮的字体大小
button-info-background-color
信息按钮(具有类.buttoninformative的按钮)的背景颜色
button-info-font-color
信息性按钮的字体颜色
button-info-border-color
信息性按钮的边框颜色
button-warning-background-color
带有警告样式的按钮(具有类.buttonwarning的按钮)的背景颜色
button-warning-font-color
警告样式按钮的字体颜色
button-warning-border-color
警告样式按钮的边框颜色
button-alert-background-color
警报按钮(具有类.buttonalert的按钮)的背景颜色
button-alert-font-color
警报按钮的字体颜色
button-alert-border-color
警报按钮的边框颜色

问号 question-mark

对于小组件,当作者在帮助内容中添加详细描述时,会显示问号。 使用bootstrap中提供的默认图标。 要使用自定义图标,可以自定义引导图标。

CSS 类
guideHelpQuestionMark
变量
描述
questionmark-font-color
图标的颜色
questionmark-hover-font-color
将鼠标悬停在图标上时图标的颜色

table

您可以使用以下变量更改表格中标题行和正文行的颜色主题。

变量
描述
table-header-bg-color
标题行的背景颜色。 默认值为 #333.
table-odd-row-bg-color
奇数正文行的背景颜色。 默认值为 rgb(255, 255, 255)
table-even-row-bg-color
偶数正文行的背景颜色。 默认值为 #eee

文件附件 file-attachment

自适应表单的文件附件小组件允许您上传文件。 您还可以使用变量自定义构件。

变量
描述
fileItemPadding
填充小部件中显示的文件
fileItemBackground
文件项的背景颜色
fileItemBorderColor
上边框的边框颜色
fileItemColor
文件项的字体颜色
filePreviewIconColor
构件中“预览”图标(Bootstrap图标)的颜色
fileItemCommentHeight
文件项的注释高度

导航器样式 navigator-styles

导航器选项卡有四种类型。 这些选项卡包括左侧选项卡、顶部选项卡、向导中的选项卡和折叠面板。 每个导航器具有不同的类。

导航器
CSS 类
Accordion
.accordion-navigator
tabs on the left
.tab — 导航器 — 垂直
tabs on the top
.tab-navigator
Wizard
.wizard-navigator

以下是Tab导航器元素的HTML代码(与bootstrap选项卡类似):

<li>

<a>tab title</a>

</li>

Accordion navigator is an exception, it has following barebone

structure:

<div class="accordion.navigators">

<div>

<div class = "guideHeader">

<a>

<span class = "guideSummary" ></code>

........................... repeatable buttons, if the repeatable configuration is set ................................

<div class = "repeatableButtons">

<button name="Add" class="Add"/>

<button name="Remove" class="Remove"/>

</div>

</a>

</div>

................................ panel content ..................................

</div>

</div>

可以使用选择元素的CSS规则更改导航器的样式,这些元素使用 子项 选择器。 例如,要向锚点标记添加文本修饰样式,请执行以下操作:

顶部选项卡导航器:

.tab-navigators

li a {

text-decoration:

underline;

}

Tab navigator on left:

.tab-navigators-vertical

li a {

text-decoration:

underline;

}

Accordion navigator:

.accordion-navigators .guideHeader a .guideSummary {

text-decoration:

underline;

}

Wizard navigator:

.wizard-navigators

li a {

text-decoration:

underline;

}

此外,还有一些类可根据选项卡导航器(包括左侧和顶部)是否具有嵌套/子项/子导航器来设置其样式。

CSS 类
描述
nested_true
具有嵌套/子/子导航器的选项卡导航器(左和上)
nested_false
没有嵌套/子项/子项导航器的选项卡导航器(左侧和顶部)

guideNavIcon类提供了一个默认图标,用于选项卡导航器(左侧和顶部)和向导导航器。

CSS 类
guideNavIcon
NOTE
在创作(表单示例)的面板上提供CSS类,可以更改特定导航器的图标 <class_name>. 您添加 <class_name>_nav 用于导航器的图标。
变量
描述
选项卡导航器
navigator-bg-color
整个选项卡导航器的背景颜色
tabs-bg-color
选项卡的背景颜色
tabs-font-color
选项卡的字体颜色
tabs-hover-bg-color
悬停时选项卡的背景颜色
tabs-hover-font-color
悬停时选项卡的字体颜色
tabs-active-bg-color
面板聚焦时的背景颜色(活动)
tabs-active-font-color
面板成为焦点时的字体颜色
tabs-completed-bg-color
面板的完成表达式返回true时的背景颜色
tabs-completed-font-color
面板的完成表达式返回true时的字体颜色
tabs-stepped-bg-color
面板聚焦一次但完成表达式返回false时的背景颜色
tabs-stepped-font-color
面板聚焦一次但完成表达式返回false时的字体颜色
tabs-border-color
选项卡的边框颜色
tabs-font-size
选项卡的字体大小
tabs-padding
选项卡的边距
tabs-margin
选项卡的边距
tabs-vertical-margin
垂直选项卡的边距
tabs-border-thickness
选项卡的边框大小
tabs-min-height
选项卡的最小高度
heirarichal-indent
嵌套选项卡的缩进
向导导航器
wizard-navigator-bg-color
整个向导导航器的背景颜色
wizard-tabs-bg-color
向导的背景颜色
wizard-tabs-font-color
向导的字体颜色
wizard-tabs-active-bg-color
面板聚焦时的背景颜色(活动)
wizard-tabs-active-font-color
面板成为焦点时的字体颜色(焦点)
wizard-tabs-completed-bg-color
面板的完成表达式返回true时的背景颜色
wizard-tabs-completed-font-color
面板的完成表达式返回true时的字体颜色
wizard-tabs-stepped-bg-color
面板聚焦一次但完成表达式返回false时的背景颜色
wizard-tabs-stepped-font-color
面板聚焦一次但完成表达式返回false时的字体颜色
wizard-tabs-border-color
向导的颜色
wizard-tabs-font-size
向导的字体大小
wizard-tabs-padding
向导的内边距
wizard-tabs-border-thickness
向导的边框大小
wizard-nav-bullet-border
向导导航器项目符号的边框颜色(在标题/标签前加前缀)
wizard-progress-bg-color
向导导航器进度条的背景颜色
wizard-progress-color
进度条的填充颜色
可折叠项导航器
accordion-tabs-padding
折叠的边距

面板样式 panel-styling

面板包括可选工具栏及其内容。

CSS 类
guidePanelNode
变量
描述
panel-background-color
面板的背景颜色
panel-font-size
面板文本的字体大小
panel-font-color
面板文本的字体颜色
panel-padding
面板内的内边距
panel-description-font-size
面板说明的字体大小
panel-description-padding
面板说明的边距
panel-help-bg-color
面板帮助的背景颜色
panel-help-border-indicator-color
面板帮助的指示器边框颜色

面板节点分为导航器和内容。 那里 ``对于内容,没有单独的样式组件。 所描述的变量适用于导航器和内容。

最上面的面板(RootPanel)没有此类。

移动设备样式 mobile-styling

标题栏 header-bar

这些变量会影响在包含面板标题以及下一个和背面导航器的移动设备或小屏幕设备上显示的标题栏。

CSS 类
guide-header-bar
变量
描述
headerbar-background-color
标题栏的背景颜色
headerbar-font-color
标题栏中文本的字体颜色
headerbar-padding
标题栏的内边距

滚动指示器 scroll-indicator

这些变量会影响滚动指示器,即出现在移动设备或小屏幕设备上的橙色箭头。 滚动指示器指示屏幕可见部分以外的内容存在。 您可以向下滚动查看它。 点击内容结尾时,箭头消失。

CSS 类
mobileScrollIndicator
变量
描述
scrollIndicatorBottom
滚动指示器从底部的固定位置
scrollIndicatorRight
滚动指示器的固定位置(从右侧)
scrollIndicatorWidth
滚动指示器的宽度
scrollIndicatorHeight
滚动指示器的高度

移动设备固定工具栏布局特定的变量 mobile-fixed-toolbar-layout-specific-variables

下表中的这些变量会影响移动设备固定工具栏的布局。

CSS 类
mobileToolbar
变量
描述
mobileToolbarBottom
固定位置的工具栏,在移动设备上,从底部开始
mobileToolbarTop
在移动设备上从顶部固定工具栏位置
mobileToolbarLeft
固定工具栏在移动设备左侧的位置
mobileToolbarRight
固定工具栏在移动设备上的位置(从右侧)
mobileButtonIconTopMargin
从顶部固定工具栏按钮图标的位置
mobileButtonIconWidth
移动设备上工具栏按钮图标的宽度
mobileButtonIconHeight
移动设备上工具栏按钮图标的高度
mobilefixedtoolbarbgcolor
移动设备上工具栏的背景颜色

主题特定变量 theme-specific-variable

简单注册 /etc/clientlibs/fd/af/guidetheme/simpleEnrollment上的主题和类别 guide.theme.simpleEnrollment 还引入了几个变量。 如果要创建主题以增强简单注册,您可以使用以下“额外变量:

变量
描述
button-focus-bg-color
焦点按钮的背景颜色
button-hover-bg-color
悬停时按钮的背景颜色
button-radius
按钮的半径
navigation-button-bg-color
导航按钮的背景颜色(后退/下一步)
navigation-button-bg-hover-color
悬停时导航按钮(后退/下一个)的背景颜色
initial-nav-color
向导导航器的背景颜色和相应的进度条(首次渲染时)。
active-nav-color
当前/活动向导导航器的背景颜色和相应的进度条
visited-nav-color
向导导航器的背景颜色和相应的进度条(已访问)。
tabs-bifercating-border-color
将容器边框颜色分叉为导航器和面板
tabs-navigator-separator-color
左侧的制表符(制表符导航器)的下边框颜色分隔制表符。
tabs-child-nav-bg-color
导航器的嵌套/子项/子导航器的背景颜色
recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2