smarty/docs/es/designers/language-custom-functions/language-function-html-options.xml

<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ -->
		<sect1 id="language.function.html.options">
			<title>html_options</title>
            <informaltable frame="all">
                <tgroup cols="5">
                <colspec colname="param" align="center" />
                <colspec colname="type" align="center" />
                <colspec colname="required" align="center" />
                <colspec colname="default" align="center" />
                <colspec colname="desc" />
                <thead>
                    <row>
                        <entry>Nombre del Atributo</entry>
                        <entry>Tipo</entry>
                        <entry>Requerido</entry>
                        <entry>Default</entry>
                        <entry>Descripción</entry>
                    </row>
                </thead>
                <tbody>
                    <row>
                        <entry>values</entry>
                        <entry>array</entry>
                        <entry>Si, a menos que use el atributo options</entry>
                        <entry><emphasis>n/a</emphasis></entry>
                        <entry>una matriz de valores para el menu dropdown</entry>
                    </row>
                    <row>
                        <entry>output</entry>
                        <entry>array</entry>
                        <entry>Si, a menos que use el atributo options</entry>
                        <entry><emphasis>n/a</emphasis></entry>
                        <entry>una matriz de salida para el menu dropdown</entry>
                    </row>
                    <row>
                        <entry>selected</entry>
                        <entry>string/array</entry>
                        <entry>No</entry>
                        <entry><emphasis>empty</emphasis></entry>
                        <entry>los elemento(s) de la option selecionado(s)</entry>
                    </row>
                    <row>
                        <entry>options</entry>
                        <entry>arreglo asociativo</entry>
                        <entry>Si, a menos que utilize valores y salida</entry>
                        <entry><emphasis>n/a</emphasis></entry>
                        <entry>una matriz asociativa de valores y salida</entry>
                    </row>
                    <row>
                        <entry>name</entry>
                        <entry>string</entry>
                        <entry>No</entry>
                        <entry><emphasis>empty</emphasis></entry>
                        <entry>nombre del grupo seleccionado</entry>
                    </row>
                </tbody>
                </tgroup>
            </informaltable>
			<para>
   html_options es una función customizada que crea un grupo 
   html option con los datos proporcionados. Este se encarga de 
   cuidar cuales datos han sido selecionado por default.
   Los atributos son valores y salidas, a menos que usted utilice
   options en lugar de eso.
			</para>
			<para>
   Si un valor es una matriz, este será tratado como un OPTGROUP html,
   y mostrara los grupos. La recursión es soportada por OPTGROUP.
   Todas las salidas son compatibles con XHTML.
			</para>
			<para>
   Si el atributo opcional <emphasis>name</emphasis> es dado, las 
   etiquetas &lt;select name="groupname"&gt;&lt;/select&gt;
   encapsularan la lista de opciones.
   De otra manera solo es generada la lista de opciones.
			</para>
			<para>
   Todos los par&aacute;metros que no estan en la lista de arriba son 
   exibidos como name/value-pairs dentro de las etiquetas &lt;select&gt;. 
   Estas son ignoradas si la opcion <emphasis>name</emphasis> no es dada.
			</para>
<example>
<title>html_options</title>
<programlisting>
index.php:

require('Smarty.class.php');
$smarty = new Smarty;
$smarty-&gt;assign('cust_ids', array(1000,1001,1002,1003));
$smarty-&gt;assign('cust_names', array('Joe Schmoe','Jack Smith','Jane
Johnson','Carlie Brown'));
$smarty-&gt;assign('customer_id', 1001);
$smarty-&gt;display('index.tpl');

index.tpl:

&lt;select name=customer_id&gt;
	{html_options values=$cust_ids selected=$customer_id output=$cust_names}
&lt;/select&gt;


index.php:

require('Smarty.class.php');
$smarty = new Smarty;
$smarty-&gt;assign('cust_options', array(
			1001 =&gt; 'Joe Schmoe',
			1002 =&gt; 'Jack Smith',
			1003 =&gt; 'Jane Johnson',
			1004 =&gt; 'Charlie Brown'));
$smarty-&gt;assign('customer_id', 1001);
$smarty-&gt;display('index.tpl');

index.tpl:

&lt;select name=customer_id&gt;
	{html_options options=$cust_options selected=$customer_id}
&lt;/select&gt;


SALIDA: (Ambos ejemplos)

&lt;select name=customer_id&gt;
	&lt;option value="1000"&gt;Joe Schmoe&lt;/option&gt;
	&lt;option value="1001" selected="selected"&gt;Jack Smith&lt;/option&gt;
	&lt;option value="1002"&gt;Jane Johnson&lt;/option&gt;
	&lt;option value="1003"&gt;Charlie Brown&lt;/option&gt;
&lt;/select&gt;</programlisting>
</example>
</sect1>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->