Version 2 (modified by cassiomaes, 17 years ago) (diff) |
---|
Este plugin tem por finalidade inserir, facilmente, um calendário para seleção de datas em uma página. Este calendário é baseado em DHTML e Javascript. Na realidade não se trata de um único plugin e sim dois. Um deles tem por finalidade, apenas, escrever o código que referencia os arquivos Javascript e o arquivo de folha de estilos do calendário.
Plugin: wf_calendar_init
Descrição: insere código que regerencia arquivos js e css.
Parâmetros: <nenhum>
Exemplo de utilização: {wf_calendar_init}
Plugin: wf_calendar
Descrição: insere o calendário
Parâmetros:
name : o nome do campo (pertencente ao formulário) que irá receber o valor da data (funciona somente para o caso 1).
default : inicializa outros parâmetros obrigatórios com valores pré-estabelecidos (indica que funcionará no caso 1).
value : o valor inicial para o calendário, e.g. "25/11/1994' (funciona somente para o caso 1).
inputField : o ID do campo que conterá a data selecionada.
displayArea : ID de um DIV, SPAN ou outro elemento que irá mostrar a data selecionada. Geralmente útil quando o campo do formulário que irá armazenar a data é oculto ("hidden").
button : ID do "gatilho" do calendário. É o ID de um elemento, geralmente um botão ou uma imagem, que irá mostrar o calendário quando clicado.
eventName : nome do evento que deve acontecer para mostrar o calendário. O nome do evento não deve conter o prefixo "on", ou seja, ao invés de "onclick" deve utilizar "click" (exemplo).
ifFormat : o formato da data armazenada no campo referenciado pelo ID do inputFiled.
daFormat : o formato da data exibida no elemento referenciado pelo ID do displayArea.
singleClick : indica se o calendário deve funcionar em modo "clique simples" ou "duplo clique".
flat : caso se queira um calendário "plano" (incorporado à página) deve-se passar o ID do elemento que irá conter o calendário. Caso contrário, deve-se passar o valor null.
Valores padrões:
inputField: / valor do parâmetro "name" caso seja passado o parâmetro "default" com valor "true".
button: / valor do parâmetro "name" com o sufixo "-trigger" caso seja passado o parâmetro "default" com valor "true".
eventName : "click"
ifFormat : "%d/%m/%Y"
daFormat : "%d/%m/%Y"
singleClick : true
flat :
Parâmetros obrigatórios (caso 1):
name
default
Parâmetros obrigatórios (caso 2):
flat
inputField
displayArea
button
Parâmetros opcionais:
eventName
ifFormat
daFormat
singleClick
Existem também outros parâmetros pouco usados. Quaisquer dúvidas, basta falar com um dos desenvolvedores. Em 90% dos casos, a utilização do caso 1 já resolve o problema do desenvolvedor.
Exemplos de utilização:
Caso 1:
{wf_calendar default=true name="data_inicio"}
outro exemplo
{wf_calendar default=true name="data_inicio" value=$data}
Caso 2:
{wf_calendar flat=null inputField="campo_if" button="botao" displayArea="campo_da"}
Para o caso 2, além do comando chamando o plugin, deve-se adicionar, manualmente, o código HTML para cada elemento referenciado pelos IDs. Por exemplo, deveríamos criar os seguintes elementos:
<input type="hidden" name="campo_if" id="campo_if">
<input type="text" name="campo_da" id="campo_da">
<button id="botao">
Para o caso 1, apenas a chamada do plugin já cria todo o código necessário. Lembrando que para qualquer um dos dois casos, deve-se preceder uma ou mais chamadas de "wf_calendar" por apenas UMA chamada a "wf_calendar_init".
Exemplo do calendário criado por: {wf_calendar default=true name="data_inicio"}