diff --git a/core/lib/Drupal/Core/Plugin/PluginFormInterface.php b/core/lib/Drupal/Core/Plugin/PluginFormInterface.php index 0d86875..9fb3ad5 100644 --- a/core/lib/Drupal/Core/Plugin/PluginFormInterface.php +++ b/core/lib/Drupal/Core/Plugin/PluginFormInterface.php @@ -12,12 +12,15 @@ /** * Provides an interface for a plugin that contains a form. * - * Plugin forms are usually contained by other forms. In order to know where the - * plugin form is located in the parent form, let buildConfigurationForm() - * return a form element that has a #process callback and build the rest of the - * form in the callback. By the time the callback is executed, the element's - * #parents and #array_parents properties will have been set by the form API. - * For more documentation on those properties, see + * Plugin forms are usually contained in other forms. In order to know where the + * plugin form is located in the parent form, #parents and #array_parents must + * be known, but these are not available during the initial build phase. In + * order to have these properties available when building the plugin form's + * elements, let buildConfigurationForm() return a form element that has a + * #process callback and build the rest of the form in the callback. By the time + * the callback is executed, the element's #parents and #array_parents + * properties will have been set by the form API. For more documentation on + * #parents and #array_parents, see * https://api.drupal.org/api/drupal/developer!topics!forms_api_reference.html/8. * * @ingroup plugin_api