8000 Merge branch '6.3' into 6.4 · symfony/symfony-docs@baedc81 · GitHub
[go: up one dir, main page]

Skip to content

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

Appearance settings

Commit baedc81

Browse files
committed
Merge branch '6.3' into 6.4
* 6.3: Update FormEvents Data and Form Data description
2 parents e4698dc + 53a5549 commit baedc81

File tree

1 file changed

+40
-35
lines changed

1 file changed

+40
-35
lines changed

form/events.rst

Lines changed: 40 additions & 35 deletions
Original file line numberDiff line numberDiff line change
@@ -67,13 +67,14 @@ The method :method:`Form::setData() <Symfony\\Component\\Form\\Form::setData>`
6767
is locked since the event is dispatched from it and will throw an exception
6868
if called from a listener.
6969

70-
=============== ========
71-
Data Type Value
72-
=============== ========
73-
Model data ``null``
74-
Normalized data ``null``
75-
View data ``null``
76-
=============== ========
70+
==================== ======================================
71+
Data Type Value
72+
==================== ======================================
73+
Event data Model data injected into ``setData()``
74+
Form model data ``null``
75+
Form normalized data ``null``
76+
Form view data ``null``
77+
==================== ======================================
7778

7879
.. seealso::
7980

@@ -98,13 +99,14 @@ The ``FormEvents::POST_SET_DATA`` event is dispatched at the end of the
9899
method. This event can be used to modify a form depending on the populated data
99100
(adding or removing fields dynamically).
100101

101-
=============== ====================================================
102-
Data Type Value
103-
=============== ====================================================
104-
Model data Model data injected into ``setData()``
105-
Normalized data Model data transformed using a model transformer
106-
View data Normalized data transformed using a view transformer
107-
=============== ====================================================
102+
==================== ====================================================
103+
Data Type Value
104+
==================== ====================================================
105+
Event data Model data injected into ``setData()``
106+
Form model data Model data injected into ``setData()``
107+
Form normalized data Model data transformed using a model transformer
108+
Form view data Normalized data transformed using a view transformer
109+
==================== ====================================================
108110

109111
.. seealso::
110112

@@ -144,13 +146,14 @@ It can be used to:
144146
* Change data from the request, before submitting the data to the form;
145147
* Add or remove form fields, before submitting the data to the form.
146148

147-
=============== ========================================
148-
Data Type Value
149-
=============== ========================================
150-
Model data Same as in ``FormEvents::POST_SET_DATA``
151-
Normalized data Same as in ``FormEvents::POST_SET_DATA``
152-
View data Same as in ``FormEvents::POST_SET_DATA``
153-
=============== ========================================
149+
==================== ========================================
150+
Data Type Value
151+
==================== ========================================
152+
Event data Data from the request
153+
Form model data Same as in ``FormEvents::POST_SET_DATA``
154+
Form normalized data Same as in ``FormEvents::POST_SET_DATA``
155+
Form view data Same as in ``FormEvents::POST_SET_DATA``
156+
==================== ========================================
154157

155158
.. seealso::
156159

@@ -175,13 +178,14 @@ transforms back the normalized data to the model and view data.
175178

176179
It can be used to change data from the normalized representation of the data.
177180

178-
=============== ===================================================================================
179-
Data Type Value
180-
=============== ===================================================================================
181-
Model data Same as in ``FormEvents::POST_SET_DATA``
182-
Normalized data Data from the request reverse-transformed from the request using a view transformer
183-
View data Same as in ``FormEvents::POST_SET_DATA``
184-
=============== ===================================================================================
181+
==================== ===================================================================================
182+
Data Type Value
183+
==================== ===================================================================================
184+
Event data Data from the request reverse-transformed from the request using a view transformer
185+
Form model data Same as in ``FormEvents::POST_SET_DATA``
186+
Form normalized data Same as in ``FormEvents::POST_SET_DATA``
187+
Form view data Same as in ``FormEvents::POST_SET_DATA``
188+
==================== ===================================================================================
185189

186190
.. seealso::
187191

@@ -207,13 +211,14 @@ model and view data have been denormalized.
207211

208212
It can be used to fetch data after denormalization.
209213

210-
=============== =============================================================
211-
Data Type Value
212-
=============== =============================================================
213-
Model data Normalized data reverse-transformed using a model transformer
214-
Normalized data Same as in ``FormEvents::SUBMIT``
215-
View data Normalized data transformed using a view transformer
216-
=============== =============================================================
214+
==================== ===================================================================================
215+
Data Type Value
216+
==================== ===================================================================================
217+
Event data Normalized data transformed using a view transformer
218+
Form model data Normalized data reverse-transformed using a model transformer
219+
Form normalized data Data from the request reverse-transformed from the request using a view transformer
220+
Form view data Normalized data transformed using a view transformer
221+
==================== ===================================================================================
217222

218223
.. seealso::
219224

0 commit comments

Comments
 (0)
0