Code Coverage |
||||||||||
Classes and Traits |
Functions and Methods |
Lines |
||||||||
Total | |
0.00% |
0 / 1 |
|
0.00% |
0 / 2 |
CRAP | |
0.00% |
0 / 19 |
Dropbutton | |
0.00% |
0 / 1 |
|
0.00% |
0 / 2 |
20 | |
0.00% |
0 / 19 |
getInfo | |
0.00% |
0 / 1 |
2 | |
0.00% |
0 / 8 |
|||
preRenderDropbutton | |
0.00% |
0 / 1 |
12 | |
0.00% |
0 / 11 |
<?php | |
/** | |
* @file | |
* Contains \Drupal\Core\Render\Element\Dropbutton. | |
*/ | |
namespace Drupal\Core\Render\Element; | |
/** | |
* Provides a render element for a set of links rendered as a drop-down button. | |
* | |
* By default, this element sets #theme so that the 'links' theme hook is used | |
* for rendering, with suffixes so that themes can override this specifically | |
* without overriding all links theming. If the #subtype property is provided in | |
* your render array with value 'foo', #theme is set to links__dropbutton__foo; | |
* if not, it's links__dropbutton; both of these can be overridden by setting | |
* the #theme property in your render array. See template_preprocess_links() | |
* for documentation on the other properties used in theming; for instance, use | |
* element property #links to provide $variables['links'] for theming. | |
* | |
* Properties: | |
* - #links: An array of links to actions. See template_preprocess_links() for | |
* documentation the properties of links in this array. | |
* | |
* Usage Example: | |
* @code | |
* $form['actions']['extra_actions'] = array( | |
* '#type' => 'dropbutton', | |
* '#links' => array( | |
* 'simple_form' => array( | |
* 'title' => $this->t('Simple Form'), | |
* 'url' => Url::fromRoute('fapi_example.simple_form'), | |
* ), | |
* 'demo' => array( | |
* 'title' => $this->t('Build Demo'), | |
* 'url' => Url::fromRoute('fapi_example.build_demo'), | |
* ), | |
* ), | |
* ); | |
* @endcode | |
* | |
* @see \Drupal\Core\Render\Element\Operations | |
* | |
* @RenderElement("dropbutton") | |
*/ | |
class Dropbutton extends RenderElement { | |
/** | |
* {@inheritdoc} | |
*/ | |
public function getInfo() { | |
$class = get_class($this); | |
return array( | |
'#pre_render' => array( | |
array($class, 'preRenderDropbutton'), | |
), | |
'#theme' => 'links__dropbutton', | |
); | |
} | |
/** | |
* Pre-render callback: Attaches the dropbutton library and required markup. | |
*/ | |
public static function preRenderDropbutton($element) { | |
$element['#attached']['library'][] = 'core/drupal.dropbutton'; | |
$element['#attributes']['class'][] = 'dropbutton'; | |
if (!isset($element['#theme_wrappers'])) { | |
$element['#theme_wrappers'] = array(); | |
} | |
array_unshift($element['#theme_wrappers'], 'dropbutton_wrapper'); | |
// Enable targeted theming of specific dropbuttons (e.g., 'operations' or | |
// 'operations__node'). | |
if (isset($element['#subtype'])) { | |
$element['#theme'] .= '__' . $element['#subtype']; | |
} | |
return $element; | |
} | |
} |