∞ Gestão de Eventos ∞

Eventos são acontecimentos ocorridos quando existe uma qualquer acção do utilizador sobre uma página Web, tais como, pressionar um botão de um formulário, efectuar um clique com o rato sobre um elemento de texto, carregar uma página, etc...

O JavaScript detecta e interpreta os diversos tipos de eventos, sendo tarefa do programador a construção das funções de código correspondentes a cada uma das situações, funções gestoras de evento.

A lista a seguir apresentada mostra uma lista dos eventos disponíveis no JavaScript.

Chama-se a atenção para o facto de que esta lista considera eventos que não estavam disponíveis em várias versões antigas de browsers e de JavaScript, pelo que deverá sempre testar os seus programas nas versões de browser que estiver a tornar como objectivo.

abort     Ocorre quando o carregamento do objecto é abortado.

blur     Ocorre quando o foco é retirado do elemento.

change     Ocorre quando o valor dum elemento do formulário é mudado pelo utilizador.

click     Ocorre quando existe um clique de rato sobre um elemento do formulário.

dblclick     Ocorre quando existe um duplo clique de rato sobre um elemento.

error     Ocorre quando há erro no carregamento do objecto.

focus     Ocorre quando o foco de entrada de dados é atribuído a um elemento.

keydown     Ocorre quando uma tecla é pressionada.

keypress     Ocorre quando uma tecla é pressionada e largada.

keyup     Ocorre quando uma tecla é largada.

load     Ocorre quando uma página é carregada no browser.

mousedown     Ocorre quando o botão do rato é pressionado.

mouseout     Ocorre quando o rato é afastado do objecto.

mouseover     Ocorre quando o cursor do rato é movido sobre um elemento.

resize     Ocorre quando o objecto é modificado no seu tamanho.

select     Ocorre quando o utilizador selecciona um elemento.

submit     Ocorre quando o utilizador submete o formulário com o botão submit.

unload     Ocorre quando a página é abandonada pelo utilizador.

Acerca do foco, uma aplicação de entrada de dados tem normalmente apenas uma zona seleccionada para entrada dos dados, num determinado instante. No caso dos formulários, cada elemento que os constitui pode, em cada instante, estar ou não com o foco de entrada, isto é, está acessível ou não para entrada de dados.

Para atrair o foco para um determinado elemento de um formulário, basta um clique de rato sobre o elemento em causa, e para o retirar basta um clique numa zona fora do formulário.

Funções Gestoras de Evento

Para o JavaScript efectuar alguma acção útil com os eventos, tem que existir associada a cada elemento, e a cada tipo de evento, uma função gestora de evento, event handler. Basicamente, esta é uma função normal, mas que só é executada quando o evento a que ela estiver associada ocorrer no elemento correspodente.

Uma função gestora de evento pode ser definida para um elemento HTML, não só para elementos de formulários, utilizando para tal a seguinte sintaxe:

<elemento Tipo_de_Gestor_Evento = "Função JavaScript">

Exemplos de utilização de funções gestoras de eventos já foram apresentados, consistindo em instruções do tipo:

<input type = "button" onClick = "carregar(this.form)" >   <form ... onSubmit = "submete(document.form)">

O tipo_de_Gestor_Evento consiste, no tipo de função gestora de evento a utilizar, associada ao elemento em causa. Este tipo de função está ligado de forma directa ao tipo

de evento que se pretende interpretar, o tipo de gestor onClick está associado directamente ao evento click.

Para um conjunto de objectos HTML que podem ter eventos associados, tem a seguinte lista de tipos de gestores de evento que podem ser empregues.

Elemento     Gestor de Evento          Evento

Area     onmouseover          mouseover     onmouseout          mouseout     ondblclick          dblclick

Body     onclick          click     ondblclick          dblclick     onkeydown          keydown     onkeyup          keyup     onkeypress          keypress     onmousedown          mousedown     onmouseup          mouseup

Button     onblur          blur     onclick          click     onfocus          focus     onmousedown          mousedown     onmouseup          mouseup

CheckboxRadioSubmitReset

     onblur          blur     onclick          click     onfocus          focus

Document     onclick          click     ondblclick          dblclick     onkeydown          keydown     onkeypress          keypress     onkeyup          keyup     onmousedown          mousedown     onmouseup          mouseup

File Upload     onblur          blur     onchange          change     onfocus          focus

