Construtores de estilo para formulários adaptáveis

Última atualização em 2023-12-21

O Adobe recomenda o uso da captura de dados moderna e extensível Componentes principais para criação de um novo Forms adaptável ou adição de Forms adaptável às páginas do AEM Sites. Esses componentes representam um avanço significativo na criação do Forms adaptável, garantindo experiências de usuário impressionantes. Este artigo descreve a abordagem mais antiga para criar o Forms adaptável usando componentes de base.

Pré-requisitos

Conhecimento de CSS e da estrutura LESS.

O que pode ser personalizado

O artigo lista classes css de formulários adaptáveis disponíveis publicamente. Você pode usar essas classes para estilizar vários componentes de um formulário adaptável. O estilo dos componentes de criação, como caixas de diálogo e barras de status que exibem avisos, está fora do escopo deste artigo. Use essas construções de estilo para criar estilos (usando CSS ou Menos) somente quando não for possível estilizar componentes usando editor de tema.

Personalização de estilos em formulários adaptáveis

A estrutura LESS simplifica o caso de uso para personalizar estilos em formulários adaptáveis. A estrutura permite definir estilos usando um conjunto de variáveis e funções (mixins). A estrutura LESS ajuda a reduzir o tamanho do código incorporado e aumenta sua reutilização.

É possível personalizar estilos de formulário adaptável das seguintes maneiras:

  • Alterar o tema
  • Alterar estilo do componente

Alteração de tema

É possível alterar o tema de um formulário adaptável para garantir que sua aparência seja consistente com as páginas da Web nas quais o formulário adaptável está incorporado.

As alterações na aparência geral do formulário adaptável usando propriedades CSS normalmente fazem parte das alterações de tema. Alterações importantes no registro "ok e sentir" do formulário adaptável, como alterações no layout e na colocação dos componentes, não são consideradas alterações de tema.

Com base na inicialização, o seguinte conjunto de propriedades CSS define o tema de uma página da Web:

  • Cor do plano de fundo
  • Borda (tipo, cor, espessura)
  • Cor da fonte
  • Preenchimento
  • Margem
  • Tamanho da fonte
  • AlturaDaLinha

Atualmente, as variáveis LESS são definidas apenas para essas propriedades dos vários elementos em um formulário adaptável.

Alteração do estilo do componente

É possível alterar a aparência, o layout, o posicionamento e a visibilidade dos elementos. Para realizar essa tarefa, crie ou atualize seus arquivos .css personalizados para incluir as construções de estilo listadas neste artigo.

Para aplicar um estilo a um formulário adaptável, abra o formulário adaptável no para edição, abra as propriedades do contêiner de formulário adaptável e especifique o caminho do Arquivo CSS personalizado na guia básico. Construtores de estilo padrão do formulário adaptável e substituídos pelas construções listadas no arquivo .css personalizado.

Componentes

Os componentes discutidos neste artigo têm suas classes CSS predefinidas. Você pode editar as variáveis para modificar os estilos nas classes CSS. Como alternativa, você pode reescrever a classe inteira. Esta seção descreve as classes em componentes e estilos que você pode modificar usando variáveis.

Estilo do contêiner

Um contêiner é o componente de nível superior. Outros painéis e campos estão abaixo do componente de contêiner.

Classe CSS

guideContainerNode

Variáveis Descrição

Variáveis Descrição

container-bgColor

Cor do plano de fundo do contêiner

container-padding

Preenchimento do contêiner

container-margin

Margem para o contêiner

container-fontColor

Cor da fonte do contêiner

Estilo do campo

Os formulários adaptáveis incluem vários tipos de campos. Cada campo tem um nome de classe exclusivo, que é o nome do campo. O campo também tem um nome de classe comum guideFieldNode.

Os campos incluem rótulos, widgets, descrição da Ajuda (descrição longa e curta) e ícones da Ajuda do campo (ponto de interrogação).

Classe CSS

guideFieldNode

Variáveis

Descrição

field-padding

Preenchimento do campo

field-error-font-color

Cor da fonte da mensagem de erro do campo

field-error-font-size

Tamanho da fonte da mensagem de erro do campo

Estilo do rótulo

