FR

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

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

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

  • 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

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.