{html_options} est une
fonction personnalisée
qui crée un groupe d'options avec les données fournies. Elle prend en charge
les éléments sélectionnés par défaut.
| Nom attribut | Type | Requis | Defaut | Description |
|---|---|---|---|---|
| values | array | Oui, à moins que vous n'utilisiez l'attribut options | n/a | Un tableau de valeurs pour les listes déroulantes |
| output | array | Oui, à moins que vous n'utilisiez l'attribut options | n/a | Un tableau de libellés pour la liste déroulante |
| selected | chaîne de caractères/tableau | Non | empty | Les éléments sélectionnés |
| options | Tableau associatif | Oui, à moins que vous n'utilisiez option et values | n/a | Un tableau associatif valeur / libellé |
| name | chaîne de caractères | Non | empty | Nom du goupe d'options |
Les attributs requis sont
valuesetoutput, à moins que vous n'utilisiezoptionsà la place.Si l'attribut optionnel
nameest fourni, les balises<select></select>seront créées, sinon, UNIQUEMENT la liste<option>sera générée.Si la valeur fournie est un tableau, il sera traité comme un
<optgroup>HTML, et affichera les groupes. La récursivité est supportée avec<optgroup>.Tous les paramètres qui ne sont pas dans la liste ci-dessus sont affichés sous la forme de paire nom/valeur dans la balise
<select>. Ils seront ignorés si le paramètre optionnelnamen'est pas fourni.Tous les affichages sont conformes XHTML.
Example 8.12. Un tableau associatif avec l'attribut options
<?php
$smarty->assign('myOptions', array(
1800 => 'Joe Schmoe',
9904 => 'Jack Smith',
2003 => 'Charlie Brown')
);
$smarty->assign('mySelect', 9904);
?>
Le template suivant génèrera une liste. Notez la présence
de l'attribut name qui crée les
balises <select>.
{html_options name=foo options=$myOptions selected=$mySelect}
L'affichage de l'exemple ci-dessus sera :
<select name="foo"> <option label="Joe Schmoe" value="1800">Joe Schmoe</option> <option label="Jack Smith" value="9904" selected="selected">Jack Smith</option> <option label="Charlie Brown" value="2003">Charlie Brown</option> </select>
Example 8.13. Tableaux séparés pour values et
ouptut
<?php
$smarty->assign('cust_ids', array(56,92,13));
$smarty->assign('cust_names', array(
'Joe Schmoe',
'Jane Johnson',
'Charlie Brown'));
$smarty->assign('customer_id', 92);
?>
Les tableaux ci-dessus seront affichés avec le template suivant
(notez l'utilisation de la fonction PHP
count() en tant que modificateur pour
définir la taille du select).
<select name="customer_id" size="{$cust_names|@count}">
{html_options values=$cust_ids output=$cust_names selected=$customer_id}
</select>
L'exemple ci-dessous affichera :
<select name="customer_id"> <option label="Joe Schmoe" value="56">Joe Schmoe</option> <option label="Jack Smith" value="92" selected="selected">Jane Johnson</option> <option label="Charlie Brown" value="13">Charlie Brown</option> </select>
Example 8.14. Exemple avec une base de données (e.g. ADODB ou PEAR)
<?php
$sql = 'select type_id, types from contact_types order by type';
$smarty->assign('contact_types',$db->getAssoc($sql));
$sql = 'select contact_id, name, email, contact_type_id
from contacts where contact_id='.$contact_id;
$smarty->assign('contact',$db->getRow($sql));
?>
Où le template pourrait être celui-ci. Notez l'utilisation du modificateur
truncate.
<select name="type_id">
<option value='null'>-- none --</option>
{html_options options=$contact_types|truncate:20 selected=$contact.type_id}
</select>
Example 8.15. Exemple avec <optgroup>
<?php
$arr['Sport'] = array(6 => 'Golf', 9 => 'Cricket',7 => 'Swim');
$arr['Rest'] = array(3 => 'Sauna',1 => 'Massage');
$smarty->assign('lookups', $arr);
$smarty->assign('fav', 7);
?>
Le script ci-dessus et le template suivant
{html_options name=foo options=$myOptions selected=$mySelect}
affichera :
<select name="breakTime">
<optgroup label="Sport">
<option label="Golf" value="6">Golf</option>
<option label="Cricket" value="9">Cricket</option>
<option label="Swim" value="7" selected="selected">Swim</option>
</optgroup>
<optgroup label="Rest">
<option label="Sauna" value="3">Sauna</option>
<option label="Massage" value="1">Massage</option>
</optgroup>
</select>
Voir aussi
{html_checkboxes}
et
{html_radios}