O elemento HTML rótulo usado para o campo inclui as classes left ou top dependendo se o rótulo está na parte superior ou à esquerda.

Classe CSS

guideFieldLabel

Variáveis

Descrição

label-font-color

Cor da fonte do rótulo do campo

label-font-size

Tamanho da fonte do rótulo do campo

label-line-height

Propriedade de altura de linha CSS para o rótulo do campo

label-font-weight

Propriedade de peso da fonte CSS para o rótulo do campo

label-margin

Margem para o rótulo do campo

As regras CSS para o rótulo são aplicadas usando o guideFieldLabel rótulo. Se você for um autor, substitua essa regra para tornar visíveis as alterações personalizadas.

Estilo dos widgets

Dependendo do tipo, os widgets também incluem classes. Geralmente, os widgets incluem o guideFieldWidget classe. Os widgets enviados com o HTML normalmente usam a entrada de elemento de HTML padrão e selecionam. O estilo é feito de acordo. Não é possível estilizar um widget personalizado alterando as variáveis.

Classe CSS

guideFieldWidget

Variáveis

Descrição

widgets-bg-color

Cor de fundo dos widgets (não funciona para a caixa de seleção e o botão de opção)

widgets-border-color

Cor da borda dos widgets

widgets-border-thickness

Tamanho da borda dos widgets

widgets-border-radius

Raio da borda dos widgets

widgets-border-type

Tipo de borda dos widgets

widget-border-focus-type

Tipo de foco das bordas do widget

widgets-border

Estilo de borda consolidado dos widgets

widgets-font-color

Cor do texto dentro do widget

widgets-font-size

Tamanho do texto dentro do widget

widgets-line-height

Propriedade lineheight CSS do widget

widgets-padding

Propriedade de preenchimento CSS para o widget

widgets-focus-border-color

Cor da borda quando o widget está em foco

widgets-mandatory-border-color

Cor da borda do widget para os campos obrigatórios

widgets-mandatory-bg-color

Cor de fundo do widget para os campos obrigatórios

widgets-disabled-bg-color

Cor de fundo do widget quando o campo está desabilitado

widgets-disabled-font-color

Cor da fonte do widget quando o campo está desabilitado

widgets-disabled-border-color

Cor da borda do widget quando o campo está desabilitado

widget-height

Altura do widget (Não funciona para a caixa de seleção e o botão de opção)

checkbutton-height

Altura da caixa de seleção e do botão de opção.

listboxwidget-height

Altura máxima para uma lista suspensa de várias seleções

Limitações no estilo de widget

O estilo de campos focalizados, obrigatórios e desativados é restrito usando variáveis. No entanto, é possível alterá-la substituindo os estilos. A restrição usando variáveis é fornecida principalmente para manter o número de variáveis sob controle. A restrição pode ser relaxada se a aparência de um campo mudar drasticamente porque está em qualquer um dos estados discutidos anteriormente.

Descrição da ajuda

Um autor pode especificar o conteúdo da Ajuda nos campos usando componentes de descrição Curta e Longa. Ambos os componentes têm uma classe comum .guideHelpDescription e outra classe .long/ .short, dependendo do tipo de descrição. O conteúdo da Ajuda está delimitado em um elemento de parágrafo para substituir o estilo da descrição. A descrição da Ajuda (longa e curta) é modificada usando variáveis que começam com widgetshelp, como mencionado na tabela a seguir:

Variáveis

Descrição

widgets-help-long-bg-color

Cor de fundo da Ajuda longa dos widgets

widgets-help-long-border-color

Cor da borda da Ajuda longa dos widgets

widgets-help-long-border-indicator-color

Cor da borda do indicador esquerdo da Ajuda longa dos widgets

widgets-help-short-bg-color

Cor de fundo da Ajuda curta dos widgets

widgets-help-short-color

Cor da fonte da pequena Ajuda dos widgets

widgets-help-short-tooltip-bg-color

Cor de fundo da dica de ferramenta curta dos widgets Ajuda

widgets-help-short-tooltip-color

Cor da fonte da dica de ferramenta curta dos widgets Ajuda

Termos e condições

Os Termos e Condições (TnC ) permite especificar termos e condições. Você pode personalizar o widget usando as variáveis descritas na tabela a seguir.

