smarty template engine
Friday, August 08, 2008  
download | documentation | faq | forum | mailing lists | changelog | contribs 


search for in the  


{html_options}

{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 attributTypeRequisDefautDescription
valuesarrayOui, à moins que vous n'utilisiez l'attribut optionsn/aUn tableau de valeurs pour les listes déroulantes
outputarrayOui, à moins que vous n'utilisiez l'attribut optionsn/aUn tableau de libellés pour la liste déroulante
selectedchaîne de caractères/tableauNonemptyLes éléments sélectionnés
optionsTableau associatifOui, à moins que vous n'utilisiez option et valuesn/aUn tableau associatif valeur / libellé
namechaîne de caractèresNonemptyNom 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.

Exemple 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>

Exemple 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>

Exemple 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>

Exemple 8-15. Exemple avec <optgroup>

<?php
$arr
['Sport'] = array(=> 'Golf'=> 'Cricket',=> 'Swim');
$arr['Rest']  = array(=> 'Sauna',=> '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}




 

credits 

Smarty Copyright © 2002-2008
New Digital Group, Inc.

All rights reserved.