smarty/docs/es/designers/language-builtin-functions/language-function-foreach.xml

<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ -->
		<sect1 id="language.function.foreach">
			<title>foreach,foreachelse</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>from</entry>
                        <entry>array</entry>
                        <entry>Si</entry>
                        <entry><emphasis>n/a</emphasis></entry>
                        <entry>El nombre de la matriz a la que usted estara pegando
                         los elementos</entry>
                    </row>
                    <row>
                        <entry>item</entry>
                        <entry>string</entry>
                        <entry>Si</entry>
                        <entry><emphasis>n/a</emphasis></entry>
                        <entry>El nombre de la variable que es el elemento
                        actual</entry>
                    </row>
                    <row>
                        <entry>key</entry>
                        <entry>string</entry>
                        <entry>No</entry>
						<entry><emphasis>n/a</emphasis></entry>
						<entry>El nombre de la variable que es la llave actual</entry>
                    </row>
                    <row>
                        <entry>name</entry>
                        <entry>string</entry>
                        <entry>No</entry>
                        <entry><emphasis>n/a</emphasis></entry>
						<entry>El nombre del ciclo foreach para acessar a las propiedades del foreach</entry>
                    </row>
                </tbody>
                </tgroup>
            </informaltable>
			<para>
    Los ciclos(loop) <emphasis>foreach</emphasis> son una alternativa para loop 
    <emphasis>section</emphasis>. <emphasis>foreach</emphasis> es usado para pegar 
    cada elemento de una matriz asociativa simple.
    La sintaxis para <emphasis>foreach</emphasis> es mucho mas simple que 
    <emphasis>section</emphasis>, pero tiene una desventaja de que solo puede ser 
    usada en una única matriz.
    La etiqueta  <emphasis>foreach</emphasis> debe tener su par 
    <emphasis>/foreach</emphasis>.
    Los parámetros requeridos son <emphasis>from</emphasis> e 
    <emphasis>item</emphasis>. El nombre del ciclo(loop) foreach puede ser 
    cualquier cosa que usted quiera, hecho de letras, números y subrayados. 
    Los ciclos(loop) <emphasis>foreach</emphasis> pueden ser anidados, 
    y el nombre de los ciclos(loop) anidados debe ser diferente uno de
    otro. La variable <emphasis>from</emphasis> (normalmente una matriz de valores) 
    determina el número de veces del ciclo(loop) <emphasis>foreach</emphasis>.
    <emphasis>foreachelse</emphasis> y ejecutando cuando no hubieren mas valores 
    en la variable <emphasis>from</emphasis>.
			</para>
<example>
<title>foreach</title>
<programlisting>

{* este ejemplo muestra todos los valores de la matriz $custid *}
{foreach from=$custid item=curr_id}
	id: {$curr_id}&lt;br&gt;
{/foreach}

SALIDA:

id: 1000&lt;br&gt;
id: 1001&lt;br&gt;
id: 1002&lt;br&gt;</programlisting>
</example>

<example>
<title>foreach key</title>
<programlisting>
{* La llave contiene la llave para cada valor del ciclo(loop)

asignacion fisica de esta manera:

$smarty->assign("contacts", array(array("phone" =&gt; "1", "fax" =&gt; "2", "cell" =&gt; "3"),
      array("phone" =&gt; "555-4444", "fax" =&gt; "555-3333", "cell" =&gt; "760-1234")));

*}

{foreach name=outer item=contact from=$contacts}
  {foreach key=key item=item from=$contact}
    {$key}: {$item}&lt;br&gt;
  {/foreach}
{/foreach}

SALIDA:

phone: 1&lt;br&gt;
fax: 2&lt;br&gt;
cell: 3&lt;br&gt;
phone: 555-4444&lt;br&gt;
fax: 555-3333&lt;br&gt;
cell: 760-1234&lt;br&gt;</programlisting>
</example>

		<para>
   El ciclo(Loop) foreach también tiene sus propias variables para
   manipular las propiedades del foreach.
   Estas son indicadas así: {$smarty.foreach.foreachname.varname} con 
   foreachname siendo el nombre especificado del atributo
   <emphasis>name</emphasis> del foreach.
		</para>


			<sect2 id="foreach.property.iteration">
			<title>iteration</title>
			<para>
    iteration es usado para mostrar la interación actual del ciclo(loop).
			</para>
			<para>
    iteration siempre comienza en 1 incrementado uno a uno en cada interaciónn.
			</para>
			</sect2>

			<sect2 id="foreach.property.first">
			<title>first</title>
			<para>
    <emphasis>first</emphasis> Toma el valor true si la interación actual del 
     foreach es la primera.
			</para>
			</sect2>

			<sect2 id="foreach.property.last">
			<title>last</title>
			<para>
      <emphasis>last</emphasis> Toma el valor de true si la interación actual 
       del foreach es la ultima.
			</para>
			</sect2>

			<sect2 id="foreach.property.show">
			<title>show</title>
			<para>
         <emphasis>show</emphasis> Es usado como parámetro para el foreach.
         <emphasis>show</emphasis> Es un valor booleano, true o false.
         Si es false, el foreach no será mostrado.  Si tuviera un
         foreachelse presente, este será alternativamente mostrado.
			</para>

			</sect2>
			<sect2 id="foreach.property.total">
			<title>total</title>
			<para>
      <emphasis>total</emphasis> Es usado para mostrar el número de interaciones 
      del foreach. Este puede ser usado dentro o después de el.
			</para>
			</sect2>





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