Variáveis

Descrição

tnc-unvisited Cor da fonte do link tnc não visitado.
tnc-visited Cor da fonte do link tnc visitado.

Botão

Os botões também são widgets. No entanto, seu estilo é um pouco diferente dos widgets. Nos formulários adaptáveis, qualquer uma das seguintes opções constitui um botão:

  • entrada[tipo = texto]
  • botão
  • elemento com class .button

Código HTML do botão:

<button type="button" >

<span class="iconButtonicon"></

span>

<span class="iconButtonlabel"></

span>

</button>

Classe CSS

Descrição

iconButton-icon

Fornece ícones para o botão

iconButton-label

Etiqueta/legenda do botão Estilos

Variáveis

Descrição

button-border-size

Tamanho da borda dos botões

button-border-type

Tipo de borda

button-padding

Propriedade de preenchimento CSS para o botão

button-font-size

Tamanho da fonte do botão

button-background-color

Cor de fundo do botão

button-font-color

Cor da fonte do botão

button-border-color

Cor da borda do botão

button-large-padding

Preenchimento para os botões grandes (botões com classe .buttonlarge)

button-large-font-size

Tamanho da fonte para botões grandes

button-small-padding

Preenchimento para os botões pequenos (botões com classe .buttonsmall)

button-small-font-size

Tamanho da fonte para botões pequenos

button-info-background-color

Cor de fundo dos botões informativos (botões com classe .buttoninformative)

button-info-font-color

Cor da fonte para os botões informativos

button-info-border-color

Cor da borda para botões informativos

button-warning-background-color

Cor de fundo dos botões com estilo de aviso (botões com classe .buttonwarning)

button-warning-font-color

Cor da fonte para botões com estilo de aviso

button-warning-border-color

Cor da borda para botões estilizados de aviso

button-alert-background-color

Cor de fundo dos botões de alerta (botões com classe .buttonalert)

button-alert-font-color

Cor da fonte dos botões de alerta

button-alert-border-color

Cor da borda dos botões de alerta

Ponto de interrogação

Para os widgets, um questionMark é exibido quando um autor adiciona uma descrição longa no conteúdo da Ajuda. O ícone padrão fornecido na inicialização é usado. Para usar um ícone personalizado, é possível personalizar os ícones de inicialização.

Classe CSS

guideHelpQuestionMark

Variáveis

Descrição

questionmark-font-color

Cor do ícone

questionmark-hover-font-color

Cor do ícone quando o mouse é posicionado sobre ele

Tabela

Você pode alterar o tema de cores das linhas de cabeçalho e corpo em uma tabela usando as variáveis a seguir.

Variáveis

Descrição

table-header-bg-color

Cor de fundo da linha de cabeçalho. O valor padrão é #333.

table-odd-row-bg-color

Cor do plano de fundo para a linha de corpo ímpar. O valor padrão é rgb(255, 255, 255).

table-even-row-bg-color

Cor do plano de fundo para a linha de corpo par. O valor padrão é #eee.

Anexo de arquivo

O widget Anexo de arquivo de formulários adaptáveis permite fazer upload de arquivos. Você também pode personalizar o widget usando as variáveis.

Variáveis

Descrição

fileItemPadding

Preenchimento dos arquivos exibidos no widget

fileItemBackground

Cor de fundo do item de arquivo

fileItemBorderColor

Cor da borda superior

fileItemColor

Cor da fonte do item de arquivo

filePreviewIconColor

Cor do ícone de Visualização (ícone Bootstrap) no widget

fileItemCommentHeight

Altura do comentário para o item de arquivo

Há quatro tipos de guias do navegador. Isso inclui guias à esquerda, na parte superior, no assistente e na opção. Cada navegador tem uma classe diferente.

Navegador

Classe CSS

Accordion

.navegadores de acordeão

tabs on the left

.tab-navigators-vertical

tabs on the top

.tab-navigators

Wizard

.assistente-navegadores

O código de HTML a seguir para o elemento tab navigator é (semelhante às guias de inicialização):

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

Você pode alterar o estilo do navegador usando regras CSS que selecionam os elementos usando descendente seletores. Por exemplo, para adicionar um estilo de decoração de texto à tag de âncora:

