Version 3 (modified by viani, 17 years ago) (diff) |
---|
Caixa de Seleção Genérica
Função: wf_set_generic_select
Descrição: esta função define quais serão os itens mostrados na caixa de seleção.
Parâmetros:
$itens: array associativa no formato {{$matriz[$id] = $texto}} ($id pode ser número ou texto) que indica os itens que aparecerão na caixa de seleção.
$container: um número que identifica o "container" onde os itens serão armazenados. No caso de se utilizar mais de uma caixa de seleção genérica em uma mesma atividade, os containeres precisam ser diferentes.
Retorno: <nenhum>
Exemplo de Uso:
$matriz = array(); $matriz[1] = "João"; $matriz[2] = "José"; $matriz[3] = "Maria"; $matriz['abc'] = "Tiago"; wf_set_generic_select($matriz, 0);
A lista deste código quando exibida pelo plugin wf_generic_select, seria como na imagem abaixo:
Plugin: wf_generic_select_init
Descrição: insere código que referencia arquivos de javascript responsáveis pela funcionalidade.
Parâmetros: <nenhum>
Exemplo de uso:
{wf_generic_select_init}
Observação: antes de utilizar "wf_generic_select" (seja uma ou mais vezes), deve-se fazer uma única chamada ao plugin "wf_generic_select_init".
Plugin: wf_generic_select
Descrição: insere o componente que permite a seleção de itens genéricos.
Parâmetros:
name: (obrigatório) o nome que irá armazenar o id do item selecionado;
container_number: (obrigatório) o número do container onde os itens estão armazenados.
id_value: (opcional) o id de um item previamente selecionado (não é visível para o usuário).
desc_value: (opcional) o texto de um item inicialmente selecionado (é visível para o usuário).
title: (opcional) o título da tooltip quando o usuário passa o mouse sobre o botão de adicionar.
O valor padrão para todos os parâmetros não obrigatórios, é uma string vazia.
Exemplo de uso:
{wf_generic_select name="empregado" container_number=0 desc_value="ninguém"}
O componente gerado pelo código acima pode ser visto na imagem abaixo: