La boucle DATA est capable d’itérer sur un jeu de données d’un certain format.
Sa syntaxe est la suivante :
<BOUCLE_afficher(DATA){source format,données}>
[(#CLE)] - [(#VALEUR|print)]
</BOUCLE_afficher>
Le critère {source format, données} définit les données sur lesquelles la boucle va itérer.
— Le format peut être de ce type :
- Tableau PHP : table|tableau
- Collections de fichiers locaux : ls|preg_files
- Contenu de fichiers (locaux ou distants) : file|csv|json|xml|rss|yaml|...
- Commandes : sql|yql|ics|liste|enum|plugins|...
— Les données peuvent être de plusieurs natures, en fonction du format :
- un tableau PHP
- le chemin d’un fichier ou d’un dossier sur le disque dur
- l’URL d’un fichier ou d’un webservice (API)
- ou encore, une chaîne quelconque que le format saura transformer en tableau de données, ex : "select * from flickr.photos.search where text='spip'"
Les critères suivants permettent de filtrer les tableaux affichés par les boucles DATA.
- {valeur=x} ; les opérateurs disponibles sont =, >, <, >=, <=, ==(expression rationnelle) et LIKE.
- {par xx} et {!par xx}
- {a,b} et {pagination ...}
- {fusion /x/y}
- {datapath chemin/vers/ma/donnee}
Un chapitre complet détaille l’usage des boucles DATA, propose des exemples d’usage et présente la manière de déclarer de nouvelles boucles DATA.
Lire la suite : Les itérateurs de SPIP - la boucle (DATA).
Voir Exemples de `BOUCLE(DATA)`