O loop DATA é 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)`