Form     onreset          reset     onsubmit          subrnit

Img     onabort          abort     onerror          error     onkeydown          keydown     onkeypress          keypress     onkeyup          keyup     onload          load

Link     onclick          click     ondblclick          dblclick     onkeydown          keydown     onkeypress          keypress     onkeyup          keyup     onmousedown          mousedown     onmouseout          mouseout     onmouseover          mouseover     onmouseup          mouseup

∞ Gestão de Eventos :.         | Parte II |

Password     onblur          blur     onfocus          focus

Select     onblur          blur     onchange          change

Text     onblur          blur     onfocus          focus     onchange          change     onselect          select

TextArea     onblur          blur     onfocus          focus     onchange     onkeydown          keydown     onkeypress          keypress     onkeyup     onselect          select

WindowFramesetFrame     onblur          blur     onerror          error     onfocus          focus     onload          load     onresize

          resize     onunload          unload

 

Conforme se pode comprovar nos exemplos que seguidamente se apresentam, a utilização das funções gestoras de evento faz-se sem dificuldade, utilizando, para tal a sintaxe que vimos atrás e tendo em atenção o evento que se está a pretender captar.

Começamos por um exemplo de um campo de texto integrado num formulário, em que se vai utilizar o evento focus, que é activado quando o utilizador da página efectua um clique de rato sobre o elemento, atraindo assim o foco.

O código é o seguinte:

<html><head><title> Teste de eventos </title></head>

<body>

<script language="Javascript" type="text/javascript">       // Função Gestora do Evento   function coloca_nome(form) {       form.campo1.value = "Teste";    }</script>

<form>   valor:    <input type = "text" name = "campo1" onfocus = "coloca_nome(this.form)" > <br></form>

</body></html>

               

 

 

A ideia é que, quando se coloca o foco no campo de texto, é preenchido automaticamente o campo com o valor "Teste". Ao ser colocado o foco no elemento de texto, é chamada a função gestora de evento coloca_nome, do tipo onFocus. Esta simplesmente coloca a propriedade value do objecto form.campo1 com o valor Teste.

No exemplo seguinte, temos um evento associado a um link HTML, neste caso, o mouseover. É utilizada uma função gestora de evento de tipo onmouseover, que

responde a uma acção de passar com rato por cima do link. A função chamada em caso de evento está neste caso embebida dentro da própria linha de chamada da função gestora do evento.

<html><head><title> Teste de eventos </title></head>

<body>   <form>      <a href = "pag2.html" onmouseover = "window.status = 'Este link aponta para a pagina 2';               return true"> Página Dois </a> <br>

      <a href = "pag3.html" onmouseover = "window.status = 'Este link aponta para a pagina 3';               return true"> Página Três </a> <br>

</form>

</body></html>

               

 

 

