Páginas

segunda-feira, 9 de agosto de 2010

Introdução ao datepicker do jQuery

O datepicker é uma função da UI do jQuery que nos possibilita adicionar um calendário em um input do tipo text sem muito esforço. um de seus benefícios é que o usuário pode visualizar um calendário e prevenir erros de escrita.

O datepicker também pode ser totalmente customizado no formato de data dos principais países pt-BR (português Brasil), ru (Russo), ja (Japonês) e mais 49 formatos totalizando 52 formatos disponíveis.

Vamos ao que interessa, para baixar o jQuery UI você precisa ir no site do jQuery, http://www.jquery.com
e baixar o jQuery pode ser a production ou a development, caso você queira estudar o código do jQuery você precisara baixar o development pois a opção production vem compactado.
Após baixar o jQuery iremos precisar do jQuery UI, basta clicar no menu do topo da página em UI, ir em Build custom download e selecionar na página o que você deseja adicionar no jQuery ui  desde que o datepicker esteja selecionado ou pode baixar completo.

Para usar o datapicker você precisa ter um input do tipo text com id e o seguinte código no script:

$(function(){
    $("#idcampo").datepicker();
});

explicarei passo a passo:

$(function(){ : indica que você abrira uma nova função quando a página for carregada

$("#idcampo") é uma função que se consegue obter qualquer elemento que tenha um id,  como no getElementById do javascript, ele poupa o programador de escrever muito. (lembrando que para pegar um elemento por id tem q por o # e o nome em seguida como no exemplo)

}); fechamento da função $() e do function()

Podemos também inserir várias opções como meses a frente ou meses a trás que o usuário poderá acessar, regionalização como formato de data em pt-br.

A função fica assim com a regionalização e opções de dias do calendário.

$(function(){
    $("#selector").datepicker({minDate: '-14D', maxDate: '+1M'},$.datepicker.regional['pt-BR']);
});

Dentro do datepicker, podemos passar argumentos como {minDate: '-14D', maxDate: '+1M'}, esse argumento define o números de dias que o calendário deixara selecionar, no exemplo acima 14 dias para trás e 1 mês adiante. O argumento $.datepicker.regional['pt-BR'] você adiciona a regionalização para deixar a data de acordo com o país, como por exemplo 'pt-BR' para português brasileiro.

Existem muitos outros argumentos que são bem úteis e poderão ser encontrado no site do jQuery:
http://jqueryui.com/demos/datepicker/