为HTML5表单创建CSS样式
基于XFA的表单模板的HTML5呈现版本由多个HTML元素组成。 这些元素按顺序排列。 每个元素都有定义良好的CSS类。 您可以使用这些CSS类来选择和更改元素的外观。
注意
在CSS类中,请不要更改宽度、高度、边框粗细、顶部、左、右、底部、内边距、边距以及其他位置和大小属性的值。 位置和大小属性的任何更改都会导致表单布局发生更改。
CSS类 (元素)
每个元素都包含定义良好的CSS类。 您可以修改这些类以更改元素的外观。 除字段和绘制元素外,每个元素都有两个CSS类 — Type类和Name类。
Type类表示XFA字段的类型。 您可以覆盖type类以修改特定类型所有元素的样式。
Name类对应于XFA字段的名称。 您可以覆盖name类,以修改自定义样式并将其应用于元素。
注意
某些XFA元素没有名称。 要更改此类组件的样式,请修改该特定类型的所有组件。
对于在AEM Forms Designer中未命名的页面,HTML5表单中的页面会按其数量的增加顺序进行命名。 例如,对于包含两页的HTML5表单,页面名为Page1, Page2。
字段元素
字段元素包含两个嵌套元素:小组件和标题。
构件元素
小组件元素包含用于与用户交互的用户界面元素。 它有三个CSS类:
小组件:每个小组件都有这门课。
名称:AEM附带的所有小组件都包含小组件名称类。对于自定义小组件,小组件开发人员提供小组件名称类。
类型:每个小组件都有一个用户界面元素。此类定义用户界面元素的类型。
除了类型和名称类之外,字段组件还包含一个名为subtype的附加CSS类。 子类型标识其是哪种类型的字段,例如NumericField、DateField、TextField。 您可以覆盖子类型类,以修改所有子类型字段的样式。
不同组件的CSS类
组件
类型
名称
页面
页
用户定义的名称
或
页面(默认)
内容区域
contentrea
用户定义的名称
子表单
子表单
用户定义的名称
排除组
exclgroup
用户定义的名称
Draw
绘制
用户定义的名称
字段
字段
用户定义的名称
描述
caption
NA
小组件
小组件
小组件开发人员对其进行定义(有关用户定义的小组件,请参阅下节中的表格)
不同字段的CSS类
AEM Forms Designer支持表单中不同类型的字段,如数值字段、小数字段和日期字段。 HTML中的所有这些字段都包含上述CSS类。 它们还包含一些根据字段类型而定的额外类。
每个字段都有一个表示UI元素的关联小组件。 下面列出了每个字段的类以及与每个字段关联的小组件。
字段类型
子类型
小组件名称
构件类型
HTML UI标记
按钮
NA
xfaButton
buttonfieldwidget
input type=button
CheckButton
checkboxfield
XfaCheckBox
checkboxfieldwidget
输入类型=checkbox
DateField
datefield
dateField
datefieldwidget
输入类型=text
DateTimeField
textfield
textField
textfieldwidget
输入类型=text
DecimalField
numericfield
numericInput
numericfieldwidget
输入类型=text
DropDown
choicelist
dropDownListWidget
choicelistwidget
选择
ListBox
choicelist
listBoxWidget
choicelistwidget
ol
NumericField
numericfield
numericInput
numericfieldwidget
输入类型=text
PasswordField
passwordfield
defaultWidget
passwordfieldwidget
输入类型=password
单选按钮
radiofield
XfaCheckBox
radiofieldwidget
input type=radio
TextField
textfield
textField
textfieldwidget
输入类型=text
TimeField
textfield
textField
textfieldwidget
输入类型=text
不同绘制元素的CSS类
您可以使用AEM Forms Designer插入静态绘制元素,如文本和图像。 对于每个绘制元素,一个单独的CSS类与该元素相关联。 下面列出了绘制元素的CSS类列表。 每个绘制元素都有一个与其关联的绘制类。
绘制类型
CSS 类
文本
文本
图像
图像
矩形
矩形
Line
折线图
为表单的其他部分设置样式
除了HTML表单中UI组件的外观外,您还可以更改元素的样式,如内联错误、内联警告和存在验证错误的字段。
Styling Inline Errors
如果字段的验证导致错误,则当该字段处于活动状态时,会显示内联错误。 要更改内联错误的样式,请覆盖CSS ID error-msg。
Styling Inline Warnings
当字段验证导致警告时,当字段处于活动状态时,将显示内联警告。 要更改这些内联警告的样式,请覆盖CSS ID warning-msg。
Styling Fields with Validation Errors
当字段验证失败时,小组件的样式会发生更改。 此样式更改是通过在小组件组件上应用CSS类widgetError来完成的。 要修改默认样式,请覆盖widgetError类。