Changes between Initial Version and Version 1 of WF/Calendario

Timestamp:

07/24/07 15:01:45 (17 years ago)

Author:

trac

Comment:

--

WF/Calendario

@@ +1 @@
+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"}
+
+
+
+:[[Image(http://doc.workflow.celepar.parana/wiki/plugin_calendario.jpg)]]