node.html.twig

Same filename in this branch
  1. 10 core/themes/olivero/templates/content/node.html.twig
  2. 10 core/themes/stable9/templates/content/node.html.twig
  3. 10 core/themes/claro/templates/classy/content/node.html.twig
  4. 10 core/themes/starterkit_theme/templates/content/node.html.twig
  5. 10 core/modules/node/templates/node.html.twig
  6. 10 core/modules/system/tests/themes/test_theme/templates/node.html.twig
  7. 10 core/modules/statistics/tests/themes/statistics_test_attached/node.html.twig
Same filename in other branches
  1. 9 core/profiles/demo_umami/themes/umami/templates/content/node.html.twig
  2. 9 core/themes/olivero/templates/content/node.html.twig
  3. 9 core/themes/stable9/templates/content/node.html.twig
  4. 9 core/themes/seven/templates/classy/content/node.html.twig
  5. 9 core/themes/claro/templates/classy/content/node.html.twig
  6. 9 core/themes/bartik/templates/node.html.twig
  7. 9 core/themes/stable/templates/content/node.html.twig
  8. 9 core/themes/starterkit_theme/templates/content/node.html.twig
  9. 9 core/themes/classy/templates/content/node.html.twig
  10. 9 core/modules/node/templates/node.html.twig
  11. 9 core/modules/system/tests/themes/test_theme/templates/node.html.twig
  12. 9 core/modules/statistics/tests/themes/statistics_test_attached/node.html.twig
  13. 8.9.x core/profiles/demo_umami/themes/umami/templates/content/node.html.twig
  14. 8.9.x core/themes/seven/templates/classy/content/node.html.twig
  15. 8.9.x core/themes/claro/templates/classy/content/node.html.twig
  16. 8.9.x core/themes/bartik/templates/node.html.twig
  17. 8.9.x core/themes/stable/templates/content/node.html.twig
  18. 8.9.x core/themes/classy/templates/content/node.html.twig
  19. 8.9.x core/modules/node/templates/node.html.twig
  20. 8.9.x core/modules/system/tests/themes/test_theme/templates/node.html.twig
  21. 8.9.x core/modules/statistics/tests/themes/statistics_test_attached/node.html.twig
  22. 11.x core/profiles/demo_umami/themes/umami/templates/content/node.html.twig
  23. 11.x core/themes/olivero/templates/content/node.html.twig
  24. 11.x core/themes/stable9/templates/content/node.html.twig
  25. 11.x core/themes/claro/templates/classy/content/node.html.twig
  26. 11.x core/themes/starterkit_theme/templates/content/node.html.twig
  27. 11.x core/modules/node/templates/node.html.twig
  28. 11.x core/modules/system/tests/themes/test_theme/templates/node.html.twig
  29. 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

template_preprocess_node()

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
  1. {#
  2. /**
  3. * @file
  4. * Theme override to display a node.
  5. *
  6. * Available variables:
  7. * - node: The node entity with limited access to object properties and methods.
  8. * Only method names starting with "get", "has", or "is" and a few common
  9. * methods such as "id", "label", and "bundle" are available. For example:
  10. * - node.getCreatedTime() will return the node creation timestamp.
  11. * - node.hasField('field_example') returns TRUE if the node bundle includes
  12. * field_example. (This does not indicate the presence of a value in this
  13. * field.)
  14. * - node.isPublished() will return whether the node is published or not.
  15. * Calling other methods, such as node.delete(), will result in an exception.
  16. * See \Drupal\node\Entity\Node for a full list of public properties and
  17. * methods for the node object.
  18. * - label: (optional) The title of the node.
  19. * - content: All node items. Use {{ content }} to print them all,
  20. * or print a subset such as {{ content.field_example }}. Use
  21. * {{ content|without('field_example') }} to temporarily suppress the printing
  22. * of a given child element.
  23. * - author_picture: The node author user entity, rendered using the "compact"
  24. * view mode.
  25. * - metadata: Metadata for this node.
  26. * - date: (optional) Themed creation date field.
  27. * - author_name: (optional) Themed author name field.
  28. * - url: Direct URL of the current node.
  29. * - display_submitted: Whether submission information should be displayed.
  30. * - attributes: HTML attributes for the containing element.
  31. * The attributes.class element may contain one or more of the following
  32. * classes:
  33. * - node: The current template type (also known as a "theming hook").
  34. * - node--type-[type]: The current node type. For example, if the node is an
  35. * "Article" it would result in "node--type-article". Note that the machine
  36. * name will often be in a short form of the human readable label.
  37. * - node--view-mode-[view_mode]: The View Mode of the node; for example, a
  38. * teaser would result in: "node--view-mode-teaser", and
  39. * full: "node--view-mode-full".
  40. * The following are controlled through the node publishing options.
  41. * - node--promoted: Appears on nodes promoted to the front page.
  42. * - node--sticky: Appears on nodes ordered above other non-sticky nodes in
  43. * teaser listings.
  44. * - node--unpublished: Appears on unpublished nodes visible only to site
  45. * admins.
  46. * - title_attributes: Same as attributes, except applied to the main title
  47. * tag that appears in the template.
  48. * - content_attributes: Same as attributes, except applied to the main
  49. * content tag that appears in the template.
  50. * - author_attributes: Same as attributes, except applied to the author of
  51. * the node tag that appears in the template.
  52. * - title_prefix: Additional output populated by modules, intended to be
  53. * displayed in front of the main title tag that appears in the template.
  54. * - title_suffix: Additional output populated by modules, intended to be
  55. * displayed after the main title tag that appears in the template.
  56. * - view_mode: View mode; for example, "teaser" or "full".
  57. * - teaser: Flag for the teaser state. Will be true if view_mode is 'teaser'.
  58. * - page: Flag for the full page state. Will be true if view_mode is 'full'.
  59. *
  60. * @see template_preprocess_node()
  61. */
  62. #}
  63. {%
  64. set classes = [
  65. 'node',
  66. 'node--type-' ~ node.bundle|clean_class,
  67. node.isPromoted() ? 'node--promoted',
  68. node.isSticky() ? 'node--sticky',
  69. not node.isPublished() ? 'node--unpublished',
  70. view_mode ? 'node--view-mode-' ~ view_mode|clean_class,
  71. ]
  72. %}
  73. {% set created_date = node.getCreatedTime|format_date('umami_dates') %}
  74. {{ attach_library('umami/classy.node') }}
  75. <article{{ attributes.addClass(classes) }}>
  76. {{ title_prefix }}
  77. {% if label %}
  78. {% if page %}
  79. <header class="node__header">
  80. <h1 class="page-title">
  81. {{ label }}
  82. </h1>
  83. </header>
  84. {% else %}
  85. <h2{{ title_attributes }}>
  86. <a href="{{ url }}" rel="bookmark">{{ label }}</a>
  87. </h2>
  88. {% endif %}
  89. {% endif %}
  90. {{ title_suffix }}
  91. {% if display_submitted %}
  92. <footer class="node__meta">
  93. {{ author_picture }}
  94. <div{{ author_attributes.addClass('node__submitted') }}>
  95. {% trans %}<span class="by-author">by {{ author_name }}</span> {{ created_date }}{% endtrans %}
  96. {{ metadata }}
  97. </div>
  98. </footer>
  99. {% endif %}
  100. <div{{ content_attributes.addClass('node__content') }}>
  101. {{ content }}
  102. </div>
  103. </article>

Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.