Les balises commutateurs [b:switch / b:case / b:default]

Les balises commutateurs b:switch, b:case et b:default sont des instructions qui permettent d’exécuter ou non un bloc de codes.
Les balises commutateurs se comportent comme les balises conditionnelles b:if, b:elseif et b:else.

La syntaxe

XML

<b:switch var='EXPRESSION'>

  <b:case value='VALUE1'/>

    <!-- Vrai si la valeur1 est égale au résultat de l'expression -->

  <b:case value='VALUE2'/>

    <!-- Vrai si tous les cas précédents ne remplissent pas les conditions requises
         et vrai si la valeur2 est égale au résultat de l'expression -->

  <b:default/>

    <!-- Vrai si tous les cas précédents ne remplissent pas les conditions requises -->

</b:switch>

• Les balises b:switch, b:case et b:default travaillent dans l'ensemble du code XML, excepté dans la balise b:skin.
• Plusieurs balises b:switch peuvent s'imbriquer.
• Les balises b:case et b:default doivent être imbriquées dans une balise b:switch.
• L'usage de la balise b:case est requise et la balise b:default n'est pas obligatoire.
• La balise b:case peut être utilisée plusieurs fois dans une balise b:switch.
• La balise b:default ne peut être utilisée qu'une seule fois dans une balise b:switch. Si b:switch contient une ou plusieurs balises b:case, la balise b:default devra être la dernière balise à être mentionnée dans le commutateur.

Les paramètres des balises

A l'exception de la balise b:default, les balises b:switch et b:case doivent être dotées d'un paramètre.
La balise b:default ne requiert aucun paramètre. Elle n'est exécutée que lorsque tous les commutateurs précédents ne remplissent pas les conditions requises.

<b:switch var='EXPRESSION'>
  <b:case value='VALUE'/>
  
  <b:default/>
  
</b:switch>

Balise	Paramètre	Signification	-
b:switch	var	La valeur du commutateur. La valeur attendue peut être une donnée ou une expression Blogger. Les types de valeurs autorisés sont : string number boolean	Obligatoire
b:case	value	La valeur du cas. Cette valeur est comparée à la valeur du commutateur. Les types de valeurs autorisés sont : string number boolean La valeur peut être également une expression Blogger si le paramètre est précédé du préfixe expr:. La valeur du résultat de l'expression devra être l'un des 3 types mentionnés ci-dessus.	Obligatoire
b:default	-	Aucun paramètre	-

Quelques exemples

Avec une donnée booléenne

<b:switch var='data:view.isMobile'>
  <b:case value='true'/>
    <!-- Vrai si la valeur de data:view.isMobile est true -->
  <b:default/>
    <!-- Vrai si le cas précédent ne rempli pas la condition requise -->
</b:switch>

La donnée data:view.isMobile est de type boolean (booléen). La valeur renvoie toujours true (vraie) ou false (fausse).

Avec une donnée string

<b:switch var='data:view.type'>
  <b:case value='item'/>
    <!-- Vrai si la valeur de data:view.type est "item" -->
  <b:case value='feed'/>
    <!-- Vrai si le cas précédent ne rempli pas la condition requise
         et vrai si la valeur de data:view.type est "feed" -->
  <b:default/>
    <!-- Vrai si les cas précédents ne remplissent pas les conditions requises -->
</b:switch>

La donnée data:view.type est de type string (Chaîne de caractères).

Avec une donnée numérique et une expression Blogger

<b:switch var='data:posts.length + 10'>
  <b:case value='0'/>
    <!-- Vrai si la valeur de l'expression est égale à 0 -->
  <b:case expr:value='10 - 1'/>
    <!-- Vrai si le cas précédent ne rempli pas la condition requise
         et vrai si l'expression est égale à l'opération 10 - 1 -->
  <b:default/>
    <!-- Vrai si les cas précédents ne remplissent pas les conditions requises -->
</b:switch>

Le paramètre var dans le commutateur switch contient une expression Blogger (une opération mathématique) : Nombre d'items dans le tableau posts + 10.
Le premier cas contient une simple valeur numérique : 0.
Le 2e cas contient une expression Blogger (une autre opération mathématique) : 10 - 1.

Participer à la conversation

Dernière modification : vendredi, 14 avril 2017