New in Symfony 6.1: Customizable Collection Prototypes

Contributed by Michael Käfer in #45605.

The Symfony Form component is so stable and provides so many features, that we rarely add new features to it. However, in Symfony 6.1 we're improving its developer experience with a new feature to customize collection prototypes. The CollectionType form field is used to render a collection of other fields or forms. When the field allows to add new elements to the collection, it defines a prototype option. This contains the HTML code needed to render the new empty collection item (you've probably seen it as the data-prototype HTML attribute of the element that wraps the entire collection). The only drawback is that collection prototypes are not entirely configurable. You can set their initial values with the prototype-data option, but that's pretty much it. That's why in Symfony 6.1 we're adding a new option called prototype_options so you can configure collection prototypes. The options defined in prototype_options are passed to the form type specified in the entry_type option when creating its prototype. In practice, this allows to have different options depending on whether you are adding a new entry or editing an existing entry:

    $builder->add('names', CollectionType::class, [
'entry_type'   => TextType::class,

// this is used when editing items in the collection
'entry_options'  => [
    'attr' => ['class' => 'item-edit'],
    'help'  => 'You cannot edit existing names.',
    'disabled' => true,
],

// this is used when adding new items to the collection
'prototype_options'  => [
    'attr' => ['class' => 'item-add'],
    'help'  => 'Check out the rules to create new names',
    'help_html' => true,
],

]);

                Sponsor the Symfony project.

https://symfony.com/blog/new-in-symfony-6-1-customizable-collection-prototypes?utm_source=Symfony%20Blog%20Feed&utm_medium=feed

Creato 3y | 9 mag 2022, 08:20:08


Accedi per aggiungere un commento

Altri post in questo gruppo

A Week of Symfony #966 (June 30 – July 6, 2025)

This week, development on the upcoming Symfony 8.0 version continued with the removal of deprecated features and the marking of several classes as final. In addition, we published two new case studies

6 lug 2025, 08:10:15 | Symfony
Case study: Modernizing Audi France’s Digital Ecosystem with Symfony 6

At Wide, Micropole’s digital agency, they help leading brands modernize their digital infrastructures while ensuring scalability, security, and performance. When Audi France approached them to migrate

4 lug 2025, 09:40:14 | Symfony
Case study: A Long-Term Powerhouse Behind Vente-unique.com's E-Commerce Success (Zero Churn, All Wins!)

Vente-unique.com, a leading European online retailer of furniture and home decor, operates in 11 countries, powered by a team of 400 professionals and serving more than 3 million customers. From 15 ye

2 lug 2025, 09:10:03 | Symfony
A Week of Symfony #965 (June 23–29, 2025)

This week, Symfony 6.4.23, 7.2.8 and 7.3.1 maintenance versions were released. Meanwhile, the upcoming Symfony 7.4 version continued adding new features such as better controller helpers, more precisi

29 giu 2025, 09:10:15 | Symfony
Symfony 6.4.23 released

Symfony 6.4.23 has just been released. Read the Symfony upgrade guide to learn more about upgrading Symfony and use the SymfonyInsight upgrade reports to detect the code you will need to change in you

28 giu 2025, 09:50:15 | Symfony
Symfony 7.2.8 released

Symfony 7.2.8 has just been released. Read the Symfony upgrade guide to learn more about upgrading Symfony and use the SymfonyInsight upgrade reports to detect the code you will need to change in your

28 giu 2025, 09:50:15 | Symfony
Symfony 7.3.1 released

Symfony 7.3.1 has just been released. Read the Symfony upgrade guide to learn more about upgrading Symfony and use the SymfonyInsight upgrade reports to detect the code you will need to change in your

28 giu 2025, 09:50:14 | Symfony