Atributos HTML para elementos

É possível usar as seguintes funções HTML em elementos de formulários. Mas nem todos os atributos se aplicam a todos os elementos. Clique em um elemento para ver que atributos se aplicam a ele.

Os atributos obrigatórios aparecem em negrito no Inspetor de itens. Quando um elemento é adicionado a um formulário, é preciso concluir os atributos obrigatórios e salvar o formulário imediatamente após adicionar o elemento. Depois, é possível adicionar atributos HTML e atributos JavaScript opcionais.

Os atributos HTML são basicamente internos, no sentido de que regulam a aparência e o comportamento do formulário, mas geralmente não fornecem texto literal que aparece para você (administrador) na Área de projeto nem para o usuário no formulário resultante anexado a um serviço. Portanto, embora os nomes e valores dos atributos HTML sejam exibidos e modificados no Inspetor de itens conforme a necessidade, geralmente as alterações não se refletem como texto literal na Área de projeto. As exceções são atributos marcados apenas para botões de opção e caixas de seleção, e o atributo de valor apenas de rótulos, campos de texto e áreas de texto.

Para um atributo HTML, há a opção de inserir uma expressão JavaScript, mas não é possível chamar uma função JavaScript.

Observação: para todos os elementos, exceto rótulos e imagens, forneça o texto literal que será exibido aos usuários finais renomeando os elementos do formulário na Árvore de componentes e verificando sua aparência na Área de visualização, como explicado em Como adicionar e configurar elementos em um formulário.

A seguir, os nomes e descrições de atributos HTML.

nome

Especifica o nome do elemento.

valor

Especifica o valor do componente de entrada. Esse atributo costuma ser útil para inserir dados de exemplo ou instruções; por exemplo, para o atributo de valor de um campo de texto chamado Endereço, especifique algo como "Minha Rua 123" ou "Digite seu endereço aqui”. Em ambos os exemplos, o valor sugere que o usuário substitua o texto padrão por seu endereço real.

checked

Especifica um valor verdadeiro ou falso apenas para botões de opção e caixas de seleção.

Se for especificado verdadeiro, o botão de opção ou a caixa de seleção aparece no formulário como selecionado ou marcado. Se for especificado falso, o botão de opção ou a caixa de seleção aparece como desmarcado.

disabled

Especifica um valor verdadeiro ou falso.

maxlength

Especifica o número máximo de caracteres que o usuário pode inserir no campo. Esse atributo é aplicável somente a campos de texto e de área de texto. Se forem digitados mais caracteres que os valores especificados, ele exibe uma mensagem de erro.

tabindex

Especifica a posição na ordem de tabulações. Digite apenas um valor numérico.

password

Especifica um atributo para os campos de texto. Pode ter um valor verdadeiro ou falso. Quando o valor é definido como verdadeiro, esse componente se torna um componente de senha.

hidden

Pode ter um valor verdadeiro ou falso. Quando o valor é definido como verdadeiro, esse componente não estará visível.

height

Aplica-se somente a áreas de texto. Especifica o número de linhas na área de texto. Por exemplo, se for especificado 3, a área de texto terá 3 linhas.

class

Especifica uma lista de classes separada por espaços. A classe está associada a informações de estilo.

style

Especifica as informações de estilo associadas.

tooltip

Especifica a dica de ferramenta.

dir

Especifica os valores suportados para texto na direção esquerda para a direita e direita para a esquerda (ltr/rtl).

_id

Especifica um identificador exclusivo para o campo do formulário.

Se a _id não for exclusiva, será exibida uma mensagem de aviso.

Importante: O Designer de formulários avisa se o formulário inclui valores duplicados para os atributos _id de campos diferentes, mas não impede que você os salve. Portanto, altere os atributos _id duplicados assim que tomar conhecimento deles. Se o formulário contiver atributos _id duplicados, as funções JavaScript poderão ser executadas no campo de formulário errado e causar erros. Se o valor do atributo _id for alterado, confirme se também foi alterada qualquer referência a ele, em especial em funções JavaScript.

