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).