Criação e uso de temas creating-and-using-themes

O Adobe recomenda o uso da captura de dados moderna e extensível Componentes principaispara criação de um novo Forms adaptávelou 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.

É possível criar e aplicar temas para estilizar um Formulário adaptável. Um tema contém detalhes de estilo para os componentes e painéis. Os estilos incluem propriedades como cores de fundo, cores de estado, transparência, alinhamento e tamanho. Ao aplicar um tema, o estilo especificado é refletido nos componentes correspondentes. O tema é gerenciado de forma independente sem uma referência a um Formulário adaptável.

Você pode baixar e instalar o AEM Forms pacote de conteúdo de referência de Distribuição de software portal para importar temas de referência e modelos para o seu ambiente.

Criar, baixar ou fazer upload de um tema creating-downloading-or-uploading-a-theme

Um tema é criado e salvo como uma entidade separada, completa com metapropriedades como o Adaptive Forms. Ela permite reutilizar um tema em vários Forms adaptáveis. Você também pode mover um tema para uma instância diferente e reutilizá-lo.

Criação de um tema creating-a-theme

Para criar um tema:

Diferença de temas no Experience Manager 6.5 Forms e versões anteriores difference-in-themes

Temas criados em uma instância Cloud Service:

Download de um tema downloading-a-theme

Você pode exportar temas como um arquivo zip e usá-los em outros projetos ou instâncias Experience Manager. Para baixar um tema:

Carregamento de um tema uploading-a-theme

Um usuário com privilégios de administrador pode fazer upload de um tema criado no Experience Manager Forms 6.5 ou versões anteriores.

Para fazer upload de um tema:

Metadados de um tema metadata-of-a-theme

Lista de metapropriedades de um tema (encontrada na página de propriedades de um tema).

Sobre o Editor de temas about-the-theme-editor

O Editor de temas é uma interface amigável para usuários empresariais e designers da Web/desenvolvedores que fornece as funcionalidades necessárias para especificar o estilo de vários formulários adaptáveis elementos facilmente. Quando você cria um tema, ele é armazenado como uma entidade separada, como formulários .

O Editor de temas permite personalizar estilos dos componentes estilizados em um tema. É possível personalizar como um formulário procura em um dispositivo.

O Editor de temas é dividido em dois painéis:

A. Barra lateral B. Tela

Componentes de estilo styling-components

É possível usar um tema em vários Forms adaptáveis, que importa a formatação do componente especificada no tema. É possível estilizar vários componentes, como títulos, descrição, painéis, campos, ícones e caixas de texto. Use widgets para configurar propriedades de componentes em um tema. O conhecimento prévio de CSS ou MENOS não é necessário, mas é desejado, embora a seção Substituições de CSS permita escrever o código CSS ou fornecer seletores personalizados. A seção Sobreposições CSS é exibida quando você seleciona um componente na barra lateral.

Opções na barra lateral que permitem selecionar e estilizar diferentes componentes.

Clicar no botão editar em um componente na barra lateral seleciona o componente na Tela e permite estilizar o componente usando as opções na barra lateral.

Determinados componentes, como caixa de texto, caixa numérica, botão de opção e caixa de seleção, são categorizados em componentes genéricos, como Campo. Por exemplo, você deseja personalizar o estilo de botões de opção. Para selecionar botões de opção para estilo, selecione Campo > Widget > Botão de opção.

Layouts do painel de estilo styling-panel-layouts-br

Temas em AEM Forms suporte ao estilo de elementos no layout de painéis em seus formulários. O estilo de elementos em layouts prontos para uso e layouts personalizados é compatível.

Os painéis prontos para uso incluem:

Os seletores variam para cada layout.
O estilo de layouts personalizados do Editor de temas envolve:

Estilos diferentes para tamanhos de tela diferentes different-styles-for-different-screen-sizes-br

Os layouts de desktop e dispositivos móveis podem ter estilos ligeiramente ou totalmente diferentes. Para dispositivos móveis, o tablet e o telefone compartilham layouts semelhantes, exceto para tamanhos de componentes.

Use os pontos de interrupção do Editor de temas para definir um estilo alternativo para tamanhos de tela diferentes. É possível selecionar um dispositivo base ou uma resolução na qual você começa a criar o tema, e as variações de estilo de outras resoluções são geradas automaticamente. É possível modificar explicitamente o estilo de todas as resoluções.

O contexto das propriedades de estilo é alterado na barra lateral ao selecionar objetos styling-properties-context-changes-in-sidebar-on-selecting-objects

