links--comment.html.twig

Same filename in other branches
  1. 9 core/themes/olivero/templates/navigation/links--comment.html.twig
  2. 11.x core/themes/olivero/templates/navigation/links--comment.html.twig

Olivero's theme override for comment links.

Available variables:

  • attributes: Attributes for the UL containing the list of links.
  • links: Links to be output. Each link will have the following elements:

    • title: The link text.
    • href: The link URL. If omitted, the 'title' is shown as a plain text item in the links list. If 'href' is supplied, the entire link is passed to l() as its $options parameter.
    • attributes: (optional) HTML attributes for the anchor, or for the <span> tag if no 'href' is supplied.
  • heading: (optional) A heading to precede the links.
    • text: The heading text.
    • level: The heading level (e.g. 'h2', 'h3').
    • attributes: (optional) A keyed list of attributes for the heading.

    If the heading is a string, it will be used as the text of the heading and the level will default to 'h2'.

Headings should be used on navigation menus and any list of links that consistently appears on multiple pages. To make the heading invisible use the 'visually-hidden' CSS class. Do not use 'display:none', which removes it from screen readers and assistive technology. Headings allow screen reader and keyboard only users to navigate to or skip the links. See https://juicystudio.com/article/screen-readers-display-none.php and https://www.w3.org/TR/WCAG-TECHS/H42.html for more information.

See also

template_preprocess_links()

4 theme calls to links--comment.html.twig
CommentLazyBuilders::buildLinks in core/modules/comment/src/CommentLazyBuilders.php
Build the default links (reply, edit, delete …) for a comment.
CommentLazyBuilders::renderLinks in core/modules/comment/src/CommentLazyBuilders.php
#lazy_builder callback; builds a comment's links.
comment_test_comment_links_alter in core/modules/comment/tests/modules/comment_test/comment_test.module
Implements hook_comment_links_alter().
hook_comment_links_alter in core/modules/comment/comment.api.php
Alter the links of a comment.

File

core/themes/olivero/templates/navigation/links--comment.html.twig

View source
  1. {#
  2. /**
  3. * @file
  4. * Olivero's theme override for comment links.
  5. *
  6. * Available variables:
  7. * - attributes: Attributes for the UL containing the list of links.
  8. * - links: Links to be output.
  9. * Each link will have the following elements:
  10. * - title: The link text.
  11. * - href: The link URL. If omitted, the 'title' is shown as a plain text
  12. * item in the links list. If 'href' is supplied, the entire link is passed
  13. * to l() as its $options parameter.
  14. * - attributes: (optional) HTML attributes for the anchor, or for the <span>
  15. * tag if no 'href' is supplied.
  16. * - heading: (optional) A heading to precede the links.
  17. * - text: The heading text.
  18. * - level: The heading level (e.g. 'h2', 'h3').
  19. * - attributes: (optional) A keyed list of attributes for the heading.
  20. * If the heading is a string, it will be used as the text of the heading and
  21. * the level will default to 'h2'.
  22. *
  23. * Headings should be used on navigation menus and any list of links that
  24. * consistently appears on multiple pages. To make the heading invisible use
  25. * the 'visually-hidden' CSS class. Do not use 'display:none', which
  26. * removes it from screen readers and assistive technology. Headings allow
  27. * screen reader and keyboard only users to navigate to or skip the links.
  28. * See https://juicystudio.com/article/screen-readers-display-none.php and
  29. * https://www.w3.org/TR/WCAG-TECHS/H42.html for more information.
  30. *
  31. * @see template_preprocess_links()
  32. */
  33. #}
  34. {%
  35. set classes = [
  36. 'comment__links',
  37. ]
  38. %}
  39. {% if links -%}
  40. {%- if heading -%}
  41. {%- if heading.level -%}
  42. <{{ heading.level }}{{ heading.attributes }}>{{ heading.text }}</{{ heading.level }}>
  43. {%- else -%}
  44. <h2{{ heading.attributes }}>{{ heading.text }}</h2>
  45. {%- endif -%}
  46. {%- endif -%}
  47. <ul{{ attributes.addClass(classes) }}>
  48. {% for item in links %}
  49. <li{{ item.attributes.addClass('comment__links-item') }}>
  50. {%- if item.link -%}
  51. {{ item.link }}
  52. {%- elseif item.text_attributes -%}
  53. <span{{ item.text_attributes }}>{{ item.text }}</span>
  54. {%- else -%}
  55. {{ item.text }}
  56. {%- endif -%}
  57. </li>
  58. {% endfor %}
  59. </ul>
  60. {%- endif %}

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