Navegador de guias na parte superior:

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

}

Além disso, há classes para estilizar os navegadores de guia (à esquerda e na parte superior) com base no fato de eles terem navegadores aninhados/secundários/secundários.

Classe CSS

Descrição

nested_true

Navegadores de guias (à esquerda e acima) que têm navegadores aninhados/secundários/secundários

nested_false

Navegadores de guias (à esquerda e acima) que não têm navegadores aninhados/secundários/secundários

A classe guideNavIcon fornece um ícone padrão para os navegadores de guia (à esquerda e acima) e os navegadores do assistente.

Classe CSS

guideNavIcon

OBSERVAÇÃO

Você pode alterar o ícone de um navegador específico fornecendo uma classe CSS no painel em criação, exemplo de formulário <class_name>. Você adiciona um <class_name>_nav para o ícone do navegador.

Variáveis

Descrição

Navegadores de guia

navigator-bg-color

Cor de fundo para todo o navegador de guias

tabs-bg-color

Cor do plano de fundo da guia

tabs-font-color

Cor da fonte da guia

tabs-hover-bg-color

Cor do plano de fundo da guia ao passar o mouse

tabs-hover-font-color

Cor da fonte da guia ao passar o mouse

tabs-active-bg-color

Cor do plano de fundo quando o painel está em foco (ativo)

tabs-active-font-color

Cor da fonte quando o painel está em foco

tabs-completed-bg-color

Cor do plano de fundo quando a expressão de preenchimento do painel retorna "true"

tabs-completed-font-color

Cor da fonte quando a expressão de Término do painel retorna "true"

tabs-stepped-bg-color

Cor do plano de fundo quando o painel está em foco uma vez, mas a expressão de conclusão retorna falso

tabs-stepped-font-color

Cor da fonte quando o painel está em foco uma vez, mas a expressão de conclusão retorna falso

tabs-border-color

Cor da borda da guia

tabs-font-size

Tamanho da fonte da guia

tabs-padding

Preenchimento da guia

tabs-margin

Margem para a guia

tabs-vertical-margin

Margem para as guias verticais

tabs-border-thickness

Tamanho da borda das guias

tabs-min-height

Altura mínima das guias

heirarichal-indent

Recuo para as abas aninhadas

Navegadores do assistente

wizard-navigator-bg-color

Cor de fundo para todo o navegador do assistente

wizard-tabs-bg-color

Cor do plano de fundo do assistente

wizard-tabs-font-color

Cor da fonte do assistente

wizard-tabs-active-bg-color

Cor do plano de fundo quando o painel está em foco (ativo)

wizard-tabs-active-font-color

Cor da fonte quando o painel está em foco (focalizado)

wizard-tabs-completed-bg-color

Cor do plano de fundo quando a expressão de preenchimento do painel retorna "true"

wizard-tabs-completed-font-color

Cor da fonte quando a expressão de Término do painel retorna "true"

wizard-tabs-stepped-bg-color

Cor do plano de fundo quando o painel está em foco uma vez, mas a expressão de conclusão retorna falso

wizard-tabs-stepped-font-color

Cor da fonte quando o painel foi focalizado uma vez, mas a expressão de Término retorna falso

wizard-tabs-border-color

Cor do assistente

wizard-tabs-font-size

Tamanho da fonte do assistente

wizard-tabs-padding

Preenchimento do assistente

wizard-tabs-border-thickness

Tamanho da borda do assistente

wizard-nav-bullet-border

Cor da borda do marcador do navegador do assistente (com prefixo da legenda/rótulo)

wizard-progress-bg-color

Cor de fundo da barra de progresso do navegador do assistente

wizard-progress-color

Cor de preenchimento da barra de progresso

Navegadores Acordeão

accordion-tabs-padding

Preenchimento para acordeão

Estilo do painel

Um Painel inclui uma barra de ferramentas opcional e seu conteúdo.

Classe CSS

guidePanelNode

Variáveis

Descrição

panel-background-color

Cor do plano de fundo do painel

panel-font-size

Tamanho da fonte para o texto do painel

panel-font-color

Cor da fonte do texto do painel

panel-padding

Preenchimento dentro do painel

panel-description-font-size

