ForEach

La etiqueta ForEach permite iterar por una colecci�n de objetos. Puede hacerse referencia a la colecci�n mediante una expresi�n (expr) o ruta (path).

Elija una propiedad de la lista Propiedades y haga clic en Agregar para insertarla en el cuadro Nombre de la propiedad de la lista de contenido. Si la propiedad seleccionada incluye sus propias propiedades, puede agregar una a la expresi�n si la selecciona en la segunda lista desplegable y hace clic en en Agregar. Si no hay colecciones en la plantilla de introducci�n de datos actual, la lista Propiedades no estar� disponible.

La lista de valores por la que itera la etiqueta depende del resultado de la evaluaci�n del atributo

Tipo de objeto	Valores repetidos
lista	Cada uno de los elementos de contenido de la lista.
lista de selecci�n	Cada uno de los valores seleccionados en la lista de selecci�n.
elemento de contenido	Elemento de contenido.
folder	Cada uno de los elementos de contenido de la carpeta.

Escriba un nombre de variable (opcional). En cada iteraci�n, la variable (citada en el atributo var=) se va configurando en cada uno de los valores. Otras expresiones de Publisher pueden utilizar una variable dentro del contenido de la etiqueta ForEach (consulte el ejemplo que sigue a continuaci�n). Si no se puede evaluar la expresi�n, se descarta el elemento.

Mediante las variables auxiliares definidas en la etiqueta ForEach, pude proporcionar informaci�n acerca de la lista o de cada uno de los elementos de la lista. Para generar esta informaci�n, agregue cualquiera de los sufijos siguientes al final del nombre de la variable en la etiqueta.

Variable auxiliar	Descripci�n
NombreDeVariable_position	La posici�n del elemento actual en la lista (empieza en 1 y aumenta con cada elemento).
NombreDeVariable_size	El n�mero de elementos en la lista.
NombreDeVariable_previous	El valor que ten�a el elemento actual en la repetici�n anterior (el valor del primer pase es nulo).
NombreDeVariable_next	El valor que tendr� el elemento actual en la repetici�n siguiente (el valor del �ltimo pase es nulo).

El atributo var= puede omitirse de la etiqueta ForEach y no se definir� ninguna variable para la etiqueta evaluada. Sin embargo, las variables auxiliares que aqu� se enumeran siguen definidas y pueden usarse sin un prefijo.

Si desea que se muestre texto con cada valor de la colecci�n, escriba el Texto para incluir con el elemento FOREACH. Este texto aparece entre etiquetas <pcs> de apertura y de cierre en el cuadro Etiqueta PCS.

Atributo

Descripci�n

Sintaxis

<pcs:foreach var="variable" expr="expresi�n">texto predeterminado</pcs:foreach>

<pcs:foreach var="variable" path="ruta">texto predeterminado</pcs:foreach>

Ejemplo:

<pcs:foreach var="item" expr="article_list">
...
  <pcs:value expr="item.headline"></pcs:value>
  <pcs:value expr="item.story"></pcs:value>
  �ste es el elemento <pcs:value expr="item_position"></pcs:value> de
  <pcs:value expr="item_size"></pcs:value>
...
</pcs:foreach>

<pcs:foreach var="item" expr="folderByPath('/authors/latest')"></pcs:foreach>

Nota: los sufijos de variables, por ejemplo NombreDeVariable_position, no deber�an confundirse con referencias a propiedades (NombreDeVariable.name). Un sufijo y el nombre de la variable a la que se adjunta se consideran una sola palabra o s�mbolo, y se eval�an como uno. Las referencias a propiedades son diferentes de los nombres de variable a los que se adjuntan; son dos nombres espec�ficos y se eval�an una a continuaci�n de la otra. La evaluaci�n empieza con el nombre de la variable y pasa a la propiedad.

Los elementos ForEach pueden anidarse. Un elemento ForEach se eval�a a s� mismo antes de evaluar su contenido (repetidamente).