block.html.twig in Drupal 9

Default theme implementation to display a block.

Available variables:

• plugin_id: The ID of the block implementation.
• label: The configured label of the block if visible.
• configuration: A list of the block's configuration values.
  • label: The configured label for the block.
  • label_display: The display settings for the label.
  • provider: The module or other provider that provided this block plugin.
  • Block plugin specific settings will also be stored here.
• content: The content of this block.
• attributes: array of HTML attributes populated by modules, intended to be added to the main container tag of this template.
  • id: A valid HTML ID and guaranteed unique.
• title_attributes: Same as attributes, except applied to the main title tag that appears in the template.
• content_attributes: Same as attributes, except applied to the main content tag that appears in the template.
• title_prefix: Additional output populated by modules, intended to be displayed in front of the main title tag that appears in the template.
• title_suffix: Additional output populated by modules, intended to be displayed after the main title tag that appears in the template.

See also

template_preprocess_block()

9 theme calls to block.html.twig

BlockComponentRenderArray::onBuildRender in core/modules/layout_builder/src/EventSubscriber/BlockComponentRenderArray.php

Builds render arrays for block plugins and sets it on the event.

BlockComponentRenderArrayTest::testOnBuildRender in core/modules/layout_builder/tests/src/Unit/BlockComponentRenderArrayTest.php

@covers ::onBuildRender

BlockComponentRenderArrayTest::testOnBuildRenderInPreview in core/modules/layout_builder/tests/src/Unit/BlockComponentRenderArrayTest.php

@covers ::onBuildRender

BlockComponentRenderArrayTest::testOnBuildRenderInPreviewEmptyBuild in core/modules/layout_builder/tests/src/Unit/BlockComponentRenderArrayTest.php

@covers ::onBuildRender

BlockComponentRenderArrayTest::testOnBuildRenderWithoutPreviewFallbackString in core/modules/layout_builder/tests/src/Unit/BlockComponentRenderArrayTest.php

@covers ::onBuildRender

... See full list

File

core/themes/bartik/templates/block.html.twig

{#
/**
 * @file
 * Default theme implementation to display a block.
 *
 * Available variables:
 * - plugin_id: The ID of the block implementation.
 * - label: The configured label of the block if visible.
 * - configuration: A list of the block's configuration values.
 *   - label: The configured label for the block.
 *   - label_display: The display settings for the label.
 *   - provider: The module or other provider that provided this block plugin.
 *   - Block plugin specific settings will also be stored here.
 * - content: The content of this block.
 * - attributes: array of HTML attributes populated by modules, intended to
 *   be added to the main container tag of this template.
 *   - id: A valid HTML ID and guaranteed unique.
 * - title_attributes: Same as attributes, except applied to the main title
 *   tag that appears in the template.
 * - content_attributes: Same as attributes, except applied to the main content
 *   tag that appears in the template.
 * - title_prefix: Additional output populated by modules, intended to be
 *   displayed in front of the main title tag that appears in the template.
 * - title_suffix: Additional output populated by modules, intended to be
 *   displayed after the main title tag that appears in the template.
 *
 * @see template_preprocess_block()
 *
 * @ingroup themeable
 */
#}
{%
  set classes = [
    'block',
    'block-' ~ configuration.provider|clean_class,
    'block-' ~ plugin_id|clean_class,
  ]
%}
<div{{ attributes.addClass(classes) }}>
  {{ title_prefix }}
  {% if label %}
    <h2{{ title_attributes }}>{{ label }}</h2>
  {% endif %}
  {{ title_suffix }}
  {% block content %}
    <div{{ content_attributes.addClass('content') }}>
      {{ content }}
    </div>
  {% endblock %}
</div>

Related topics

Theme system overview

Functions and templates for the user interface that themes can override.