node.html.twig

Same filename in this branch
  1. 10 core/profiles/demo_umami/themes/umami/templates/content/node.html.twig
  2. 10 core/themes/olivero/templates/content/node.html.twig
  3. 10 core/themes/stable9/templates/content/node.html.twig
  4. 10 core/themes/claro/templates/classy/content/node.html.twig
  5. 10 core/themes/starterkit_theme/templates/content/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

Default theme implementation 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/modules/node/templates/node.html.twig

View source
  1. {#
  2. /**
  3. * @file
  4. * Default theme implementation 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. * @ingroup themeable
  63. */
  64. #}
  65. <article{{ attributes }}>
  66. {{ title_prefix }}
  67. {% if label and not page %}
  68. <h2{{ title_attributes }}>
  69. <a href="{{ url }}" rel="bookmark">{{ label }}</a>
  70. </h2>
  71. {% endif %}
  72. {{ title_suffix }}
  73. {% if display_submitted %}
  74. <footer>
  75. {{ author_picture }}
  76. <div{{ author_attributes }}>
  77. {% trans %}Submitted by {{ author_name }} on {{ date }}{% endtrans %}
  78. {{ metadata }}
  79. </div>
  80. </footer>
  81. {% endif %}
  82. <div{{ content_attributes }}>
  83. {{ content }}
  84. </div>
  85. </article>

Related topics


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