You are here

class FormElementHelper in Zircon Profile 8

Same name and namespace in other branches
  1. 8.0 core/lib/Drupal/Core/Form/FormElementHelper.php \Drupal\Core\Form\FormElementHelper

Provides common functionality for form elements.

Hierarchy

Expanded class hierarchy of FormElementHelper

2 files declare their use of FormElementHelper
FormElementHelperTest.php in core/tests/Drupal/Tests/Core/Form/FormElementHelperTest.php
Contains \Drupal\Tests\Core\Form\FormElementHelperTest.
FormErrorHandler.php in core/modules/inline_form_errors/src/FormErrorHandler.php
Contains \Drupal\inline_form_errors\FormErrorHandler.

File

core/lib/Drupal/Core/Form/FormElementHelper.php, line 15
Contains \Drupal\Core\Form\FormElementHelper.

Namespace

Drupal\Core\Form
View source
class FormElementHelper {

  /**
   * Retrieves a form element.
   *
   * @param string $name
   *   The name of the form element. If the #parents property of your form
   *   element is ['foo', 'bar', 'baz'] then the name is 'foo][bar][baz'.
   * @param array $form
   *   An associative array containing the structure of the form.
   *
   * @return array
   *   The form element.
   */
  public static function getElementByName($name, array $form) {
    foreach (Element::children($form) as $key) {
      if (implode('][', $form[$key]['#parents']) === $name) {
        return $form[$key];
      }
      elseif ($element = static::getElementByName($name, $form[$key])) {
        return $element;
      }
    }
    return [];
  }

  /**
   * Returns the title for the element.
   *
   * If the element has no title, this will recurse through all children of the
   * element until a title is found.
   *
   * @param array $element
   *   An associative array containing the properties of the form element.
   *
   * @return string
   *   The title of the element, or an empty string if none is found.
   */
  public static function getElementTitle(array $element) {
    $title = '';
    if (isset($element['#title'])) {
      $title = $element['#title'];
    }
    else {
      foreach (Element::children($element) as $key) {
        if ($title = static::getElementTitle($element[$key])) {
          break;
        }
      }
    }
    return $title;
  }

}

Members

Namesort descending Modifiers Type Description Overrides
FormElementHelper::getElementByName public static function Retrieves a form element.
FormElementHelper::getElementTitle public static function Returns the title for the element.