Code Coverage for /Users/ericduran/Sites/drupal/drupal/core/lib/Drupal/Core/Form/FormElementHelper.php

1	<?php
2
3	/**
4	* @file
5	* Contains \Drupal\Core\Form\FormElementHelper.
6	*/
7
8	namespace Drupal\Core\Form;
9
10	use Drupal\Core\Render\Element;
11
12	/**
13	* Provides common functionality for form elements.
14	*/
15	class FormElementHelper {
16
17	/**
18	* Retrieves a form element.
19	*
20	* @param string $name
21	* The name of the form element. If the #parents property of your form
22	* element is ['foo', 'bar', 'baz'] then the name is 'foo][bar][baz'.
23	* @param array $form
24	* An associative array containing the structure of the form.
25	*
26	* @return array
27	* The form element.
28	*/
29	public static function getElementByName($name, array $form) {
30	foreach (Element::children($form) as $key) {
31	if (implode('][', $form[$key]['#parents']) === $name) {
32	return $form[$key];
33	}
34	elseif ($element = static::getElementByName($name, $form[$key])) {
35	return $element;
36	}
37	}
38	return [];
39	}
40
41	/**
42	* Returns the title for the element.
43	*
44	* If the element has no title, this will recurse through all children of the
45	* element until a title is found.
46	*
47	* @param array $element
48	* An associative array containing the properties of the form element.
49	*
50	* @return string
51	* The title of the element, or an empty string if none is found.
52	*/
53	public static function getElementTitle(array $element) {
54	$title = '';
55	if (isset($element['#title'])) {
56	$title = $element['#title'];
57	}
58	else {
59	foreach (Element::children($element) as $key) {
60	if ($title = static::getElementTitle($element[$key])) {
61	break;
62	}
63	}
64	}
65	return $title;
66	}
67
68	}