8000 Merge branch '5.4' into 6.3 · symfony/symfony-docs@53a5549 · GitHub
[go: up one dir, main page]
Skip to content

Commit 53a5549

Browse files
javiereguiluzjaviereguiluz
committed
Merge branch '5.4' into 6.3
* 5.4: Update FormEvents Data and Form Data description
2 parents 5c8d774 + 402a073 commit 53a5549

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