On this page
Twig Templates
Last updated on
6 December 2018
It can be useful to have your block style suggest a Twig template as a Theme Suggestion. Doing this allow for much greater control over a block's markup. Keep in mind that these are just theme "suggestions" if the template is not registered or another suggestion has higher priority the template may not apply. The easiest thing is to prefix the template with block__.
Via the Yaml form
By adding a template key you may specify a template theme suggestion of your choosing for the block.
sample_block_style:
label: 'Sample Block Style'
template: block__my_custom_template
form:
field_use_template:
'#type': 'checkbox'
'#title': 'Select this to change the template'The block--my-custom-template.html.twig will now be the top suggestion when Drupal renders the block.
Via PHP method
For those looking for more power, a template can be suggested by overriding the BlockStyleBase::themeSuggestion() method.
/**
* {@inheritdoc}
*/
public function themeSuggestion(array $suggestions, array $variables) {
// First get any suggestions set by parent classes.
$suggestions = parent::themeSuggestion($suggestions, $variables);
// Get all the styles set for this plugin.
$styles = $this->getStylesFromVariables($variables);
// Check to see if the checkbox field was checked.
if (!empty($styles['field_use_template'])) {
// Set our custom twig template suggestion.
$suggestions[] = 'block__my_custom_template';
}
return $suggestions;
}Help improve this page
Page status: No known problems
You can:
You can:
- Log in, click Edit, and edit this page
- Log in, click Discuss, update the Page status value, and suggest an improvement
- Log in and create a Documentation issue with your suggestion