node.html.twig
Same filename in this branch
- 10 core/themes/olivero/templates/content/node.html.twig
- 10 core/themes/stable9/templates/content/node.html.twig
- 10 core/themes/claro/templates/classy/content/node.html.twig
- 10 core/themes/starterkit_theme/templates/content/node.html.twig
- 10 core/modules/node/templates/node.html.twig
- 10 core/modules/system/tests/themes/test_theme/templates/node.html.twig
- 10 core/modules/statistics/tests/themes/statistics_test_attached/node.html.twig
Same filename in other branches
- 9 core/profiles/demo_umami/themes/umami/templates/content/node.html.twig
- 9 core/themes/olivero/templates/content/node.html.twig
- 9 core/themes/stable9/templates/content/node.html.twig
- 9 core/themes/seven/templates/classy/content/node.html.twig
- 9 core/themes/claro/templates/classy/content/node.html.twig
- 9 core/themes/bartik/templates/node.html.twig
- 9 core/themes/stable/templates/content/node.html.twig
- 9 core/themes/starterkit_theme/templates/content/node.html.twig
- 9 core/themes/classy/templates/content/node.html.twig
- 9 core/modules/node/templates/node.html.twig
- 9 core/modules/system/tests/themes/test_theme/templates/node.html.twig
- 9 core/modules/statistics/tests/themes/statistics_test_attached/node.html.twig
- 8.9.x core/profiles/demo_umami/themes/umami/templates/content/node.html.twig
- 8.9.x core/themes/seven/templates/classy/content/node.html.twig
- 8.9.x core/themes/claro/templates/classy/content/node.html.twig
- 8.9.x core/themes/bartik/templates/node.html.twig
- 8.9.x core/themes/stable/templates/content/node.html.twig
- 8.9.x core/themes/classy/templates/content/node.html.twig
- 8.9.x core/modules/node/templates/node.html.twig
- 8.9.x core/modules/system/tests/themes/test_theme/templates/node.html.twig
- 8.9.x core/modules/statistics/tests/themes/statistics_test_attached/node.html.twig
- 11.x core/profiles/demo_umami/themes/umami/templates/content/node.html.twig
- 11.x core/themes/olivero/templates/content/node.html.twig
- 11.x core/themes/stable9/templates/content/node.html.twig
- 11.x core/themes/claro/templates/classy/content/node.html.twig
- 11.x core/themes/starterkit_theme/templates/content/node.html.twig
- 11.x core/modules/node/templates/node.html.twig
- 11.x core/modules/system/tests/themes/test_theme/templates/node.html.twig
- 11.x core/modules/statistics/tests/themes/statistics_test_attached/node.html.twig
Theme override to display a node.
Available variables:
- node: The node entity with limited access to object properties and methods.
Only method names starting with "get", "has", or "is" and a few common
methods such as "id", "label", and "bundle" are available. For example:
- node.getCreatedTime() will return the node creation timestamp.
- node.hasField('field_example') returns TRUE if the node bundle includes field_example. (This does not indicate the presence of a value in this field.)
- node.isPublished() will return whether the node is published or not.
Calling other methods, such as node.delete(), will result in an exception. See \Drupal\node\Entity\Node for a full list of public properties and methods for the node object.
- label: (optional) The title of the node.
- content: All node items. Use {{ content }} to print them all, or print a subset such as {{ content.field_example }}. Use {{ content|without('field_example') }} to temporarily suppress the printing of a given child element.
- author_picture: The node author user entity, rendered using the "compact" view mode.
- metadata: Metadata for this node.
- date: (optional) Themed creation date field.
- author_name: (optional) Themed author name field.
- url: Direct URL of the current node.
- display_submitted: Whether submission information should be displayed.
- attributes: HTML attributes for the containing element.
The attributes.class element may contain one or more of the following
classes:
- node: The current template type (also known as a "theming hook").
- node--type-[type]: The current node type. For example, if the node is an "Article" it would result in "node--type-article". Note that the machine name will often be in a short form of the human readable label.
- node--view-mode-[view_mode]: The View Mode of the node; for example, a teaser would result in: "node--view-mode-teaser", and full: "node--view-mode-full".
The following are controlled through the node publishing options.
- node--promoted: Appears on nodes promoted to the front page.
- node--sticky: Appears on nodes ordered above other non-sticky nodes in teaser listings.
- node--unpublished: Appears on unpublished nodes visible only to site admins.
- 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.
- author_attributes: Same as attributes, except applied to the author of the node 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.
- view_mode: View mode; for example, "teaser" or "full".
- teaser: Flag for the teaser state. Will be true if view_mode is 'teaser'.
- page: Flag for the full page state. Will be true if view_mode is 'full'.
See also
1 theme call to node.html.twig
- TwigDebugMarkupTest::testTwigDebugMarkup in core/
modules/ system/ tests/ src/ Functional/ Theme/ TwigDebugMarkupTest.php - Tests debug markup added to Twig template output.
File
-
core/
profiles/ demo_umami/ themes/ umami/ templates/ content/ node.html.twig
View source
- {#
- /**
- * @file
- * Theme override to display a node.
- *
- * Available variables:
- * - node: The node entity with limited access to object properties and methods.
- * Only method names starting with "get", "has", or "is" and a few common
- * methods such as "id", "label", and "bundle" are available. For example:
- * - node.getCreatedTime() will return the node creation timestamp.
- * - node.hasField('field_example') returns TRUE if the node bundle includes
- * field_example. (This does not indicate the presence of a value in this
- * field.)
- * - node.isPublished() will return whether the node is published or not.
- * Calling other methods, such as node.delete(), will result in an exception.
- * See \Drupal\node\Entity\Node for a full list of public properties and
- * methods for the node object.
- * - label: (optional) The title of the node.
- * - content: All node items. Use {{ content }} to print them all,
- * or print a subset such as {{ content.field_example }}. Use
- * {{ content|without('field_example') }} to temporarily suppress the printing
- * of a given child element.
- * - author_picture: The node author user entity, rendered using the "compact"
- * view mode.
- * - metadata: Metadata for this node.
- * - date: (optional) Themed creation date field.
- * - author_name: (optional) Themed author name field.
- * - url: Direct URL of the current node.
- * - display_submitted: Whether submission information should be displayed.
- * - attributes: HTML attributes for the containing element.
- * The attributes.class element may contain one or more of the following
- * classes:
- * - node: The current template type (also known as a "theming hook").
- * - node--type-[type]: The current node type. For example, if the node is an
- * "Article" it would result in "node--type-article". Note that the machine
- * name will often be in a short form of the human readable label.
- * - node--view-mode-[view_mode]: The View Mode of the node; for example, a
- * teaser would result in: "node--view-mode-teaser", and
- * full: "node--view-mode-full".
- * The following are controlled through the node publishing options.
- * - node--promoted: Appears on nodes promoted to the front page.
- * - node--sticky: Appears on nodes ordered above other non-sticky nodes in
- * teaser listings.
- * - node--unpublished: Appears on unpublished nodes visible only to site
- * admins.
- * - 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.
- * - author_attributes: Same as attributes, except applied to the author of
- * the node 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.
- * - view_mode: View mode; for example, "teaser" or "full".
- * - teaser: Flag for the teaser state. Will be true if view_mode is 'teaser'.
- * - page: Flag for the full page state. Will be true if view_mode is 'full'.
- *
- * @see template_preprocess_node()
- */
- #}
- {%
- set classes = [
- 'node',
- 'node--type-' ~ node.bundle|clean_class,
- node.isPromoted() ? 'node--promoted',
- node.isSticky() ? 'node--sticky',
- not node.isPublished() ? 'node--unpublished',
- view_mode ? 'node--view-mode-' ~ view_mode|clean_class,
- ]
- %}
- {% set created_date = node.getCreatedTime|format_date('umami_dates') %}
- {{ attach_library('umami/classy.node') }}
-
- <article{{ attributes.addClass(classes) }}>
-
- {{ title_prefix }}
- {% if label %}
- {% if page %}
- <header class="node__header">
- <h1 class="page-title">
- {{ label }}
- </h1>
- </header>
- {% else %}
- <h2{{ title_attributes }}>
- <a href="{{ url }}" rel="bookmark">{{ label }}</a>
- </h2>
- {% endif %}
- {% endif %}
- {{ title_suffix }}
-
- {% if display_submitted %}
- <footer class="node__meta">
- {{ author_picture }}
- <div{{ author_attributes.addClass('node__submitted') }}>
- {% trans %}<span class="by-author">by {{ author_name }}</span> {{ created_date }}{% endtrans %}
- {{ metadata }}
- </div>
- </footer>
- {% endif %}
-
- <div{{ content_attributes.addClass('node__content') }}>
- {{ content }}
- </div>
-
- </article>
Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.