Expressions¶
Une expression est une séquence de jetons qui s'évalue en une seule valeur — le contenu à afficher, l'URL à utiliser ou une condition à tester.
Pensez à une expression comme une recette : chaque ingrédient (jeton) transforme les données un pas plus loin. Vous la lisez de gauche à droite. posts → first → title signifie « obtenir les articles, prendre le premier, extraire le titre ».
Comprendre les jetons¶
Il existe quatre types de jetons — les briques de base des expressions.
Jetons de propriété : ils accèdent à un champ de votre API GraphQL. Exemples : posts, title, featured_image, author_name. Chaque jeton de propriété demande à l'API une donnée spécifique.
Jetons de filtre : ils transforment les données en utilisant des filtres Liquid. Exemples : upcase (mettre le texte en majuscules), where (filtrer une liste), first (obtenir le premier élément). Les filtres sont toujours appliqués à la sortie du jeton précédent.
Jetons d'état : ils font référence à un état créé sur un élément qui contient celui-ci. Si un conteneur a un état appelé post, les éléments qu'il contient peuvent s'en servir pour réutiliser ses données.
Jetons fixes : ce sont des valeurs codées en dur que vous saisissez vous-même — une chaîne de caractères, un nombre ou un booléen. Utiles pour les valeurs de secours ou le contenu statique.
Comment les jetons se chaînent¶
Les expressions fonctionnent de gauche à droite. Chaque jeton prend la sortie du jeton précédent comme entrée.
Exemple 1 : chaîne de propriété simple
« Obtenir l'objet auteur, puis extraire le champ nom. »Exemple 2 : propriété + filtre
« Obtenir le titre, puis appliquer le filtre upcase pour le mettre tout en majuscules. »Exemple 3 : chaîne complexe
« Obtenir les articles, filtrer uniquement ceux dont la catégorie est 'news', prendre le premier, et extraire son titre. »Cette chaîne a quatre jetons :
- Propriété :
posts— récupérer tous les articles - Filtre :
where— restreindre par catégorie - Filtre :
first— choisir le premier résultat - Propriété :
title— obtenir le champ titre
Entrée et sortie des jetons¶
Chaque jeton a un type de données qu'il attend et un type qu'il produit.
Un jeton de propriété qui renvoie une liste d'articles a un type de sortie « liste d'articles ». Si vous appliquez ensuite le filtre first, il produit « un article » (un objet). Ensuite, vous pouvez utiliser la propriété title, qui produit « chaîne de caractères ».
Lorsque vous construisez une expression dans l'éditeur, Silex vous montre quels jetons sont valides — il ne vous laissera pas appliquer un filtre conçu pour les chaînes à un nombre, par exemple.
Valeurs fixes¶
Parfois vous avez besoin de saisir une valeur statique — un morceau de texte, un nombre ou un slug d'URL.
Un jeton fixe est simplement du texte ou un nombre que vous tapez. Dans une expression comme :
Le "published" est un jeton fixe — une chaîne codée en dur. Il ne provient pas de votre API ; vous indiquez à Silex « comparer le champ status à cette chaîne exacte ».
Où vont les expressions¶
Vous construisez les expressions dans les réglages de l'élément (icône engrenage en haut du panneau de droite) :
- Properties : HTML content (le texte dans l'élément), Visibility Condition (afficher ou masquer l'élément, voir Conditions) et Loop Data (répéter l'élément, voir Boucles et listes)
- Attributes : des attributs HTML comme
href,srcoualt - States : des valeurs que vous nommez vous-même, partagées avec les éléments qu'il contient
Construire votre première expression¶
Cliquez sur Expression à côté d'un champ, puis sur + : le menu montre les jetons que vous pouvez ajouter. Commencez par une propriété (quelque chose de votre API), puis ajoutez des filtres pour façonner les données.
Si vous souhaitez afficher le titre du premier article de blog, votre expression est :
- Sélectionnez la propriété
posts. Si votre API enveloppe la liste, choisissez aussi le champ qui la contient, commenodesoudata - Ajoutez le filtre
first - Ajoutez la propriété
title - Le résultat :
posts → first → title, qui produit une chaîne (le titre)
Mettez-la dans le HTML content d'un Text et le titre apparaît sur le canevas.
En savoir plus¶
- Lier les données — étapes pratiques pour créer et utiliser des expressions dans l'éditeur
- Boucles et listes — comment le champ Loop Data répète un élément pour chaque entrée d'une liste
- Conditions — opérateurs de visibilité et comment afficher/masquer en fonction des données
- Filtres — référence complète de tous les filtres Liquid disponibles
- Configuration WordPress — comprendre la structure de données avec laquelle vous travaillerez
Quiz¶
Q1 : Vous souhaitez afficher la version en majuscules du titre du premier article. De quels jetons avez-vous besoin ?
- A)
posts → first → title → upcase - B)
posts → first → upcase → title - C)
upcase → posts → first → title
Réponse
A) posts → first → title → upcase — Vous récupérez les articles, prenez le premier, extrayez son titre (une chaîne), puis appliquez upcase pour le mettre en majuscules. Les jetons de filtre doivent venir après les données qu'ils transforment.
Q2 : Qu'est-ce qu'un jeton fixe ?
- A) Un jeton qui ne change jamais
- B) Une valeur codée en dur que vous tapez (pas provenant de votre API)
- C) Un jeton qui ne peut être utilisé qu'une fois par expression
Réponse
B) Une valeur codée en dur que vous tapez (pas provenant de votre API) — Les jetons fixes sont des chaînes littérales, des nombres ou des booléens que vous saisissez directement, par opposition aux jetons de propriété qui récupèrent des données de votre API GraphQL.
Q3 : Dans l'expression posts → where (status = "published") → first → title, qu'est-ce que "published" ?
- A) Un jeton de propriété
- B) Un jeton de filtre
- C) Un jeton fixe
Réponse
C) Un jeton fixe — Vous comparez le champ status à la chaîne exacte "published". C'est une valeur littérale que vous saisissez, pas que vous récupérez de l'API.
Q4 : Pourquoi Silex vous empêche-t-il d'appliquer un filtre de chaîne à un nombre ?
- A) C'est une limitation technique
- B) Le filtre n'aurait pas de sens ou produirait une erreur
- C) Silex veut simplifier l'interface
Réponse
B) Le filtre n'aurait pas de sens ou produirait une erreur — Les filtres sont conçus pour des types de données spécifiques. Un filtre de mise en majuscules attend du texte ; l'appliquer à un nombre n'a pas de sens sémantique et échouerait.
Q5 : Vous voulez que plusieurs éléments dans un Container réutilisent le premier article. Où construisez-vous posts → first ?
- A) Dans un état (State) du Container
- B) Dans la Visibility Condition du Container
- C) Dans un jeton fixe
Réponse
A) Dans un état (State) du Container — Un état est partagé avec les éléments qu'il contient. Dans leur menu +, ils le trouvent dans le groupe qui porte le nom du Container.