Propriedades e métodos do objeto form

Damos uma olhada nas diferentes propriedades e métodos do objeto form de Javascript. Mostramos algum exemplo de utilização de propriedades e uma simples validação de formulário e envio com o método submit ().

Por Miguel Angel Alvarez - Tradução de JML


Publicado em: 19/4/05
Valorize este artigo:
Vamos ver agora o objeto form por si só, para destacar suas propriedades e métodos.

Propriedades do objeto form

Têm umas propriedades para ajustar seus atributos mediante Javascript.

action
É a ação que queremos realizar quando se submete um formulário. Coloca-se geralmente um endereço de correio ou a URL a qual lhe mandaremos os dados. Corresponde com o atributo ACTION do formulário.

elements array
A matriz de elementos contém cada um dos campos do formulário.

encoding
O tipo de codificação do formulário

length
O número de campos do formulário.

method
O método pelo qual mandamos a informação. Corresponde com o atributo METHOD do formulário.

name
O nome do formulário, que corresponde com o atributo NAME do formulário.

target
A janela ou frame no qual está dirigido o formulário. Quando se submete se atualizará a janela ou frame indicado. Corresponde com o atributo target do formulário.

Exemplos de trabalho com as propriedades

Com estas propriedades podemos mudar dinamicamente com Javascript os valores dos atributos do formulário para fazer com ele o que se deseje dependendo das exigências do momento.

Por exemplo, poderíamos mudar a URL que receberia a informação do formulário com a instrução.

document.meuFormulário.action = "minhaPágina.asp"

Ou mudar o target para submeter um formulário em uma possível janela secundária chamada minha_janela.

document.meuFormulário.target = "minha_janela"

Métodos do objeto form

Estes são os métodos que podemos invocar com um formulário.

submit()
Para fazer com que o formulário se submeta, embora não se tenha clicado o botão de submit.

reset()
Para reiniciar todos os campos do formulário, como se tivéssemos clicado o botão de reset. (Javascript 1.1)

Exemplo de trabalho com os métodos

Vamos ver um exemplo muito simples sobre como validar um formulário para submete-lo no caso de que esteja preenchido. Para isso, vamos utilizar o método submit() do formulário.

O mecanismo é o seguinte: em vez de colocar um botão de submit colocamos um botão normal (<INPUT type="button">) e fazemos que ao clicar esse botão se chame a uma função que é a encarregada de validar o formulário e, no caso de que esteja correto, submete-lo.

O formulário ficaria assim:

<form name="meuFormulário" action="mailto:colabore@criarweb.com" enctype="text/plain">
<input type="Text" name="campo1" value="" size="12">
<input type="button" value="Enviar" onclick="validaSubmite()">
</form>


Observamos que não há um botão de submit, e sim, um botão normal com uma chamada a uma função que podemos ver a seguir.

function validaSubmete(){
    if (document.meuFormulário.campo1.value == "")
       alert("Deve preencher o formulário")
    else
       document.meuFormulário.submit()
}


Na função se comprova que se o que está escrito no formulário é um string vazio. Se for isso, mostra-se uma mensagem de alerta que informa que se deve preencher o formulário. No caso de haver algo no campo de texto submete o formulário utilizando o método submit do objeto form.





Comentários do artigo
Foram enviados 2 comentários ao artigo
2 comentários não revisados
0 comentários revisados

Usuários :    login / registro

Manuais relacionados
Categorias relacionadas
O autor

Home | Sobre nós | Copyright | Anuncie | Entrar em contato