winzik/docs/ide/fr/symfony-forms.md
David Nurdin e796498ed1 IDE: Symfony Forms window, a visual form builder for FormTypes
- The Symfony Forms window (projects requiring symfony/form): the project's FormTypes, New form type, twig.yaml's form themes.
- The form builder: fields added from Symfony's types and the project's own (sub-forms), reordered by dragging, removed; each
  type's options edited by kind (label, required, help, attr / row_attr, validator constraints with their options, choices,
  EntityType class / query_builder, CollectionType entry_type / allow_add / allow_delete / by_reference / prototype, RepeatedType,
  date widgets / html5...), configureOptions, form events (listener methods made), data transformers (classes made).
- Add fields from the class: an entity's / DTO's properties with suggested types (Doctrine columns, relations -> EntityType /
  CollectionType, enums, PHP types, names).
- Preview without PHP: the HTML of form_div_layout, form_table_layout, bootstrap_5_layout, tailwind_2_layout with Symfony's ids /
  names, sub-forms, collection prototypes and "Show errors", in the project's base.html.twig with its CSS.
- Round trip: FormTypes read back with php-parser (add() chains, option arrays, conditionals / closures kept locked) and written
  by text edits at php-parser's positions: only what changed, the rest byte for byte; new FormTypes as maker-bundle writes them.
- Generate the controller action (createForm, handleRequest, persist / flush or DTO, flash, redirect) into an existing or new
  controller and its Twig template; every change shown as a diff first.
- ide/src/Symfony/Form*.php + Imports.php (forms.* commands), ide/ui/js/symfony-forms*.js, css/symfony-forms.css; 14 languages.
- Tests: SymfonyFormsTest (exact generated code, parsing, byte-identical round trips, edits, suggestions, generators),
  symfony-forms-preview.test.mjs (HTML per theme), games/ide/tools/ui-forms-check.sh (screenshots); checked on a Symfony 8.1
  project (debug:form, GET renders the fields, invalid POST 422 with the message, valid POST 303 + flash).
- Docs: docs/ide/symfony-forms.md (+ fr), docs/ide.md.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Claude-Session: https://claude.ai/code/session_01JkYTqsvYu6AYr9yQ3Q4Nt6
2026-11-16 00:35:45 +01:00

48 lines
3.2 KiB
Markdown

# Formulaires Symfony
La fenêtre **Symfony Forms** (barre d'outils de droite, ou Tools > Symfony Forms) liste les FormTypes du projet
(`src/Form/*Type.php`) et ses thèmes de formulaire. Elle apparaît dans un projet dont le `composer.json` demande `symfony/form` (ou
qui a `src/Form/`). Cliquez sur un type de formulaire, ou utilisez **Open the Form Builder on This File** sur le FormType ouvert dans
l'éditeur, ou **Nouveau type de formulaire…** : le **constructeur de formulaire** s'ouvre par-dessus l'atelier.
![Le constructeur de formulaire : les champs, les options d'un champ, l'aperçu](../images/symfony-forms.png)
## Champs
- **+** ajoute un champ : les types de Symfony groupés comme dans sa référence et les types de formulaire du projet (sous-formulaires).
Glissez un champ (ou ↑ ↓) pour le déplacer, la corbeille le supprime.
- **Ajouter des champs depuis la classe…** lit la classe des données (entité ou DTO) et propose ses propriétés avec le type suggéré :
mapping Doctrine (`text` → TextareaType, `decimal` → MoneyType pour un prix, dates, `enumType` → EnumType, relations → EntityType
ou CollectionType), type PHP (bool → CheckboxType, enum → EnumType) et nom (email, password, url…).
## Options
La colonne du milieu modifie le champ choisi : nom, type, puis les options de ce type selon leur nature (label, required, help, attr,
**contraintes** du validateur avec leurs options, choices, class et query_builder d'un EntityType, entry_type / allow_add /
allow_delete / by_reference / prototype d'une CollectionType, widget / input / html5 des dates…). Les autres options sont
modifiées en PHP. **Formulaire** : les options de configureOptions (data_class, validation_groups, csrf…). **Événements** : la méthode
d'écoute est créée dans la classe. **Transformateurs de données** : leur classe est créée dans `src/` si elle n'existe pas.
## Aperçu
La colonne de droite montre le formulaire tel que le thème choisi le rend, sans PHP : thème par défaut de Symfony, tableau, Bootstrap 5
ou Tailwind 2, dans la page du projet (`base.html.twig` et ses CSS). **Afficher les erreurs** montre les états d'erreur.
![L'aperçu avec Bootstrap 5 et les erreurs](../images/symfony-forms-errors.png)
## Enregistrer et générer
- **Enregistrer…** montre un diff puis écrit le FormType : seul ce qui a changé est écrit, à sa place ; le reste du fichier est
gardé tel quel. Ce que le constructeur ne sait pas modifier (un `add()` dans un `if`, une closure…) est verrouillé.
![Enregistrer : seul ce qui a changé est écrit](../images/symfony-forms-diff.png)
- **Générer le contrôleur et le template…** crée l'action qui affiche et traite le formulaire et son template Twig, en diff.
- **Changer les thèmes…** règle `form_themes` dans `config/packages/twig.yaml`.
![Générer : le contrôleur et son template, en diff](../images/symfony-forms-generate.png)
## Limites
- Un champ déplacé vers une autre instruction `$builder` reste dans la sienne (l'ordre est appliqué dans chaque chaîne d'add()).
- Retirer un événement ou un transformateur laisse sa méthode ou sa classe en place.
- L'aperçu connaît les thèmes de Symfony, pas les blocs de thème propres au projet ; les choix d'un EntityType sont des exemples.