Quando você seleciona um componente na Tela de desenho, suas propriedades de estilo são listadas na barra lateral. Selecione o tipo de objeto e seu estado e forneça seu estilo.

Estilos usados recentemente no Editor de temas recently-used-styles-in-theme-editor

O editor de temas armazena em cache até dez estilos aplicados a um componente. É possível usar os estilos em cache com outro componente de um tema. Os estilos usados recentemente estão disponíveis logo abaixo do componente selecionado na barra lateral como uma caixa de listagem. Inicialmente, a lista de estilos usados recentemente está vazia.

À medida que você estiliza um componente, os estilos são armazenados em cache e listados na caixa de lista. Neste exemplo, o rótulo da caixa de texto é estilizado para alterar o tamanho e a cor da fonte. Você pode seguir etapas semelhantes para escolher uma imagem ou alterar as cores para estilizar um componente. Observe como o estilo é armazenado em cache e listado na caixa de listagem quando o estilo do rótulo do campo é alterado.

Neste exemplo, o estilo do rótulo do campo é alterado e, quando a Descrição do painel responsivo é selecionada para estilo, uma entrada de lista é adicionada à biblioteca de ativos. A entrada na biblioteca de ativos pode ser usada para alterar o estilo de Descrição do painel responsivo.

Quando adicionado na biblioteca de ativos, o estilo fica disponível para outros temas e no modo de estilo da interface do editor de formulários. Da mesma forma, ao usar o modo de estilo do editor de formulários Interface para estilizar um componente, o estilo é armazenado em cache e está disponível em temas.

O botão de mais na biblioteca de ativos permite salvar permanentemente o estilo com um nome que você fornece. O botão de adição salva o estilo mesmo se você não clicar no botão Salvar na barra lateral para aplicar o estilo a um componente. O botão de adição para salvar um estilo para uso posterior não está disponível no modo de estilo.

Quando você fornece um nome personalizado para um estilo, ele está vinculado a um tema e não está mais disponível para outros temas. Para excluir um estilo salvo:

Visualização em tempo real, salvar e descartar alterações live-preview-save-and-discard-changes

As modificações feitas no estilo são refletidas instantaneamente no formulário carregada na Tela. A pré-visualização ao vivo permite que você defina e veja interativamente o impacto do estilo. Quando você altera o estilo de um componente, a variável Concluído é ativado na barra lateral. Para reter as alterações, use o Concluído botão.

Tema com outro formulário adaptável theme-with-another-adaptive-form

Quando você cria um tema, ele é criado com um formulário enviado com o Editor de temas. Você fornece o estilo dos componentes neste formulário. Em vez do formulário enviado com o Editor de temas, você pode selecionar um formulário de sua escolha para fornecer estilo e visualizar os resultados.

Para substituir o formulário atual ou na Tela do Editor de temas:

Refazer/Desfazer redo-undo

Você pode desfazer ou refazer as alterações indesejadas que ocorrem acidentalmente. Use os botões Refazer/Desfazer na Tela.

Os botões Refazer/Desfazer aparecem ao estilizar um componente no Editor de temas.

Usar o Editor de temas using-the-theme-editor

O Editor de temas permite editar um tema criado ou carregado. Navegue até Forms e documentos > Temas, selecione um tema e abra-o. O tema é aberto no Editor de temas.

Como discutido acima, o Editor de temas tem dois painéis: Barra lateral e Tela.

Personalizar o estilo de estado de sucesso do componente Widget de caixa de texto no Editor de temas. O componente é selecionado na Tela de desenho e seu estado é selecionado na barra lateral. As opções de estilo disponíveis na barra lateral são usadas para personalizar a aparência de um componente.

Utilização da Tela using-canvas

O tema é criado usando o formulário pronto para uso ou usando um formulário de sua escolha. A Tela mostra a pré-visualização do formulário ou usado para criar o tema com personalizações especificadas no tema. A régua acima do formulário é usada para determinar o layout de acordo com o tamanho da exibição do seu dispositivo.

Na barra de ferramentas da Tela de Pintura, você verá:

Quando você seleciona um componente na Tela, vê a barra de ferramentas do componente na parte superior dele. A barra de ferramentas do componente permite selecionar componentes ou alternar para componentes genéricos. Por exemplo, você seleciona uma caixa de texto numérica em um painel. Você vê as seguintes opções na barra de ferramentas do componente:

Usando a barra lateral using-rail

