Changes between Version 5 and Version 6 of WF/CaixadeSelecaoMultipla-OptGroup
- Timestamp:
- 08/22/07 14:04:48 (17 years ago)
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 1 4 == Plugin: wf_select_option_multiple_init == 5 2 6 '''Descrição:''' Insere código que referencia arquivos de javascript responsáveis pela funcionalidade. 3 4 5 7 6 8 '''Parâmetros:''' <nenhum> 7 9 8 9 10 10 '''Exemplo:''' 11 11 12 {wf_select_option_multiple_init} 13 14 15 16 12 {{{ 13 {wf_select_option_multiple_init} 14 }}} 17 15 18 16 Observaçã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 21 17 22 18 ---- … … 27 23 28 24 Para remover um ou mais itens do ''select'', basta selecioná-los e clicar no botão "Remover". Isso vai reabilitá-los na ''combo''. 29 30 31 25 32 26 '''Parâmetros:''' … … 52 46 style: para definir os estilos do ''select box''. 53 47 54 55 56 48 '''Parâmetros obrigatórios:''' 57 49 … … 59 51 60 52 nameBottom 61 62 63 53 64 54 '''Valor padrão:''' … … 71 61 72 62 diffEnable: true 73 74 75 63 76 64 A seguir, é apresentada a combo com uma lista dividida em grupos. Para isso, o array deve possuir o seguinte formato: … … 92 80 ) 93 81 ) 94 95 82 }}} 96 83 97 84 [[Image(htdocs:wf/images/select_option_multiple_combo.png)]] 98 85 99 100 101 86 Alguns elementos estão desabilitados pois já foram adicionados ao ''select''. 102 103 104 87 105 88 Uma visão mais geral do componente é apresentada a seguir: … … 107 90 [[Image(htdocs:wf/images/select_option_multiple.png)]] 108 91 109 110 111 92 Ao remover um elemento do ''select'', ele volta a ser habilitado na ''combo'' para que possa ser selecionado novamente, se necessário. 112 113 114 93 115 94 '''Exemplo de utilização:''' 116 95 96 {{{ 117 97 {wf_select_option_multiple nameTop="disponiveis" nameBottom="cadastrados" arrayTop=$lista diffEnable=false} 118 119 98 }}} 120 99 121 100 O 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. 122 101 123 124 125 102 {wf_select_option_multiple nameTop="disponiveis" nameBottom="cadastrados" arrayTop=$listaCombo arrayBottom=$listaSelect sortEnableBottom=false} 126 127 128 103 129 104 O 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'''. 130 105 131 132 133 106 '''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.