Changes between Version 5 and Version 6 of WF/CaixadeSelecaoMultipla-OptGroup


Ignore:
Timestamp:
08/22/07 14:04:48 (17 years ago)
Author:
viani
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • WF/CaixadeSelecaoMultipla-OptGroup

    v5 v6  
     1= Caixa de Seleção Múltipla - !OptGroup = 
     2[[TOC(heading=Workflow,depth=1,WF/Changelog,WF/Documentacao,WF/Instalacao,WF/Links,WF/Propostas,WF/Recursos)]] 
     3 
    14== Plugin: wf_select_option_multiple_init == 
     5 
    26'''Descrição:''' Insere código que referencia arquivos de javascript responsáveis pela funcionalidade. 
    3  
    4  
    57 
    68'''Parâmetros:''' <nenhum> 
    79 
    8  
    9  
    1010'''Exemplo:''' 
    1111 
    12   {wf_select_option_multiple_init} 
    13  
    14  
    15  
    16  
     12{{{ 
     13{wf_select_option_multiple_init} 
     14}}} 
    1715 
    1816Observação: antes de utilizar "wf_select_option_multiple" (seja uma ou mais vezes), deve-se fazer uma '''única''' chamada ao plugin "wf_select_option_multiple_init".  
    19  
    20  
    2117 
    2218---- 
     
    2723 
    2824Para remover um ou mais itens do ''select'', basta selecioná-los e clicar no botão "Remover". Isso vai reabilitá-los na ''combo''. 
    29  
    30  
    3125 
    3226'''Parâmetros:''' 
     
    5246  style: para definir os estilos do ''select box''. 
    5347 
    54  
    55  
    5648'''Parâmetros obrigatórios:''' 
    5749 
     
    5951 
    6052  nameBottom 
    61  
    62  
    6353 
    6454'''Valor padrão:''' 
     
    7161 
    7262  diffEnable: true 
    73  
    74  
    7563 
    7664A seguir, é apresentada a combo com uma lista dividida em grupos. Para isso, o array deve possuir o seguinte formato: 
     
    9280                    ) 
    9381) 
    94  
    9582}}} 
    9683 
    9784[[Image(htdocs:wf/images/select_option_multiple_combo.png)]] 
    9885 
    99  
    100  
    10186Alguns elementos estão desabilitados pois já foram adicionados ao ''select''. 
    102  
    103  
    10487 
    10588Uma visão mais geral do componente é apresentada a seguir: 
     
    10790[[Image(htdocs:wf/images/select_option_multiple.png)]] 
    10891 
    109  
    110  
    11192Ao remover um elemento do ''select'', ele volta a ser habilitado na ''combo'' para que possa ser selecionado novamente, se necessário. 
    112  
    113  
    11493 
    11594'''Exemplo de utilização:''' 
    11695 
     96{{{ 
    11797{wf_select_option_multiple nameTop="disponiveis" nameBottom="cadastrados" arrayTop=$lista diffEnable=false} 
    118  
    119  
     98}}} 
    12099 
    121100O exemplo acima cria o componente com o array $lista carregado na ''combo''. Se esse array tiver um formato semelhante ao exemplo da imagem acima, será utilizado o optGroup, mas se for um array normal, será criada uma ''combo'' com ''options'' normais. O parâmetro "diffEnable=false" indica que não será realizado o diff entre a ''combo'' e o ''select'', que nesse caso realmente não é necessário, pois o ''select'' está vazio. 
    122101 
    123  
    124  
    125102{wf_select_option_multiple nameTop="disponiveis" nameBottom="cadastrados" arrayTop=$listaCombo arrayBottom=$listaSelect sortEnableBottom=false} 
    126  
    127  
    128103 
    129104O exemplo acima cria o componente com a ''combo'' e o ''select'' carregados automaticamente com os arrays $listaCombo e $listaSelect, respectivamente. Quando não é especificado o '''diffEnable''', ou é definido "diffEnable=true", é efetuado o diff entre a ''combo'' e o ''select'', que desabilita os elementos da ''combo'' que forem encontrados no ''select''. Com "sortEnableBottom=false", os elementos do ''select'' não serão ordenados. Caso esse parâmetro não seja especificado, seu valor padrão é '''true'''. 
    130105 
    131  
    132  
    133106'''ATENÇÃO:''' Antes do formulário ser submetido, você deve chamar a função javascript do componente "selectAllOptions". Essa função recebe como parâmetro o nome do ''select'' a ter as ''options'' selecionadas. No PHP serão recuperados os ''values'' dos elementos selecionados.