Componente de texto do formulário

O componente principal de texto do formulário do componente permite a entrada do texto do formulário para envio.

Uso

O componente de Texto do formulário permite o envio de diferentes tipos de texto e se destina a ser usado junto com o componente de container do formulário. O tipo de validação de texto, rótulos e mensagens de ajuda podem ser definidos pelo editor de conteúdo na caixa de diálogo configure.

Versão e compatibilidade

A versão atual do Componente de texto do formulário é a v2, que foi introduzida com a versão 2.0.0 dos Componentes principais em janeiro de 2018 e é descrita neste documento.

A tabela a seguir detalha todas as versões compatíveis do componente, as versões AEM com as quais as versões do componente são compatíveis e os links para a documentação de versões anteriores.

Para obter mais informações sobre versões e versões dos Componentes principais, consulte o documento Versões dos componentes principais.

Exemplo de saída do componente

Para experimentar o Componente de texto do formulário e ver exemplos de suas opções de configuração, bem como a saída HTML e JSON, visite a Biblioteca de componentes.

Detalhes técnicos

A documentação técnica mais recente sobre o Componente de texto do formulário pode ser encontrada no GitHub.

Para obter mais detalhes sobre o desenvolvimento dos Componentes principais, consulte a documentação do desenvolvedor dos Componentes principais.

Configurar caixa de diálogo

A caixa de diálogo de configuração permite que o autor do conteúdo defina o tipo de texto a ser inserido, bem como valores e rótulos padrão.

Guia Propriedades

• Restrição - O tipo de texto a ser inserido e será validado em relação a
  • Texto
  • Área de texto
  • E-mail
  • Telefone
  • Data
  • Número
  • Senha
• Linhas de texto - Número de linhas a serem exibidas na área de texto (somente exibidas quando a ​​Restrição estiver definida como Área ​​de texto)
• Rótulo - O rótulo que será exibido para o campo
• Ocultar a exibição da etiqueta - Necessário se a etiqueta for exigida somente para fins de acessibilidade e não fornecer nenhuma informação visual adicional sobre o campo
• Nome do elemento - o nome do campo enviado com os dados do formulário
• Valor - Valor padrão pré-preenchido no campo
• ID - Essa opção permite controlar o identificador exclusivo do componente no HTML e na Camada de dados.
  • Se deixado em branco, uma ID exclusiva é gerada automaticamente para você e pode ser encontrada inspecionando a página resultante.
  • Se uma ID for especificada, é responsabilidade do autor garantir que seja exclusiva.
  • A alteração da ID pode afetar o CSS, o JS e o rastreamento da camada de dados.

Sobre a guia

• Mensagem de ajuda - uma dica para o usuário do que pode ser inserido no campo
• Exibir mensagem de ajuda como espaço reservado - para exibir a mensagem de ajuda dentro da entrada do formulário quando ela estiver vazia e não focalizada

Guia de restrições

• Mensagem de restrição
  • Se o valor não validar o Tipo escolhido, a mensagem será exibida como uma dica de ferramenta ao enviar o formulário
  • Não exibido para os tipos de restrições Text e Área de texto
• Obrigatório - se selecionado, o usuário deve preencher um valor antes de enviar o formulário
  • Mensagem obrigatória - Mensagem exibida como uma dica de ferramenta se o campo ficar vazio
• Tornar somente leitura - Se selecionado, o usuário não poderá modificar o valor do campo

Caixa de diálogo Design

Guia Estilos

O componente de texto do formulário oferece suporte ao AEM Sistema de estilo.