[TASK] EXT:form - explain initializeFormElement hook 34/54234/2
authorRalf Zimmermann <ralf.zimmermann@tritum.de>
Fri, 29 Sep 2017 11:32:16 +0000 (13:32 +0200)
committerChristian Kuhn <lolli@schwarzbu.ch>
Fri, 29 Sep 2017 13:54:38 +0000 (15:54 +0200)
Add more explanations about the initializeFormElement
hook into the docs.

Resolves: #82615
Releases: master, 8.7
Change-Id: I670625533f95b92a37f5536096eb2cc4211d33d9
Reviewed-on: https://review.typo3.org/54234
Tested-by: TYPO3com <no-reply@typo3.com>
Reviewed-by: Christian Kuhn <lolli@schwarzbu.ch>
Tested-by: Christian Kuhn <lolli@schwarzbu.ch>
typo3/sysext/form/Documentation/ApiReference/Index.rst

index e025dbd..747ff76 100644 (file)
@@ -1499,6 +1499,10 @@ initializeFormElement
 You can connect to the hook and initialize a form elements without defining a custom implementaion to access the element's ``initializeFormElement`` method.
 You only need a class which connects to this hook. Then detect the form element you wish to initialize.
 You can use this hook to prefill form element data for example from database tables.
 You can connect to the hook and initialize a form elements without defining a custom implementaion to access the element's ``initializeFormElement`` method.
 You only need a class which connects to this hook. Then detect the form element you wish to initialize.
 You can use this hook to prefill form element data for example from database tables.
+Note that this hook will be called **after** all properties from the prototype configuration are set in the form element but **before** the properties from
+the form definition are set in the form element.
+If you want to prefill form element data after the complete form element is configured you should use the :ref:`afterBuildingFinished<apireference-frontendrendering-runtimemanipulation-hooks-afterbuildingfinished>` hook.
+
 
 This hook is invoked by the methods ``TYPO3\CMS\Form\Domain\Model\FormElements\Page::createElement()`` and ``TYPO3\CMS\Form\Domain\Model\FormElements\Section::createElement()``.
 That means the hook will **not** be triggered for ``Pages``.
 
 This hook is invoked by the methods ``TYPO3\CMS\Form\Domain\Model\FormElements\Page::createElement()`` and ``TYPO3\CMS\Form\Domain\Model\FormElements\Section::createElement()``.
 That means the hook will **not** be triggered for ``Pages``.