diff --git a/core/lib/Drupal/Core/Plugin/PluginFormInterface.php b/core/lib/Drupal/Core/Plugin/PluginFormInterface.php index bdebad7..e02dba6 100644 --- a/core/lib/Drupal/Core/Plugin/PluginFormInterface.php +++ b/core/lib/Drupal/Core/Plugin/PluginFormInterface.php @@ -22,17 +22,13 @@ * Plugin forms are embedded 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 + * to have these properties available when building the plugin form's + * elements, let this method 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. - * During validation and submission, the plugin form's elements' #parents and - * #array_parents properties have already been populated and can be used - * directly to find the location of the submitted form values in the form's - * state. * * @param array $form * An associative array containing the initial structure of the plugin form. @@ -51,8 +47,8 @@ public function buildConfigurationForm(array $form, FormStateInterface $form_sta * An associative array containing the structure of the plugin form as built * by static::buildConfigurationForm(). * @param \Drupal\Core\Form\FormStateInterface $form_state - * The current state of the complete form. The values submitted for the plugin form - * can be retrieved through + * The current state of the complete form. The values submitted for the + * plugin form can be retrieved through * @code * \Drupal\Component\Utility\NestedArray::getValue($form_state->getValues(), $form['#parents']); * @endcode @@ -66,8 +62,8 @@ public function validateConfigurationForm(array &$form, FormStateInterface $form * An associative array containing the structure of the plugin form as built * by static::buildConfigurationForm(). * @param \Drupal\Core\Form\FormStateInterface $form_state - * The current state of the complete form. The values submitted for the plugin form - * can be retrieved through + * The current state of the complete form. The values submitted for the + * plugin form can be retrieved through * @code * \Drupal\Component\Utility\NestedArray::getValue($form_state->getValues(), $form['#parents']); * @endcode