Movatterモバイル変換

[0]ホーム
URL:

Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

 Sign up
Appearance settings

Commit62bafad

Browse files
committed
feature#4246 [Reference] add description for thevalidation_groups option (xabbuh)
This PR was merged into the 2.3 branch.Discussion----------[Reference] add description for the `validation_groups` option| Q | A| ------------- | ---| Doc fix? | no| New docs? | yes (symfony/symfony#6528)| Applies to | all| Fixed tickets |#3358Commits-------c41b17c add description for the `validation_groups` option
2 parents9591a04 +c41b17c commit62bafad

File tree

2 files changed

+30
-0
lines changed

2 files changed

+30
-0
lines changed

‎book/forms.rst‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -504,6 +504,8 @@ fields were submitted. If you want to suppress validation, you can use the
504504
..index::
505505
single: Forms; Validation groups based on submitted data
506506

507+
.. _book-form-validation-groups:
508+
507509
Groups based on the Submitted Data
508510
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
509511

‎reference/forms/types/submit.rst‎

Lines changed: 28 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -17,6 +17,7 @@ A submit button.
1717
|| - `label`_|
1818
|| - `label_attr`_|
1919
|| - `translation_domain`_|
20+
|| - `validation_groups`_|
2021
+----------------------+----------------------------------------------------------------------+
2122
| Parent type|:doc:`button</reference/forms/types/button>`|
2223
+----------------------+----------------------------------------------------------------------+
@@ -45,6 +46,33 @@ Inherited Options
4546

4647
..include::/reference/forms/types/options/button_translation_domain.rst.inc
4748

49+
validation_groups
50+
~~~~~~~~~~~~~~~~~
51+
52+
**type**: ``array`` **default**: ``null``
53+
54+
When your form contains multiple submit buttons, you can change the validation
55+
group based on the button which was used to submit the form. Imagine a registration
56+
form wizard with buttons to go to the previous or the next step::
57+
58+
$form = $this->createFormBuilder($user)
59+
->add('previousStep', 'submit', array(
60+
'validation_groups' => false,
61+
))
62+
->add('nextStep', 'submit', array(
63+
'validation_groups' => array('Registration'),
64+
))
65+
->getForm();
66+
67+
The special ``false`` ensures that no validation is performed when the previous
68+
step button is clicked. When the second button is clicked, all constraints
69+
from the "Registration" are validated.
70+
71+
..seealso::
72+
73+
You can read more about this in:ref:`the Form chapter<book-form-validation-groups>`
74+
of the book.
75+
4876
Form Variables
4977
--------------
5078

0 commit comments

Comments
 (0)
[8]ページ先頭
©2009-2025 Movatter.jp