JavaScript - Guia de Referência
© 1997 Anderson Barros Torres


CheckBox


Este objeto como o próprio nome sugere, exibe uma caixa de checagem igual às que encontramos no Windows, o funcionamento também é o mesmo: a condição de selecionada ou não, é alternada quando clicamos o mouse sobre o objeto, ou seja, se clicarmos sobre um objeto checkbox já marcado ele será automaticamente desmarcado, ao passo que se clicarmos em um objeto checkbox desmarcado ele será automaticamente marcado.  

Forma geral:
<FORM>
<INPUT TYPE="checkbox" NAME="NomeDoObjeto" [CHECKED] VALUE="Label" onClick="Ação">
</FORM>

Onde:
Type - Nome do objeto

Name - Nome dado pelo programador, para futuras referenciações ao objeto.

CHECKED - Se especificado a CheckBox já vai aparecer selecionada

Value - Define um rótulo para a CheckBox. Só não consegui descobrir para que!

onClick - Define o que fazer quando dá-se um clique na CheckBox, fazendo com que o objeto CheckBox funcione como um objeto Button.
 

Propriedades:
name - Nome do objeto CheckBox em forma de string, da mesma forma como definido no campo Name utilizado na criação da CheckBox.

NomeDoObjeto.name // equivale a string "NomeDoObjeto"

value - Armazena o conteúdo do campo VALUE, definido na TAG. Ainda não encontrei utilidade para este campo na CheckBox, caso você saiba...
Ex: NomeDoObjeto.value

checked - Retorna um valor lógico que depende do estado do objeto CheckBox
NomeDoObjeto.checked // equivale a True se o objeto estiver selecionado e False caso contrário

defaultChecked - Informa/Altera o estado default de um objeto CheckBox. Com relação a alteração, somente os objetos CheckBox ainda não exibidos podem ter seu estado default alterado. NomeDoObjeto.defaultChecked // sempre equivalerá a True, se a cláusula CHECKED estiver presente e a False caso contrário 

Métodos:
click: Este método simula um clique do mouse no objeto CheckBox, ou seja, executa um procedimento associado a uma CheckBox como se estivessemos clicado na CheckBox mas sem que o usuário tenha realmente clicado.

Select01.click() // executaria a função ConfirmaInformacoes
 

Eventos associados:
onClick: Define o que fazer quando clicamos no objeto CheckBox

Exemplo:

<HTML>
<HEAD>
<TITLE>Exemplo CheckBox</TITLE>
<SCRIPT>
function exemplo(p1,p2,p3,p4){
alert('Veja os conteúdos das propriedades:
       \nName='+p1+
       '\nValue='+p2+
       '\nChecked='+p3+
       '\ndefaultChecked='+p4);

}
</SCRIPT>
</HEAD>

<BODY>
<CENTER>
<H3>Exemplo do objeto CheckBox</H3>
<HR>
<FORM>
<INPUT TYPE="checkbox" NAME="chb" VALUE="QQ COISA" CHECKED onClick="exemplo(chb.name,chb.value,chb.checked,chb.defaultChecked)")>
Tecle aqui...
</FORM>
<BR>
<HR>
<BR>
Tecle no CheckBox para observar o funcionamento!!!
Para retornar clique o mouse <A HREF="history.go(-1)">AQUI</A>
</CENTER>
</BODY>
</HTML>




Página desenvolvida por Anderson Barros Torres. Julho/97
Última alteração: