Changes between Version 1 and Version 2 of WF/CampodeEntradaAutocompletavel

Timestamp:

10/21/10 16:33:12 (14 years ago)

Author:

asaikawa

Comment:

--

WF/CampodeEntradaAutocompletavel

@@ -57 +57 @@
 '''Valor padrão:'''
 
-  minLength: 1,
+  minLength: 1
 
   style: "width: 200px"
@@ -69 +69 @@
 }}}
 
-O exemplo acima cria um ''input'' e carrega o cache com o retorno do método '''"recuperaCidades"''' que, com o parâmetro '''"1"''', recupera as cidades do Paraná. Como não foi informado o modo de funcionamento, o cache está sendo carregado uma única vez, ou seja, não há outras chamadas ajax durante o uso do componente.
+O exemplo acima cria um ''input'' e carrega o cache com o retorno do método '''"recuperaCidades"''' que, com o parâmetro '''"1"''', recupera as cidades do Paraná. Como não foi informado o modo de funcionamento, é utilizado o modo padrão, onde o cache é carregado uma única vez, ou seja, não há outras chamadas ajax durante o uso do componente. Caso queira deixar explícito que o modo utilizado é este, deve-se informar '''"mode='POPULATE_ON_LOAD'"'''.
 
-Continua........
+{{{
+  {wf_autocomplete_input name="_cidade_atendimento" ajaxClass="abrirOS" ajaxMethod="recuperaCidadesPorChave" idValue=1 textValue="Curitiba, PR" mode="REPOPULATE_ON_CHANGE"}
+}}}
+
+O exemplo acima cria um ''input'' que contém valores iniciais, identificados pelo ''"idValue"'' e ''"textValue"''. O modo '''REPOPULATE_ON_CHANGE''' indica que cada nova entrada fará uma chamada ajax, cujo retorno será armazenado no cache. O uso do cache possibilita que sejam feitas um menor número de chamadas ajax.
+
+'''IMPORTANTE:'''
+
+ * Usando-se este plugin no modo '''REPOPULATE_ON_CHANGE''', não é necessário passar o parâmetro ''"methodParam"'', pois o parâmetro do método será o conteúdo do campo ''input'' em que o usuário está digitando.
+
+ * Sobre o array de retorno da chamada ajax:
+   * Os métodos chamados na requisição ajax devem retornar um array no formato:
+   {{{
+    Array
+    (
+      [id_1] => texto_1
+      [id_2] => texto_2
+       ...
+    )
+   }}}
+   * No exemplo das cidades do Paraná, ao digitar 'arap', o método deve retornar:
+   {{{
+    Array
+    (
+      [10062] => Arapongas, PR
+      [78] => Arapoti, PR
+      [10064] => Arapuã, PR
+    )
+   }}}
+    * Neste caso, o componente será apresentado da seguinte forma:[[br]]
+     [[Image(autocomplete_cidade.jpg)]]
+
+Continua....