La boucle DATA

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).

Auteur BoOz Publié le :

Traductions : français, Nederlands