Extension:Loops/fr

Fournit des fonctions d'analyseur pour l'exécution de boucles Actuellement, la version 1.0.0 est en développement, qui comportera inscription d'extension, catégories de suivi pour les pages avec trop de boucles, et pour éviter les régressions. La documentation ci-dessous cible la dernière version stable, v0.5.2.

effectue une boucle (c'est-à-dire qu'il analyse plusieurs fois une instruction de bloc de balisage wiki donnée) tant que le balisage de condition s'évalue en non-espace.


 * Exemples:

Balisage Wiki :

Faites ce qui suit :


 * 0
 * 1
 * 2
 * 3
 * 4

peut également être utilisé dans un modèle pour simuler un tableau numéroté. Si la page "Modèle : Test de boucles" contient

puis le wiki-markup

produit


 * zero
 * one
 * two
 * three
 * four

Il est important de noter que les espaces blancs, y compris les nouvelles lignes, les tabulations et les espaces, sont supprimés du début et de la fin de tous les arguments de ces fonctions d'analyse. Si cela n'est pas souhaitable, l'ajout de caractères autres que des espaces blancs (y compris le codage HTML pour un caractère d'espace blanc ) empêchera la suppression (d'où les balises  dans les exemples ci-dessus).

fonctionne exactement comme, à l'exception du fait que l'instruction block est garantie d'être analysée et affichée (si elle aboutit à un texte affichable) au moins une fois. Ceci est fait avant que le texte de condition soit évalué.

analyse et affiche à plusieurs reprises &lt;wiki markup> un nombre de fois égal à la valeur absolue de &lt;number of loops to be performed>. &lt;Starting value> est placé dans une variable (accessible par la fonction d'analyseur  de l'extension ) en utilisant le nom &lt;variable name>. Après chaque boucle, la variable est incrémentée d'un si &lt;number of loops to be performed> est positif, ou diminuée d'un si &lt;number of loops to be performed> est négatif.

Le code suivant :
 * Exemples :

produces


 * This is round 4 and we have 3 more to go
 * This is round 5 and we have 2 more to go
 * This is round 6 and we have 1 more to go
 * This is round 7 and we have 0 more to go

(experimental)
is to be used in templates. It takes arguments that are passed to the template and puts them in variables accessible by Variables extension's  parser function.

This function iterates through each argument whose name begins with &lt;prefix>. With each iteration it puts the argument name minus &lt;prefix> into &lt;key> as if calling. It then takes the value of the argument and puts it into &lt;value> in a similar method. The block statement is then expanded. The block statement may contain  and   to access the stored arguments.

If the page "Template:Loops Test" contains
 * Example

then the wiki markup

produces


 * 1 = val1
 * 5 = val5
 * ument = value

(experimental)
performs similarly to  with two major differences:  It doesn't take a prefix argument, and it only works on numbered arguments whether they're explicitly numbered,

or implicitly numbered.

Mixing these methods in a single template call may cause values to get overwritten, so be careful.

If "Template:Loops Test" is edited to contain:
 * Examples

then

will result in


 * 1 = Apricot
 * 2 = Caramel slice
 * 5 = Eclair

Configuration
These configuration variables have to be set in the "LocalSettings.php" file after the inclusion of this extension.


 * ( in the forthcoming 1.0.0 release): This parameter sets the maximum number of loops a page is allowed to perform (default  ). Setting it to   lets the loops run within the limits of phps environment.  This parameter affects neither the   nor   parser functions.


 * : Configuration variable (array) to define which Loops functions should be enabled. By default, all functions are enabled if the Variables extension is installed as well. If the Variables extension is not installed,,   and   will be disabled since they do not work without it being installed. To enable the   and   functions only, one can use:

Voir aussi

 * - Another extension for loops
 * Module:Loops