Criação de estilos CSS para formulários HTML5 creating-css-styles-for-html-forms

CAUTION
AEM 6.4 chegou ao fim do suporte estendido e esta documentação não é mais atualizada. Para obter mais detalhes, consulte nossa períodos de assistência técnica. Encontre as versões compatíveis here.

A representação de HTML5 de um template de formulário baseado em XFA consiste em vários elementos de HTML. Esses elementos são organizados em ordem. Cada elemento tem classes CSS bem definidas. Você pode usar essa classe CSS para selecionar e alterar a aparência de um elemento.

NOTE
Nas classes CSS, não altere o valor da largura, altura, espessura da borda, parte superior, esquerda, direita, parte inferior, preenchimento, margem e outros atributos de posição e tamanho. Qualquer alteração na posição e nos atributos de tamanho traz alterações ao layout do formulário.

Classes CSS para elementos  css-classes-nbsp-for-elements-nbsp

Cada elemento contém classes CSS bem definidas. Você pode modificar essas classes para alterar a aparência de um elemento. Cada elemento, exceto os elementos field e draw , tem duas classes CSS - classe Type e classe Name .

  • O Classe de tipo representa o tipo do campo XFA. Você pode substituir o type classe para modificar os estilos de todos os elementos de um tipo específico.

  • O Classe de nome corresponde ao nome do campo XFA. Você pode substituir o name classe para modificar e aplicar estilo personalizado a um elemento.

NOTE
Alguns elementos XFA não têm um nome. Para alterar os estilos desses componentes, modifique todos os componentes desse tipo específico.

Para as páginas não nomeadas no AEM Forms Designer, as páginas em um formulário HTML5 são nomeadas na ordem crescente de seu número. Por exemplo, para um formulário HTML5 com duas páginas, as páginas são nomeadas Página1, Página2.

Elemento de campo field-element

O elemento field contém dois elementos aninhados: widget e legenda.

Elemento de widget

O elemento de widget contém o elemento da interface do usuário para interação com usuários. Ele tem três classes CSS:

  • Widget: Todo widget tem essa classe.
  • name: Todos os widgets enviados com AEM contêm a classe de nome de widget. Para widgets personalizados, o desenvolvedor do widget fornece a classe de nome do widget.
  • type: Cada widget tem um elemento da interface do usuário. Essa classe define o tipo do elemento da interface do usuário.
<!--field with caption-->
<div class="field numericfield NumericField3 ">
     <div class="caption">
        caption content
     </div>
     <div class="widget numericfieldwidget numericInput">
       widget content
     </div>
</div>

<!--field without caption-->
<div class="widget numericfieldwidget numericInput">
   widget content
</div>

Além do tipo e da classe de nome, o componente de campo também contém uma classe CSS adicional chamada subtipo. Um subtipo identifica qual tipo de campo é, por exemplo, NumericField, DateField, TextField. É possível substituir a classe do subtipo para modificar o estilo de todos os campos do tipo , do subtipo .

Classes CSS para diferentes componentes css-classes-for-different-components

Componente
Tipo
Nome
Página
página
Nome definido pelo usuário
ou
Página<pagenumber> (padrão)
Área de conteúdo
contentarea
Nome definido pelo usuário
Subformulário
subformulário
Nome definido pelo usuário
Grupo de exclusão
exclgroup
Nome definido pelo usuário
Draw
draw
Nome definido pelo usuário
Texto
campo
Nome definido pelo usuário
Capítulo
caption
ND
Widget
widget
O desenvolvedor do widget o define (para widgets definidos pelo usuário, consulte a tabela na seção a seguir)

Classes CSS para diferentes campos css-classes-for-different-fields

O AEM Forms Designer oferece suporte a diferentes tipos de campos em um formulário como NumericField, DecimalField e Date Field. Todos esses campos no HTML contêm as classes CSS mencionadas acima. Eles também contêm algumas classes extras, dependendo do tipo de campo.

Cada campo tem um widget associado que representa o elemento da interface do usuário. As classes de cada campo e os widgets associados a cada campo são listados abaixo.

Tipo de campo
Subtipo
Nome do widget
Tipo de widget
Tag da interface do usuário do HTML
Botão
ND
xfaButton
buttonfieldwidget
tipo de entrada=botão
CheckButton
checkboxfield
XfaCheckBox
checkboxfieldwidget
tipo de entrada=caixa de seleção
DateField
datefield
dateField
datefieldwidget
tipo de entrada=texto
DateTimeField
campo de texto
textField
textfieldwidget
tipo de entrada=texto
DecimalField
numericfield
numericInput
numericfieldwidget
tipo de entrada=texto
DropDown
choicelista
dropDownListWidget
choicelistwidget
select
ListBox
choicelista
listBoxWidget
choicelistwidget
ol
NumericField
numericfield
numericInput
numericfieldwidget
tipo de entrada=texto
PasswordField
passwordfield
defaultWidget
passwordfieldwidget
input type=password
RadioButton
radiocampo
XfaCheckBox
radiofieldwidget
tipo de entrada=rádio
TextField
campo de texto
textField
textfieldwidget
tipo de entrada=texto
TimeField
campo de texto
textField
textfieldwidget
tipo de entrada=texto

Classes CSS para diferentes Elementos de Desenho css-classes-for-different-draw-elements

É possível inserir elementos de desenho estático, como texto e imagens, usando o AEM Forms Designer. Para cada elemento draw , uma classe CSS separada é associada a esse elemento. A lista de classes CSS para elementos draw está listada abaixo. Cada elemento draw tem uma classe draw associada a ele.

Tipo de desenho
Classe CSS
Texto
text
Imagem
imagem
Retângulo
retângulo
Line
linha

Estilo de outras partes do formulário styling-other-parts-of-the-form

Além da aparência dos componentes da interface do usuário no formulário HTML, você pode alterar o estilo de elementos como Erros em linha, Avisos em linha e campos com erros de validação.

Styling Inline Errors

Quando a validação de um campo resulta em um erro, um erro em linha é exibido quando o campo está ativo. Para alterar o estilo dos erros em linha, substitua a ID do CSS error-msg.

Styling Inline Warnings

Quando a validação de um campo resulta em um aviso, um aviso em linha é exibido quando o campo está ativo. Para alterar o estilo desses avisos em linha, substitua a ID de CSS warning-msg.

Styling Fields with Validation Errors

Quando a validação de um campo falha, o estilo do widget muda. Essa alteração de estilo é feita pela aplicação de uma classe CSS widgetError no componente de widget. Para modificar o estilo padrão, substitua o widgetError classe .

recommendation-more-help
a6ebf046-2b8b-4543-bd46-42a0d77792da