O loop DATA (dados) é capaz de iterar sobre um conjunto de dados de um determinado formato.
A sua sintaxe é a seguinte:
<BOUCLE_Exibir(DATA){source format,données}>
[(#CLE)] - [(#VALEUR|print)]
</BOUCLE_Exibir>
O critério {source format, données} define os dados sobre os quais o loop irá iterar.
O formato pode ser do tipo:
- Tabela PHP :
table|tableau - Coleção de ficheiros locais:
ls|preg_files - Conteúdo de ficheiros (locais ou remotos):
file|csv|json|xml|rss|yaml|... - Comandos:
sql|yql|ics|liste|enum|plugins|...
Os dados podem ser de diversas naturesas, em função do formato:
- uma tabela PHP
- o caminho de um ficheiro ou de uma pasta no disco duro
- o URL de um ficheiro ou de um webservice (API)
- ou ainda, qualquer string que o formato seja capaz de transformar em tabela de dados, ex:
"select * from flickr.photos.search where text='spip'"
Os critérios a seguir permitem filtrar as tabelas exibidas pelos loops DATA:
-
{valeur=x};os operadores disponíveis são=, >, <, >=, <=, ==(expressão racional) eLIKE. -
{par xx}e{!par xx} -
{a,b}e{pagination ...} -
{fusion /x/y} -
{datapath chemin/vers/ma/donnee}
Um capítulo completo detalha o uso dos loops DATA, mostra exemplos de utilização e apresenta a maneira de declarar novos loops DATA.
Leia a sequência : Os iteradores do SPIP - o loop (DATA).
Veja Exemplos de `BOUCLE(DATA)`