Componente de Texto do formulário form-text-component
O componente de Texto de formulário, dos Componentes principais, permite a entrada do texto de formulário para envio.
Uso usage
O componente de Texto do formulário permite o envio de diferentes tipos de texto e deve ser usado junto com o componente de Contêiner de formulário. O tipo de validação de texto, rótulos e mensagens de ajuda pode ser definido pelo editor de conteúdo na caixa de diálogo de configuração.
Versão e compatibilidade version-and-compatibility
A versão atual do componente de Texto de formulário é a v2, introduzida com a versão 2.0.0 dos Componentes principais em janeiro de 2018, e está descrita neste documento.
A tabela a seguir detalha todas as versões compatíveis do componente, as versões do AEM com as quais as versões do componente são compatíveis e os links para a documentação das versões anteriores.
Para mais informações sobre as versões dos Componentes principais, consulte o documento Versões dos Componentes principais.
Exemplo de saída do componente sample-component-output
Para experimentar o componente de Texto de Formulário, e ver exemplos de suas opções de configuração e de saídas HTML e JSON, visite a Biblioteca de Componentes.
Detalhes técnicos technical-details
A documentação técnica mais recente sobre o componente Texto do formulário pode ser encontrada no GitHub.
Mais detalhes sobre o desenvolvimento dos Componentes principais podem ser encontrados na documentação do desenvolvedor dos Componentes principais.
Caixa de diálogo de configuração configure-dialog
A caixa de diálogo de configuração permite que o autor de conteúdo defina o tipo de texto a ser inserido, bem como valores e rótulos padrão.
Guia Propriedades properties-tab
-
Restrição - O tipo de texto a ser inserido e em relação ao qual será validado
- Texto
- Área de texto
- Telefone
- Data
- Número
- Senha
-
Linhas de texto - Número de linhas a serem exibidas na área de texto (exibidas somente quando a Restrição é definida como Área de texto)
-
Rótulo - O rótulo que será exibido para o campo
-
Impedir o rótulo de ser exibido - Necessário se o rótulo for necessário somente para fins de acessibilidade e não imprimir nenhuma informação visual adicional sobre o campo
-
Nome do elemento - O nome do campo enviado com os dados de formulário
-
Valor - O valor padrão que é pré-preenchido no campo
-
ID - Essa opção permite controlar o identificador exclusivo do componente no HTML e na Camada de Dados.
- Caso deixado em branco, um ID exclusivo é gerado automaticamente para você e pode ser encontrado ao inspecionar a página resultante.
- Se um ID for especificado, é responsabilidade do autor garantir que ele seja exclusivo.
- A alteração do ID pode afetar o rastreamento de CSS, JS e da Camada de Dados.
Sobre a guia about-tab
- Mensagem de ajuda - Uma dica para o usuário sobre o que pode ser inserido no campo
- Exibir mensagem de ajuda como espaço reservado -Para exibir a mensagem de ajuda dentro da entrada de formulário quando ela estiver vazia e não focalizada
Guia de restrições constraints-tab
-
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 tipos de restrição de Texto e Área de Texto
-
Obrigatório - Caso 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 - Caso selecionado, o usuário não poderá modificar o valor do campo
Caixa de diálogo de design design-dialog
Guia Estilos styles-tab
O Componente de Texto de formulário é compatível com o Sistema de Estilos do AEM.