Tópico anterior: Exibir propriedades do formulário em uma janela separadaPróximo tópico: Funções de elemento do formulário


Eventos de elemento do formulário

onBlur

Ocorre quando um elemento do formulário perde o foco. Por exemplo, um formulário contém um campo Nome de usuário. O usuário estabelece o foco no campo pressionando a tecla Tab até alcançá-lo ou clicando nele. O evento onBlur ocorre quando o usuário realiza uma das seguintes ações:

onChange

Ocorre quando um elemento de formulário perde o foco, e o novo valor de um elemento de formulário é diferente do valor antigo. Por exemplo, um formulário contém um campo chamado Quantidade com um valor igual a 10. Depois que o usuário alterar o valor para 15, ele não moverá o foco para outro campo. O evento onChange ocorre quando somente o usuário realiza uma das seguintes ações:

onClick

Ocorre quando um usuário clica em um elemento do formulário. Um clique válido inclui os eventos onMouseDown e onMouseUp no mesmo objeto. Esse requisito ajuda a evitar as funções de chamada ou outro código acidentalmente, já que o mouse deve permanecer no objeto clicável.

onFocus

Ocorre quando um elemento do formulário recebe o foco. Para estabelecer o foco em um elemento do formulário, o usuário pressiona a tecla Tab até alcançá-lo ou clica nele. Também é possível gravar scripts ou código para estabelecer o foco em um elemento do formulário.

onKeyDown

Ocorre quando um usuário pressiona uma tecla para baixo (por exemplo, quando um usuário pressiona a tecla Tab até o campo Nome ou clica nele). Um script associado ao evento onKeyDown do campo Nome alerta os usuários quando eles tentam usar teclas numéricas.

onKeyPress

Ocorre após um usuário pressionar uma tecla e mantê-la pressionada. Por exemplo, o evento onKeyPress ocorrerá depois que um usuário pressionar a tecla Tab um campo Selecionar chamado Nome ou clicar nele e pressionar alguma tecla que represente um alfabeto. Um script associado ao evento onKeyPress do campo Nome percorre nomes que correspondem à tecla alfabética pressionada.

onKeyUp

Ocorre quando o usuário libera uma tecla depois de pressioná-la. Por exemplo, o evento onKeyUp ocorre quando um usuário pressiona a tecla Tab até um campo Controle giratório chamada Temperatura ou clica nele. Um script associado ao evento aumenta ou diminui o valor de um campo sempre que o usuário pressiona e solta uma tecla específica.

onLoad

Ocorre quando o formulário é aberto pela primeira vez que o usuário o preencha.

onLookup

Ocorre quando um usuário clica em Procurar em um campo Pesquisa para exibir os valores que são calculados (ou "pesquisados" conforme instruído pelo script) com base em outros valores de campo.

onMouseDown

Ocorre quando um usuário pressiona o botão esquerdo do mouse em um elemento do formulário.

onMouseMove

Ocorre quando um usuário move o ponteiro do mouse dentro do limite de um elemento do formulário.

onMouseOut

Ocorre quando um usuário move o ponteiro do mouse fora do limite de um elemento do formulário.

onMouseOver

Ocorre quando o usuário move o ponteiro do mouse sobre um elemento do formulário, e o usuário para de mover o mouse.

onMouseUp

Ocorre quando o usuário libera o botão esquerdo do mouse, depois de pressioná-lo para baixo em um elemento do formulário.

onMouseWheel

Ocorre quando um usuário com um mouse equipado com roda rola para frente ou para trás de um elemento do formulário.

onSubmit

Ocorre quando o usuário envia o formulário. Qualquer uma das seguintes ações pode enviar o formulário:

onValidate

Ocorre quando o código associado verifica o valor de um campo com base nas regras comerciais antes de uma das seguintes ações ocorrer:

Por exemplo, o usuário pressiona a tecla Tab até o campo Número de série que deve começar com as letras SN e conter 10 dígitos numéricos ou clica nele. Antes que o usuário possa usar a tecla Tab para ir para o próximo campo ou clicar fora do campo, o evento onValidate e seu código associado verificam os dados. Você pode alertar o usuário se o número de série não estiver de acordo com as regras de validação para que ele possa ajustar a entrada.

Você pode usar onValidate para validação personalizada do campo de entrada. Por exemplo, para garantir que uma entrada do campo tenha pelo menos três caracteres, é possível escrever uma função personalizada na caixa de diálogo Script:

validateValue:function(_val) {
if(_val.length < 3) {
return "Digite mais de 3 caracteres para este campo";
} else {
return null;
}

No Criador de formulários, inclua o valor de atributo onValidate no campo de texto em que deseja executar a validação. Por exemplo:

ca_fd.js.validateValue(_val)

A função personalizada substitui o parâmetro obrigatório _val pelo valor do campo correto quando o script é executado.

Se o script de validação retornar um valor nulo, a entrada do campo passa a validação. Caso contrário, a entrada do campo falha ao validar e o script retorna um erro (por exemplo, "Digite mais de três caracteres para este campo").