40 lines
2.8 KiB
Markdown
40 lines
2.8 KiB
Markdown
# 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](database.md) 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](http-client.md) (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](yaml.md)).
|