Repare-se no pormenor da utilização das plicas ('), em vez de aspas, na linha de chamada da função gestora de evento, uma vez que a utilização de aspas (") no interior das aspas geraria uma situação de ambiguidade sintáctica.

Ao executar o programa, surgem os dois links na janela do browser e, ao passar com o rato por cima de um deles, a função gestora de evento é chamada como resposta ao evento mouseover. A acção resume-se a colocar um texto descritivo do link em causa na barra de estado, na parte de baixo da janela do browser.

Este evento não tem naturalmente nada a ver com a selecção do link propriamente dita, que pode ser feita com um clique do rato.

Para demonstrar que os eventos podem ser aplicados a um conjunto variado de objectos HTML, vejamos o seguinte exemplo, trata-se de uma versão muito simples de uma página que efectua o desvio do browser do utilizador para uma página diferente daquela que é carregada.

Para isso, utiliza-se um evento associado ao elemento <body>, de início do corpo do documento, pelo que estamos a procurar captar o evento de carregamento da página.

Pela tabela que vimos atrás, este evento corresponde ao objecto document e a função gestora do evento a utilizar é do tipo onload().

A página utilizada é a seguinte:

<html><head><title> Teste de eventos </title>

<script language="Javascript" type="text/javascript">   function jump() {       window.open("pag2.html");   }</script>

</head>

<body onload = "jump()"> </body>

</html>

               

 

 

Logo que a página é carregada, é de imediato carregada a nova página pag2.html. O evento responsável é o load, associado ao objecto document.

Neste caso, estamos a optar por uma secção body vazia, enquanto que num outro caso anterior existia uma mensagem que aparecia durante um certo período de tempo e só depois o link era aberto.

A função gestora de evento jump() efectua o carregamento da nova página utilizando o método window.open(). Naturalmente que a visualização desta página é feita numa janela de browser independente da primeira, que fica vazia por carregar uma página com corpo vazio.

Para além de gerir os eventos que ocorrem, o JavaScript tem a possibilidade de os provocar. Para tal utilizam-se nos formulários e com os seus objectos um conjunto de métodos, cuja execução equivale à ocorrência dos eventos propriamente ditos.

 

Métodos

blur     Retira o foco de um objecto.

click()     Clique de rato sobre o elemento.

focus()     Coloca o foco num objecto.

select()     Selecciona o conteúdo texto contido do objecto.

submit()     Submete um formulário.

As aplicações possíveis para estes métodos são variadas. Eles serão executados sempre que for vantajoso em termos de programação substituir o acto físico de provocar um evento por parte do utilizador por uma instrução de código. Por exemplo, em certas circunstâncias pode ser útil submeter um formulário, mesmo sem utilizar um botão de Submit, como era tradicional no HTML.

Vejamos o seguinte exemplo:

<html><head><title> Teste de eventos </title></head>

<body>

<script language="Javascript" type="text/javascript">   function mudou(form) {      form.submit();   }</script>

<form method = post action = "submit_script.cgi">   Qual o seu nome?   <input type = "text" name = "texto" onChange = "mudou(this.form)" ></form>

</body></html>

∞ Gestão de Eventos :.         | Parte III |

Exemplos Práticos

Para vermos na prática as vantagens de utilizarmos a manipulação de eventos em JavaScript, vejamos como poderíamos modificar o programa que fizemos para possibilitar a encomenda de Pizzas, agora com a hipótese de validação local por elemento do formulário.

Em primeiro lugar, imaginemos que queremos informar o cliente, que no caso de escolher uma Pizza Calzone terá que esperar um pouco mais. Assim, no elemento de escolha, testamos o evento de mudança de elemento seleccionado e, no caso de ser o de índice n° 4 (Calzone), enviamos uma janela e aviso.

As alterações a efectuar são muito simples. O elemento em causa terá uma função de gestão de evento associada.

<html><head><title>Encomenda de Pizzas</title>

<script language="Javascript" type="text/javascript">

   ...

   function sel_pizza(form) {     // função gestora de evento      if (form.pizza.selectedIndex == 4) {         window.alert("Atenção: Esta pizza é demorada! (30 minutos)");      }   }

   ...

</script></head>

<body>

   ...

         <td> Qual a Pizza a encomendar? </td>         <td>             <select name = "pizza" onChange = "sel_pizza(this.form)">               <option/>               <option> Marguerita </option>               <option> Capriciosa </option>

               <option> Quatro Estações </option>               <option> Calzone </option>               <option> Tropical </option>               <option> Maritima </option>            </select>          </td>

   ...

</body></html>

 

Tudo o resto se mantém idêntico, incluindo as validações globais antes da submissão do formulário. Contudo, a diferença está no processamento deste evento local, que é efectuado sempre que existir uma mudança do elemento que estiver seleccionado na lista de escolha das Pizzas.

 

Vejamos um outro exemplo, com um tipo diferente de objecto. Utilizando ainda o mesmo programa de encomenda de Pizzas, é agora pretendido que, quando o utilizador for ao campo de preenchimento da morada, indique uma referência para o local onde será feita a entrega. Para isso, recorremos ao evento focus, no campo de texto da morada. Isto significa que, assim que o utilizador da página seleccionar o campo em causa, será logo notificado do assunto.

As alterações a efectuar ao programa são unicamente: a criação de uma função gestora do evento em causa, onFocus e escrever esta função com um simples envio de uma janela alert para o ecrã.

<html><head><title>Encomenda de Pizzas</title>

<script language="Javascript" type="text/javascript">

   ...

   function sel_morada() {     // função gestora de evento      window.alert("Atenção: Coloque uma referenda para identificação do local                        (Exemplo: à frente do bar do zé...)");   }

   ...

</script></head>

<body>

   ...

         <td> Morada: </td>         <td> <input type = "text" name = "morada" size = "40" onfocus = "sel_morada()" > </td>

   ...

</body></html>