Nome do Atributo | Tipo | Obrigatório | Padrão | Descrição |
---|---|---|---|---|
name | string | Não | checkbox | O nome da lista checkbox |
values | array | Sim, a menos que estaja usando o atributo options | n/a | Uma matriz de valores para os botões checkbox |
output | array | Sim, a menos que estaja usando o atributo options | n/a | uma matriz de saída para os botões checkbox |
selected | string/array | Não | empty | O(s) elemento(s) checkbox marcado(s) |
options | matriz | Sim, a menos que esteja usando values e output | n/a | Uma matriz associativa de valores e saída |
separator | string | Não | empty | string de texto para separar cada checkbox |
labels | boolean | Não | true | Adicionar tags <label> para na saída |
html_checkboxes é uma função personalizada que cria um grupo de checkbox com os dados fornecidos. Ela cuida de qual(is) item(s) estão selecionado(s) por padrão. Os atributos obrigatórios são values e output, a menos que você use options. Toda a saída é compatível com XHTML.
Todos os parâmetro que não estejam na lista acima são mostrados como pares nome/valor dentro de cada tag <input> criada.
Example 8.6. html_checkboxes
index.php: require('Smarty.class.php'); $smarty = new Smarty; $smarty->assign('cust_ids', array(1000,1001,1002,1003)); $smarty->assign('cust_names', array('Joe Schmoe','Jack Smith','Jane Johnson','Charlie Brown')); $smarty->assign('customer_id', 1001); $smarty->display('index.tpl'); index.tpl: {html_checkboxes values=$cust_ids checked=$customer_id output=$cust_names separator="<br />"} index.php: require('Smarty.class.php'); $smarty = new Smarty; $smarty->assign('cust_checkboxes', array( 1000 => 'Joe Schmoe', 1001 => 'Jack Smith', 1002 => 'Jane Johnson', 1003 => 'Charlie Brown')); $smarty->assign('customer_id', 1001); $smarty->display('index.tpl'); index.tpl: {html_checkboxes name="id" options=$cust_checkboxes checked=$customer_id separator="<br />"} MOSTRA: (ambos os exemplos) <label><input type="checkbox" name="checkbox[]" value="1000" />Joe Schmoe</label><br /> <label><input type="checkbox" name="checkbox[]" value="1001" checked="checked" />Jack Smith</label><br /> <label><input type="checkbox" name="checkbox[]" value="1002" />Jane Johnson</label><br /> <label><input type="checkbox" name="checkbox[]" value="1003" />Charlie Brown</label><br />