Múltipla

Aplicável somente às caixas de seleção. Esse atributo assume um valor verdadeiro ou falso.

Quando esse atributo é definido como verdadeiro, a caixa de seleção é exibida como caixa de listagem no formulário, o que significa que o usuário vê várias linhas na caixa de seleção e pode selecionar várias opções.

Quando esse atributo é definido como falso, a caixa de seleção aparece como caixa de combinação no formulário, e o usuário pode selecionar um item da lista. O usuário não pode inserir um valor personalizado para esse atributo.

selectedIndex

Aplicável somente às caixas de seleção.

O número digitado se torna o número da seleção padrão. Por exemplo, suponhamos que a caixa de seleção contenha 10 valores. Se for especificado 0 para o atributo selectedIndex, o primeiro valor da lista se tornará o padrão. Da mesma forma, se for especificado 5 para o atributo selectedIndex, o quarto valor da lista se tornará o padrão.

reportobjid

Aplicável somente às caixas de combinação. O valor é a ID do objeto de dados de relatório (objeto de dados) usado para preencher previamente a caixa de combinação. O objeto de dados retorna dois campos:

O primeiro campo retorna a lista de valores da caixa de combinação. Os usuários podem selecionar um ou mais desses valores, dependendo da configuração do atributo múltiplo. O segundo campo retorna o rótulo da caixa de combinação.

O objeto de dados representa uma consulta de MDB independente que não exige uma função JavaScript para ser executada.

reportobjvars

Aplicável somente às caixas de combinação. Especifique este atributo para usar a entrada do usuário para preencher previamente a caixa de seleção.

Por exemplo, você pode especificar este atributo para usar a seleção do usuário em uma caixa de seleção para determinar os valores preenchidos em uma segunda caixa de seleção.

orientation

Aplicável somente a grupos de botões de opção. Esse atributo permite que o usuário controle a orientação das opções do grupo.

Os valores válidos são horizontal e vertical (padrão). Se não for especificado um valor válido, é usado o padrão.

pattern

Aplicável somente a campos de texto e a áreas de texto.

No valor desse atributo, especifique expressões regulares para validar dados numéricos e de endereço, incluindo números de cartão de crédito, números de segurança social, endereços de email, endereços IP e números de telefone.

patternMessage

Aplicável somente a campos de texto e áreas de texto, e somente quando pattern (o atributo anterior) é especificado.

Permite especificar uma mensagem de erro a ser exibida quando a entrada do usuário viola o atributo pattern. Há a opção de localizar essa mensagem de erro.

obrigatório

Especifica se esse campo é obrigatório. Digite um valor verdadeiro ou falso.

Quando o usuário envia o formulário, o sistema verifica se todos os campos obrigatórios estão preenchidos. Um campo obrigatório é aquele cujo atributo required está definido como verdadeiro. Se algum campo obrigatório estiver vazio, o sistema solicita que o usuário os preencha.

labelWidth

Aplica-se somente aos elementos de conjunto de campos e layout da coluna.

Especifica a largura em pixels do layout da coluna e do conjunto de campos.

Observação: você também pode especificar labelWidth como um atributo de formulário.

hidetime

Aplica-se somente à parte de hora do campo Data e hora; esse campo é um elemento opcional de um formulário.

Especifica se a lista suspensa deve ser exibida para que os usuários selecionem a hora. Especifique true para ocultar a lista ou false para exibi-la.

increment

Aplica-se somente à parte de hora do campo Data e hora; esse campo é um elemento opcional de um formulário.

Especifica o incremento (em minutos) das horas que aparecem na lista suspensa para que os usuários selecionem a hora. Os valores válidos são qualquer número inteiro positivo maior que zero.

Por exemplo, se você especificar 15, os valores que aparecerão na lista suspensa para que o usuário selecione incluem 9:00, 9:15, 9:30, 9:45, 10:00 e assim por diante. Da mesma forma, se você especificar 30, os valores que aparecerão na lista incluem 9:00, 9:30, 10:00, 10:30, 11:00 e assim por diante.