Etiquetas de iterações

Nota

A partir de 12 de outubro de 2022, os portais do Power Apps passam a ser Power Pages. Mais informações: O Microsoft Power Pages está agora em disponibilidade geral (blogue)
Em breve, vamos migrar e unir a documentação dos portais do Power Apps com a documentação do Power Pages.

As etiquetas de iteração são utilizadas para executar/compor um bloco de código repetidamente.

para

Executa um bloco de código repetidamente. É o mais utilizado para iterar os itens numa matriz ou dicionário.

No bloco de etiquetas, o objeto forloop está disponível.

Código

{% for child_page in page.children %}

<a href={{ child_page.url }}>{{ child_page.title }}</a>

{% endfor %}

Saída

<a href=/parent/child1/>Child 1</a>

<a href=/parent/child2/>Child 2</a>

<a href=/parent/child3/>Child 3</a>

Parâmetros

Estes parâmetros de for podem ser utilizados isolados ou numa combinação.

limit

Sai do ciclo ao fim de um determinado número de itens.

Código

{% for child_page in page.children limit:2 %}

<a href={{ child_page.url }}>{{ child_page.title }}</a>

{% endfor %}

Saída

<a href=/parent/child1/>Child 1</a>

<a href=/parent/child2/>Child 2</a>

offset

Inicia o ciclo em determinado índice.

Código

{% for child_page in page.children offset:1 %}

<a href={{ child_page.url }}>{{ child_page.title }}</a>

{% endfor %}

Saída

<a href=/parent/child2/>Child 2</a>

<a href=/parent/child3/>Child 3</a>

range

Define um intervalo de números para efetuar o ciclo.

Código

{% assign n = 4 %}

{% for i in (2..n) %}

{{ i }}

{% endfor %}

{% for i in (10..14) %}

{{ i }}

{% endfor }}

Saída

2 3 4

10 11 12 14

reversed

Itera através do ciclo pela ordem inversa, a começar pelo último item.

Código

{% for child_page in page.children reversed %}

<a href={{ child_page.url }}>{{ child_page.title }}</a>

{% endfor %}

Saída

<a href=/parent/child3/>Child 3</a>

<a href=/parent/child2/>Child 2</a>

<a href=/parent/child1/>Child 1</a>

cycle

Efetua o ciclo ao longo de um grupo de cadeias e gera-as pela ordem em que foram transmitidos como parâmetros. De cada vez que o ciclo é chamado, é gerada a cadeia seguinte a ser transmitida como um parâmetro.

Código

{% for item in items %}

<div class={% cycle 'red', 'green', 'blue' %}> {{ item }} </div>

{% end %}

Saída

<div class=red> Item one </div>

<div class=green> Item two </div>

<div class=blue> Item three </div>

<div class=red> Item four </div>

<div class=green> Item five</div>

tablerow

Gera uma tabela HTML. Tem de ser moldada entre as etiquetas HTML de abertura e fecho <table> e </table>.

No bloco de etiquetas tablerow, o tablerowloop está disponível.

Código

<table>

{% tablerow child_page in page.children %}

{{ child_page.title }}

{% endtablerow %}

</table>

Saída

<table>

<tr class=row1>

<td class=col1>

Child Page 1

</td>

<td class=col2>

Child Page 2

</td>

<td class=col3>

Child Page 3

</td>

<td class=col4>

Child Page 4

</td>

</tr>

</table>

Parâmetros

Estes parâmetros de tablerow podem ser utilizados isolados ou numa combinação.

Saída

<table>

<tr class=row1>

<td class=col1>

Child Page 1

</td>

<td class=col2>

Child Page 2

</td>

</tr>

<tr class=row2>

<td class=col3>

Child Page 3

</td>

<td class=col4>

Child Page 4

</td>

</tr>

</table>

Código

<table>

{% tablerow child_page in page.children cols:2 %}

{{ child_page.title }}

{% endtablerow %}

</table>

Dita o número de linhas que a tabela gerada deve ter.

cols

limit

Sai do ciclo ao fim de um determinado número de itens.

Código

<table>

{% tablerow child_page in page.children limit:2 %}

{{ child_page.title }}

{% endtablerow %}

</table>

Saída

<table>

<tr class=row1>

<td class=col1>

Child Page 1

</td>

<td class=col2>

Child Page 2

</td>

</tr>

</table>

offset

Inicia o ciclo em determinado índice.

Código

<table>

{% tablerow child_page in page.children offset:2 %}

{{ child_page.title }}

{% endtablerow %}

</table>

Saída

<table>

<tr class=row1>

<td class=col1>

Child Page 3

</td>

<td class=col2>

Child Page 4

</td>

</tr>

</table>

range

Define um intervalo de números para efetuar o ciclo.

Código

<table>

{% tablerow i in (1..3) %}

{{ i }}

{% endtablerow %}

</table>

Consulte também

Etiquetas de fluxo de controlo Etiquetas variáveis Etiquetas de modelo Etiquetas de entidade do Dataverse

Nota

Pode indicar-nos as suas preferências no que se refere ao idioma da documentação? Responda a um breve inquérito. (tenha em atenção que o inquérito está em inglês)

O inquérito irá demorar cerca de sete minutos. Não são recolhidos dados pessoais (declaração de privacidade).