A barra lateral no editor de temas fornece opções para personalizar estilos para componentes em um tema e usar seletores. Os seletores permitem selecionar um grupo de componentes ou componentes individuais, e você pode pesquisar por seletores na barra lateral. Você pode gravar seletores para componentes personalizados.

Quando você seleciona um componente na Tela ou nos seletores na barra lateral, a barra lateral mostra todas as opções que permitem personalizar estilos para ela.
Abaixo estão as opções que você vê na barra lateral ao selecionar um componente:

Estado state

Um estado é um indicador da interação do usuário com um componente. Por exemplo, quando um usuário insere dados incorretos em uma caixa de texto, o estado da caixa de texto muda para um estado de erro. O editor de temas permite especificar o estilo de um estado específico.

As opções para personalizar estilos de estado variam para diferentes componentes.

Folha de propriedades property-sheet

Simular Erro/Sucesso simulate-error-success

As opções Simular erro e sucesso estão disponíveis na parte inferior da barra lateral. Você pode vê-los usando uma seta para mostrar/ocultar visível na parte inferior da barra lateral. Usando o Editor de temas, você pode estilizar vários estados de um componente.

Por exemplo, você adiciona um campo numérico ao formulário e especifica seu estilo no editor de temas. Quando um usuário digita um valor alfanumérico no campo, você deseja alterar a cor do plano de fundo da caixa de texto. Você seleciona o campo numérico no tema e usa a opção de estado na barra lateral. Você seleciona o estado de erro na barra lateral e altera a cor do plano de fundo para vermelho. Para visualizar o comportamento, você pode usar a opção Simular erro disponível na barra lateral. As opções Simular Erro e Êxito estão descritas detalhadamente abaixo:

Estilo de um componente styling-a-component

Por exemplo, no formulário, você tem dois tipos de caixas de texto: uma que aceita apenas valores numéricos e outra que aceita valores alfanuméricos. É possível personalizar o estilo da caixa de texto que aceita apenas valores numéricos (uma caixa numérica).

Para personalizar o estilo de um componente específico (uma caixa numérica neste exemplo), execute as seguintes etapas:

Em vez de selecionar Widget de caixa numérica, selecione Widget de campo na barra de ferramentas do componente e execute as etapas acima. Ao selecionar dimensões para Widget de campo , todas as caixas de texto, exceto a caixa numérica, têm o mesmo tamanho.

Campos de estilo para um determinado estado styling-fields-given-state

Com a barra de ferramentas do componente, você também pode especificar o estilo dos componentes para seus diferentes estados. Por exemplo, se um componente estiver desativado, ele estará em um estado desativado. Os estados mais usados de um componente que podem ser estilizados no editor de tema são: Padrão, Foco, Desativado, Erro, Sucesso e Foco. Você pode selecionar um componente na Tela e usar a opção Estado na barra lateral para personalizar sua aparência.

Para personalizar o estilo de um componente em um estado específico, execute as seguintes etapas:

Quando você personaliza o estilo de um componente depois de especificar seu estado, a personalização é exibida somente para o componente no estado especificado. Por exemplo, se você personalizar o estilo do componente quando o estado do mouse for selecionado. A personalização é exibida para o componente quando você move o ponteiro sobre o componente no formulário renderizado ao qual você aplica o tema.

Para simular o comportamento de estados diferentes de erro e sucesso, use o modo de Visualização. Para usar o modo de Visualização, clique em Visualizar na barra de ferramentas da página

Layouts de estilo para exibições menores styling-layouts-for-smaller-displays

Use a régua na tela de desenho para selecionar pontos de interrupção para dispositivos com exibições menores. Clique no emulador no Canvas para exibir a régua e os pontos de interrupção. Os pontos de interrupção permitem visualizar um formulário para tamanhos de tela pertencentes a diferentes dispositivos, como telefones e tablets. Vários tamanhos de exibição são suportados no Editor de temas.

Para estilizar componentes para diferentes pontos de interrupção:

É possível estilizar o formulário componentes para vários dispositivos. Formulário os componentes para desktops e dispositivos móveis podem ter estilos totalmente diferentes.

Uso de Web Fonts em um tema using-web-fonts-in-a-theme

Agora é possível usar fontes disponíveis em um serviço da Web em um Formulário adaptável . Pronto para uso, Adobe Fonts, Adobe web font service, está disponível como uma configuração. Para usar o Adobe Fonts, crie um kit, adicione fontes a ele e obtenha a ID do kit de Adobe Fonts.

Para configurar o Adobe Fonts no Experience Manager, execute as seguintes etapas:

Para configurar um tema para usar a configuração do Adobe Fonts, execute as seguintes etapas:

Seleção de fontes no editor de temas selecting-fonts-in-theme-editor

Você pode usar o botão + para adicionar uma fonte. Quando você adiciona uma fonte, ela é listada na barra lateral.

Além da opção de configuração de tema, você também pode adicionar sua fonte a partir do próprio editor de tema. Digite a fonte que deseja usar no campo Família da fonte, na barra lateral, e pressione a tecla Return no teclado.

Quando você seleciona uma fonte, ela é adicionada na lista de famílias de fontes. Você pode usar a opção Máscara no editor de temas para desativar ou ativar as fontes listadas.

É possível ver a alteração da fonte do componente.

O campo Família de fontes é compatível com várias fontes. Quando você digita uma fonte, o navegador a procura e a aplica ao componente selecionado. Se o navegador não conseguir encontrar uma fonte, ele procurará uma fonte próxima a ela na família. Você pode começar digitando a fonte específica que está procurando. Se não encontrar a fonte que deseja usar, você pode digitar uma fonte genérica na família e usá-la.

Estilos de máscara aplicados no editor de temas mask-styles-applied-in-theme-editor

É possível mascarar estilos aplicados em um tema. Na barra lateral do editor de temas, você pode usar a variável ícone para desativar um estilo aplicado. Por exemplo, se você alterar as dimensões de um componente em um formulário , você poderá usar o botão de máscara à esquerda de uma propriedade para desativá-la. Quando você salva um tema, as opções de mascaramento selecionadas são mantidas.

O exemplo abaixo mostra estilos mascarados e não mascarados em um tema.

Aplicação de um tema a um formulário applying-a-theme-to-a-form-or-interactive-communication-br

Para aplicar um tema a um Formulário adaptável:

Você também pode definir um tema para um Formulário adaptável ao criá-lo.

Alterar tema de um formulário em tempo de execução change-theme-of-a-form-at-runtime

Um tema estiliza diferentes componentes de um formulário. Você pode usar o themeOverride para alterar dinamicamente o tema de um formulário. Uma URL típica de um formulário é:

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

Você pode usar o parâmetro themeOverride para aplicar um tema no tempo de execução.

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

A variável themeOverride permite fornecer um caminho para um tema. Ele altera o tema do formulário e atualiza o formulário com estilos atualizados.

Obter aparência específica usando temas specific-af-appearance

Com AEM Forms, juntamente com o tema padrão pronto para uso da tela, há muitos outros temas. Se quiser criar seu formulário usando outros temas, juntamente com mais alterações, copie o tema da pasta Biblioteca de temas. Cole os temas copiados fora da pasta Biblioteca de Temas e edite o tema copiado de acordo com as alterações desejadas.

Para copiar um tema, execute as seguintes etapas:

Depois de personalizar o tema, aplique-o ao formulário .

Impacto em outros casos de uso do Formulário adaptável impact-on-other-adaptive-form-use-cases

Sequência de geração de CSS css-generation-sequence

Quando você seleciona Exibir CSS, o Editor de temas coleta todas as informações de estilo e cria um CSS. Ele coleta informações na seguinte ordem:

Por exemplo, a cor de fundo de uma caixa de texto é azul. Você a altera para rosa usando as propriedades na barra lateral. Ao gerar o CSS, você vê a cor de fundo da caixa de texto como rosa. Depois de alterar a cor do plano de fundo usando as propriedades, outro autor usa a opção de substituição de CSS para alterar a caixa de texto de cor do plano de fundo como branco. Ao gerar o CSS, você vê a cor do plano de fundo como branca no CSS gerado.

Depuração de estilos debugging-styles

Quando você especifica estilos para componentes no Editor de temas, um CSS é gerado. Ao estilizar um componente genérico, vários componentes incluídos nele também são estilizados. Por exemplo, ao estilizar um campo, a caixa de texto e o rótulo nele também são estilizados. Quando você estiliza a caixa de texto dentro do campo, ele obtém seu próprio CSS. Se você quiser depurar o CSS gerado para o campo e o componente, o Editor de temas fornece opções que permitem exibir CSS.

Você pode ver o CSS gerado usando as seguintes opções:

Resolução de problemas, recomendações e práticas recomendadas troubleshooting-recommendations-and-best-practices

Consulte também see-also