[TASK] EXT:form - explain initializeFormElement hook

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>

diff --git a/typo3/sysext/form/Documentation/ApiReference/Index.rst b/typo3/sysext/form/Documentation/ApiReference/Index.rst
index e025dbd..747ff76 100644 (file)
--- a/typo3/sysext/form/Documentation/ApiReference/Index.rst
+++ b/typo3/sysext/form/Documentation/ApiReference/Index.rst
@@ -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.
+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``.