winzik/docs/ide/fr/twig-preview.md

2.8 KiB

Aperçu Twig

Les templates Twig sont colorés (HTML avec les balises de Twig) et ont Code / Preview dans l'éditeur (et Code / Both / Preview dans l'éditeur rapide).

Ce que fait l'aperçu

  • Met la page en forme comme Symfony le ferait : {% extends %}, {% include %}, les blocs et parent() sont suivis dans les templates/ du projet (et les chemins @Bundle/).
  • Charge le CSS du projet : asset(), importmap(), les entrées Webpack Encore. Layout + CSS désactive cela pour voir le template seul.
  • Les appels de fonctions ({{ form(f) }}, {{ importmap('app') }}) ne sont pas imprimés comme texte ; path() / url() deviennent #.
  • C'est un aperçu du balisage : les variables n'ont pas de valeur et aucun PHP ne s'exécute. Pour la vraie page, choisissez une route (section suivante).

La vraie page : choisir une route

À côté de Fit / Desktop / Tablet / Phone, le sélecteur de route liste toutes les routes de l'application (nom, méthodes, chemin), lues dans les contrôleurs. Celles dont le contrôleur affiche CE template (render('…'), #[Template('…')]) viennent en premier, puis les autres routes GET, puis le reste. La première route qui affiche le template est choisie toute seule ; Static (no PHP) est l'aperçu du balisage décrit plus haut.

  • L'aperçu montre alors la page qu'envoie le site local en marche pour cette route : les données du contrôleur, le vrai CSS du site (feuilles liées, @import, url()) et ses images intégrés à la page (seule l'adresse du site est interrogée), scripts coupés sauf Scripts. Elle est redemandée à chaque enregistrement d'un fichier (taper seul ne change rien : le site lit les fichiers enregistrés).
  • Une route à paramètres ({id}, {slug}…) affiche un petit champ par paramètre. Pour une entité (Book $book converti depuis {id}), les premiers identifiants de sa table sont proposés, le premier est déjà rempli, quand la fenêtre Base de données a une connexion ouverte ; sinon, saisissez la valeur. Ce que vous tapez est retenu, ainsi que la route choisie, par template.
  • My session demande la page avec les cookies du client HTTP (une connexion faite là) ; sans cela la page est demandée en inconnu et aucun cookie n'est envoyé ni gardé.
  • Une 500 montre la page d'erreur de Symfony, telle qu'envoyée. Une redirection vers une page de connexion montre cette page, avec un bouton Use my session.
  • Le site n'est pas démarré : l'aperçu statique s'affiche en attendant, avec un bouton Start the site (Run > Serve the site) ; la page apparaît toute seule dès que le site répond.

Navigation

Ctrl+clic sur un nom de template ('base.html.twig', @Bundle/x.html.twig, /build/app.css) ouvre le fichier ; les clés de traduction mènent à translations/*.yaml (YAML).