Smarty - a ferramenta para compilar templates para PHP
Anterior	Capítulo 8. Funções Personalizadas	Próxima

cycle

Nome do Atributo	Tipo	Obrigatório	Padrão	Descrição
name	string	Não	default	O nome do ciclo
values	mixed	Sim	n/d	Os valores do ciclo, ou uma lista delimitada por vírgula (veja o atributo delimiter), ou uma matriz de valores.
print	boolean	Não	true	Quando mostrar ou não o valor
advance	boolean	Não	true	Quando avançar ou não para o próximo valor
delimiter	string	Não	,	O delimitador para usar no atributo 'values'.
assign	string	Não	n/d	A variável de template que receberá a saída

Cycle é usado para fazer um clico através de um conjunto de valores. Isto torna fácil alternar entre duas ou mais cores em uma tabela, ou entre uma matriz de valores.

Você pode usar o cycle em mais de um conjunto de valores no seu template. Dê a cada conjunto de valores um nome único.

Você pode fazer com que o valor atual não seja mostrado definindo o atributo print para false. Isto é útil para pular um valor.

O atributo advance é usado para repetir um valor. Quando definido para false, a próxima chamada para cycle irá mostrar o mesmo valor.

Se você indicar o atributo especial "assign", a saída da função cycle será passada para uma variável de template ao invés de ser mostrado diretamente no template.

Exemplo 8-3. cycle

{section name=rows loop=$data}
<tr bgcolor="{cycle values="#eeeeee,#d0d0d0"}">
 <td>{$data[rows]}</td>
</tr>
{/section}
MOSTRA:
<tr bgcolor="#eeeeee">
 <td>1</td>
</tr>
<tr bgcolor="#d0d0d0">
 <td>2</td>
</tr>
<tr bgcolor="#eeeeee">
 <td>3</td>
</tr>

Anterior	Principal	Próxima
counter	Acima	debug