Version 1 (modified by asaikawa, 14 years ago) (diff) |
---|
Campo de Entrada Autocompletável
Plugin: wf_autocomplete_input_init
Descrição: Insere código que referencia arquivos de javascript responsáveis pela funcionalidade.
Parâmetros: <nenhum>
Exemplo:
{wf_autocomplete_input_init}
Observação: antes de utilizar "wf_autocomplete_input" (seja uma ou mais vezes), deve-se fazer uma única chamada ao plugin "wf_autocomplete_input_init".
Plugin: wf_autocomplete_input
Descrição: Este plugin insere um input que, conforme o usuário digita uma nova entrada, são filtrados e mostrados os valores que podem ser selecionados.
Este componente possui dois modos de funcionamento:
- POPULATE_ON_LOAD: Todos os valores são armazenados em um cache previamente através de uma requisição ajax.
- REPOPULATE_ON_CHANGE: Os valores vão sendo armazenados em um cache conforme são feitas as requisições ajax. Este modo foi desenvolvido de forma que não haja 2 chamadas ajax idênticas, ou seja, apenas entradas diferentes farão novas chamadas.
Em ambos os modos a classe e o método que serão invocados são passados por parêmetro no momento em que o desenvolvedor utiliza o componente
Parâmetros:
name: o nome que o componente irá receber.
ajaxClass: classe ajax que será utilizada para fazer a consulta.
ajaxMethod: método da classe que será invocado para preencher a lista de opções.
methodParam: (opcional) parâmetro para o método que será invocado para preencher a lista de opções.
minLength: (opcional) número mínimo de caracteres necessários para que as opções apareçam na lista.
idValue: (opcional) o id de um item previamente selecionado (não é visível para o usuário).
textValue: (opcional) o texto de um item inicialmente selecionado (é visível para o usuário).
style: (opcional) estilo para o campo input.
mode: (opcional) modo de funcionamento do componente: POPULATE_ON_LOAD ou REPOPULATE_ON_CHANGE
Parâmetros obrigatórios:
name
ajaxClass
ajaxMethod
Valor padrão:
minLength: 1,
style: "width: 200px"
mode: "POPULATE_ON_LOAD"
Exemplo de utilização:
{wf_autocomplete_input name="_cidade" ajaxClass="abrirOS" ajaxMethod="recuperaCidades" methodParam=1}
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.
Continua........
Attachments
-
autocomplete_cidade.jpg
(9.4 KB) -
added by asaikawa 14 years ago.
Campo autocomplete de cidades
-
autocomplete_cidade_ok.jpg
(6.5 KB) -
added by asaikawa 14 years ago.
Campo autocomplete verificado (OK)
-
autocomplete_cidade_nok.jpg
(11.1 KB) -
added by asaikawa 14 years ago.
Campo autocomplete verificado (Não OK)