Les Blocs

Bonjour à tous,

Ah, voilà le sujet le plus intéressant (et le plus compliqué, soit dit en passant !) : les blocs. Ces petites choses vous permettent d'expliter des boucles dans les TPL. Au sommaire : Blocs, Blocs imbriqués, variables de blocs (et de blocs imbriqués, enfin, c'est la même chose), foreach...

Let's get started !

Coté PHP

En fait, l'assignation de blocs est très simple, au coté PHP. Tout comme l'assignation de variables, car en fait, c'est la même méthode !

Pour cela, réferez vous à la méthode Talus_TPL::block() : Elle prend comme premier paramètre le nom du bloc (et de tous ses blocs parents ; par exemple, un bloc racine "grand_pere" aura comme nom... "grand_pere", alors que le bloc "parent", sous bloc de "grand_pere", aura pour nom "grand_pere.parent" (etc., sachant qu'il faut donner tous les blocs parents : par exemple, "grand_pere.parent.fils" donnera le bloc fils, sous bloc de parent, lui même sous bloc de grand_pere).

En deuxième paramètre, elle prend soit un array de variables, comme la fonction $tpl->set(), soit le nom d'une variable, demandant ainsi l'utilisation d'un troisième parametre pour renseigner sa valeur. Si le deuxième paramètre est nul, et que le premier est un bloc racine, alors celui-ci est retourné.

ATTENTION : Les blocs parents doivent déjà être déclarés, avant de déclarer un sous bloc à celui-ci !

ATTENTION : Un appel à Talus_TPL::block() équivaut à une seule instance pour un bloc ! Si vous souhaitez déclarer plusieurs variables pour un même bloc, tâchez de passez un array en parametre pour les variables !

ATTENTION : Les noms des blocs doivent être en minuscule !

Par exemple :

L'intêret des blocs est de pouvoir les utiliser dans une boucle while, for, ... A chaque appel de cette méthode, si le bloc n'existe pas, on lui créé une instance, sinon on lui rajoute de nouvelles données, pour une nouvelle ligne.

Ce n'était pas si compliqué, en fin de compte, si ? :p

Coté TPL

Les Blocs

Ici, y'a juste quelque changements. Tout d'abord, la balise pour les blocs est la suivante :

Ou, je pense que vous vous en doutez, mon_bloc est le nom du bloc. Si c'est un bloc racine, pas de soucis, mais pour les blocs imbriqués, vous n'avez besoin que de spécifier seulement le parent le plus proche, dans l'attribut "parent". Soit, en reprenant l'exemple de tout à l'heure :

On peut également faire une action "alternative" : si le bloc ne peut s'executer (aucunes itérations, par exemple), vous pouvez utiliser la balise <blockelse /> (elle fonctionne comme le <else /> des conditions).

Et c'est la même chose pour les variables !

Variables

Je ne vais vous apprendre qu'une seule chose, qui diffère quelque peu des "simples" variables ; Ce sont les même balises, sauf que vous devez spécifier que le nom du bloc parent, suivi qu'un point puis du nom de la variable.

Exemple (en reprenant l'exemple de tout à l'heure) :

Rien de bien compliqué, n'est-ce pas ? ;)

Variables Spéciales

Il existe quatres variables pré-définies par Talus' TPL::block(). Il s'agit des variables, déclarées à chaque instances, qui vous permettent de savoir si c'est la première occurence du bloc, la dernière, le nombre d'occurrence, et enfin l'occurence actuelle.

Utile si vous voulez insérer quelque chose QUE à la première occurrence d'un bloc (ou sa dernière ; par exemple, c'est grâce à la variable FIRST que j'indique l'emplacement de la petite pub sur les forums ;) ), si vous voulez connaitre votre position (pour par exemple afficher quelque chose toutes les deux occurrences, ...), etc.

Les Foreachs

Comme ce sont des boucles, autant parler des foreach. Ceux ci ont juste besoin d'un array (renseignés par les méthodes habituelles)... Et le reste s'effectue au coté TPL.

Vous pouvez aussi imbriquer vos foreach, et définir un alias !

ATTENTION : Pour utiliser un foreach imbriqué, vous devez utiliser que les VALUE (les KEY ne contenant pas d'array, par principe : surtout que PHP en veut pas :p), et également utiliser un alias (as). Pour les autres foreach, vous pouvez l'utiliser... Si vous le souhaitez :). Quoique, l'utilité n'est là que si vous les imbriquez... Mais vous êtes roi dans votre code, vous faites ce que vous voulez ! ;)

Vous pouvez aussi parcourir des arrays pluridimensionnels (type {ARRAY['une']['deux']}), et non pas que des arrays unidimensionnels ({ARRAY['uni']}) via l'instruction foreach. Attention, notez que l'attribut "as" est ici obligatoire ; vous pouvez aussi parcourir un array contenu dans VALUE, ça marche aussi.

Chapitre Précédent : Les Conditions
Chapitre Suivant : Les Filtres

(Ajout d'une demande d'attention sur le fait que les noms des blocs doivent être en minuscule...)

(Mise à jour pour Talus' TPL 1.7.0)