Tamanho da fonte da descrição do painel

panel-description-padding

Preenchimento da descrição do painel

panel-help-bg-color

Cor do plano de fundo para a ajuda do painel

panel-help-border-indicator-color

Cor da borda do indicador para ajuda do painel

O nó do painel é dividido em navegadores e conteúdo. Há não é um componente de estilo separado para o conteúdo. As variáveis descritas são aplicadas no navegador e no conteúdo.

O painel mais acima (RootPanel) não tem essa classe.

Estilo móvel

Barra de cabeçalho

Essas variáveis influenciam a barra de cabeçalho visível em um dispositivo móvel ou em dispositivos de tela pequena que contêm o título do painel e os navegadores próximo e posterior.

Classe CSS

guide-header-bar

Variáveis

Descrição

headerbar-background-color

Cor de fundo da barra de cabeçalho

headerbar-font-color

Cor da fonte do texto dentro da barra de cabeçalho

headerbar-padding

Preenchimento da barra de cabeçalho

Indicador de rolagem

Essas variáveis influenciam o indicador de rolagem, que é uma seta laranja exibida em um dispositivo móvel ou em dispositivos de tela pequena. Um indicador de Rolagem indica que há conteúdo além da parte visível da tela. Você pode rolar para baixo para vê-lo. Ao atingir o fim do conteúdo, a seta desaparece.

Classe CSS

mobileScrollIndicator

Variáveis

Descrição

scrollIndicatorBottom

Posição fixa do scrollindicator a partir da parte inferior

scrollIndicatorRight

Posição fixa do scrollindicator a partir da direita

scrollIndicatorWidth

Largura de scrollindicator

scrollIndicatorHeight

Altura do scrollindicator

Variáveis específicas do layout da barra de ferramentas fixa para dispositivos móveis

Essas variáveis na tabela a seguir influenciam o layout da barra de ferramentas fixa móvel.

Classe CSS

mobileToolbar

Variáveis

Descrição

mobileToolbarBottom

Posição fixa da barra de ferramentas, no dispositivo móvel, na parte inferior

mobileToolbarTop

Posição fixa da barra de ferramentas, no dispositivo móvel, de cima

mobileToolbarLeft

Posição fixa da barra de ferramentas, no dispositivo móvel, da esquerda

mobileToolbarRight

Posição fixa da barra de ferramentas, no dispositivo móvel, da direita

mobileButtonIconTopMargin

Posição fixa do ícone dos botões da barra de ferramentas, a partir da parte superior

mobileButtonIconWidth

Largura do ícone dos botões da barra de ferramentas no dispositivo móvel

mobileButtonIconHeight

Altura do ícone dos botões da barra de ferramentas no dispositivo móvel

mobilefixedtoolbarbgcolor

Cor de fundo da barra de ferramentas em um dispositivo móvel

Variável específica do tema

A variável Inscrição simples theme em /etc/clientlibs/fd/af/guidetheme/simpleEnrollment e a categoria guide.theme.simpleEnrollment também introduzem algumas variáveis. Se você quiser criar um tema que melhore a inscrição simples, poderá usar as seguintes "variáveis adicionais:

Variáveis

Descrição

button-focus-bg-color

Cor de fundo do botão em foco

button-hover-bg-color

Cor do plano de fundo do botão ao passar o mouse

button-radius

Raio do botão

navigation-button-bg-color

Cor de fundo dos botões de navegação (voltar/próximo)

navigation-button-bg-hover-color

Cor de fundo dos botões de navegação (voltar/próximo) ao passar o mouse

initial-nav-color

Cor de fundo para os navegadores do assistente e a barra de progresso correspondente, quando renderizada pela primeira vez.

active-nav-color

Cor de fundo do navegador do assistente atual / ativo e barra de progresso correspondente

visited-nav-color

Cor de fundo dos navegadores do assistente e barra de progresso correspondente, que foram visitados.

tabs-bifercating-border-color

Container de bifurcação de cor de borda em navegadores e painel

tabs-navigator-separator-color

A cor da borda inferior separa as guias à esquerda (navegadores de guias).

tabs-child-nav-bg-color

Cor do plano de fundo dos navegadores aninhados/secundários/secundários do navegador

Nesta página