Versão e compatibilidade
O componente principal de caixa numérica de formulários adaptáveis foi lançado em fevereiro de 2023 como parte dos Componentes principais 2.0.4 para Cloud Service e dos Componentes principais 1.1.12 para AEM Forms 6.5.16.0 ou posterior. Esta é uma tabela que mostra todas as versões compatíveis, a compatibilidade do AEM e os links para a documentação correspondente:
Versão do componente | AEM as a Cloud Service | AEM 6.5.16.0 Forms ou posterior |
---|---|---|
v1 | Compatível com a versão 2.0.4 e posteriores | Compatível com a versão 1.1.12 e versões posteriores, mas que sejam inferiores à 2.0.0. |
Para obter informações sobre as versões dos Componentes principais, consulte o documento Versões dos Componentes principais.
Detalhes técnicos
Obtenha as informações mais recentes sobre o Componente principal de entrada de número dos Formulários adaptáveiss na documentação técnica no GitHub. Para obter mais informações sobre o desenvolvimento dos Componentes principais, consulte a documentação do desenvolvedor dos Componentes principais.
Caixa de diálogo de configuração
Você pode personalizar facilmente a experiência de entrada de números para visitantes com a caixa de diálogo Configurar. Você também pode definir opções de entrada de número com facilidade para proporcionar uma experiência do usuário contínua.
Guia Básico
-
Nome: é possível identificar um componente de formulário facilmente com seu nome exclusivo no formulário e no editor de regras, mas o nome não pode conter espaços ou caracteres especiais.
-
Título: o título permite identificar facilmente um componente em um formulário; por padrão, ele aparece na parte superior do componente. Se um título não for adicionado, o nome do componente será exibido em vez do texto do título.
-
Permitir rich text para título: esse recurso permite formatar títulos de texto simples, incorporando recursos como negrito, itálico, texto sublinhado, várias fontes, tamanhos de fonte, cores e uma opção adicional para aprimorar a apresentação visual e a personalização. Ele oferece maior flexibilidade e controle criativo para que os títulos se destaquem em documentos, sites ou aplicativos.
Ao marcar a caixa de seleção Permitir rich text para título, as opções de formatação se tornam visíveis para estilizar o título do componente. Para acessar todas as opções de formatação disponíveis, clique no -
Ocultar título: selecione essa opção para ocultar o título do componente.
-
Texto de espaço reservado: o texto de espaço reservado em um componente de formulário refere-se a um rótulo curto ou exemplo que aparece em um campo de entrada como uma dica para o usuário sobre que tipo de informação deve ser inserida nesse campo. O texto de espaço reservado desaparece quando o usuário começa a digitar no campo e reaparece se o campo estiver vazio. Fornece uma dica visual ao usuário, mas não age como um rótulo ou valor permanente para o campo.
-
Referência de vínculo: uma referência de vínculo é uma referência a um elemento de dados armazenado em uma fonte de dados externa e usado em um formulário. A referência de vínculo permite vincular dinamicamente os dados a campos de formulário, de modo que o formulário possa exibir os dados mais atualizados da fonte de dados. Por exemplo, uma referência de vínculo pode ser usada para exibir o nome e o endereço de um cliente em um formulário, com base na ID do cliente inserida no formulário. A referência de vínculo também pode ser usada para atualizar a fonte de dados com os dados inseridos no formulário. Dessa forma, o AEM Forms permite criar formulários que interagem com fontes de dados externas, fornecendo uma experiência do usuário perfeita para coletar e gerenciar dados.
-
Marcar como elemento de formulário não vinculado: selecione essa opção para configurar um campo de formulário não vinculado a um esquema. Essa opção permite salvar dados sem atualizar a fonte de dados. Além disso, permite manipular dados de forma personalizada, separadamente da integração do banco de dados padrão.
-
Ocultar componente: selecione essa opção para ocultar o componente do formulário. O componente permanece acessível para outros fins, como usá-lo para cálculos no Editor de regras. Isso é útil quando você precisa armazenar informações que não precisam ser vistas ou alteradas diretamente pelo usuário.
-
Desativar Componente: selecione essa opção para desativar o componente. O componente desativado não está ativo nem editável pelo usuário final. O usuário pode ver o valor do campo, mas não pode modificá-lo. O componente permanece acessível para outros fins, como usá-lo para cálculos no Editor de regras.
-
Somente leitura - Selecione a opção para tornar o componente não editável. O usuário pode ver o valor do campo, mas não pode modificá-lo. O componente permanece acessível para outros fins, como usá-lo para cálculos no Editor de regras.
-
Tipo de número: essa opção permite selecionar o tipo de valores numéricos permitidos no campo de formulário. Você pode selecionar os tipos Decimal ou Inteiro no menu suspenso.
-
Valor padrão: essa opção permite adicionar um valor padrão a um campo de formulário. Se o Componente desativado ou o Componente somente leitura for selecionado, o valor padrão será exibido na tela. Se nenhum valor for inserido pelo usuário no campo de formulário, esse valor será enviado no momento do envio do formulário
Guia Validação
-
Obrigatório: selecione essa opção se desejar exibir o componente em um formulário adaptável. Após selecionar a opção, você deve inserir um valor antes de prosseguir com o envio de formulário. Não é possível selecionar as opções Ocultar componente ou Desativar Componente na guia Básico quando essa opção está selecionada.
-
Mensagem de erro: essa opção permite que você insira uma mensagem que será exibida se uma caixa de seleção Obrigatória estiver marcada mas o campo ficar em branco.
-
Mensagem de validação de script: essa opção permite inserir uma mensagem que será exibida se a validação do script falhar.
-
Número mais baixo / Menor número: use essa opção para selecionar o número mínimo permitido a ser inserido no campo de formulário. Se o valor inserido no campo de formulário for menor que o número especificado na opção Número mais baixo / Menor número, a mensagem de erro será exibida.
-
Mensagem de erro de mínimo: essa opção permite inserir uma mensagem de erro que será exibida quando o usuário inserir um valor menor que o especificado na opção Número mínimo/Número mínimo.
-
Excluir valor mínimo: marque essa caixa de seleção se não quiser que o valor mínimo especificado na opção Número mais baixo / Menor número seja incluído no intervalo de valores que podem ser inseridos no campo de formulário.
-
Número mais alto / Maior número: use essa opção para selecionar o número máximo que pode ser inserido no campo de formulário. Se o número inserido no campo de formulário for maior que o número especificado na opção Número mais alto / Maior número, a mensagem de erro será exibida.
-
Mensagem de erro de máximo: essa opção permite inserir uma mensagem de erro que será exibida quando o usuário inserir um valor maior que o especificado na opção Número mais alto / Maior número.
-
Excluir valor máximo: marque essa caixa de seleção se não quiser que o valor máximo especificado na opção Número mais alto / Maior número seja incluído no intervalo de valores que podem ser inseridos no campo do formulário.
Guia Conteúdo de ajuda
-
Descrição curta: uma descrição curta é uma breve explicação em texto que fornece informações adicionais ou esclarecimentos sobre a finalidade de um campo de formulário específico. Ela ajuda o usuário a entender qual tipo de dados deve ser inserido no campo e pode fornecer diretrizes ou exemplos para ajudar a garantir que as informações inseridas sejam válidas e atendam aos critérios desejados. Por padrão, as descrições curtas permanecem ocultas. Ative a opção Sempre mostrar descrição curta para exibi-la abaixo do componente.
-
Sempre mostrar descrição curta: ative essa opção para exibir a descrição curta abaixo do componente.
-
Texto de ajuda: o texto de ajuda refere-se às informações adicionais ou orientações fornecidas ao usuário para auxiliá-lo no preenchimento correto de um campo de formulário. Ele é exibido quando o usuário clica no ícone de ajuda (i) colocado ao lado do componente. O texto de ajuda fornece informações mais detalhadas do que o rótulo do campo de formulário ou o texto do espaço reservado e foi desenvolvido para ajudar o usuário a entender os requisitos ou restrições do campo. Ele também pode oferecer sugestões ou exemplos para tornar o preenchimento do formulário mais fácil e preciso.
Guia Acessibilidade
-
Texto para leitores de tela: isso se refere ao texto adicional que é especificamente destinado a ser lido por tecnologias de acessibilidade, como leitores de tela, usadas por indivíduos com deficiências visuais. Esse texto fornece uma descrição de áudio da finalidade do campo de formulário e pode incluir informações sobre o título do campo, a descrição, o nome e quaisquer mensagens relevantes (texto personalizado). O texto do leitor de tela ajuda a garantir que o formulário seja acessível a todos os usuários, incluindo aqueles com deficiências visuais, e fornece a eles uma compreensão completa do campo de formulário e de seus requisitos.
- Texto personalizado: selecione essa opção para usar o texto personalizado para rótulos de acessibilidade ARIA. Selecionar essa opção exibe a caixa de diálogo Texto personalizado. Você pode adicionar informações relevantes na caixa de diálogo Texto personalizado.
- Descrição: selecione essa opção para usar a descrição para rótulos de acessibilidade ARIA.
- Título: selecione essa opção para usar o título para rótulos de acessibilidade ARIA.
- Nome: selecione essa opção para usar o nome para rótulos de acessibilidade ARIA.
- Nenhum: selecione essa opção se não quiser adicionar rótulos de acessibilidade ARIA.
Guia Formatos
- Exibir formato: isso permite selecionar opções de diferentes tipos de formatos inteiros-numéricos para exibição. Quando o usuário seleciona qualquer opção do menu suspenso Tipo, a opção Formato se torna visível no painel. É possível escolher um formato específico no qual os números serão exibidos para o usuário.
- Idioma: esse recurso é usado para formatar o campo específico. Quando um usuário seleciona qualquer opção de idioma no menu suspenso Tipo, a opção Tag de idioma IETF BCP 47 aparece no painel. Você pode escolher o idioma para a formatação de campo ao traduzir um formulário adaptável para um idioma específico.
O conjunto de idiomas não está visível por padrão, mas os usuários podem inserir uma Tag de idioma IETF BCP 47 personalizada atualizando a política do modelo:
-
Abra o modelo correspondente associado a um formulário adaptável no editor de modelo.
-
Selecione a política existente como
numberinput-default-policy
no menu suspenso. -
Clique em Concluído.
NOTE
Para obter mais informações sobre como traduzir um formulário adaptável para um idioma específico, clique aqui.
Caixa de diálogo Design
A caixa de diálogo Design é usada para definir e gerenciar os estilos CSS do componente Caixa numérica.