What is Smarty?
Why use it?
Use Cases and Work Flow
Syntax Comparison
Template Inheritance
Best Practices
Crash Course
You may use the Smarty logo according to the trademark notice.
For sponsorship, advertising, news or other inquiries, contact us at:
{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
values
et output
,
à moins que vous n'utilisiez options
à la place.
Si l'attribut optionnel name
est 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 optionnel
name
n'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}