www.aleph1.co.uk Git - yaffs-website/blob - web/core/modules/comment/templates/comment.html.twig

   1 {#
   2 /**
   3  * @file
   4  * Default theme implementation for comments.
   5  *
   6  * Available variables:
   7  * - author: Comment author. Can be a link or plain text.
   8  * - content: The content-related items for the comment display. Use
   9  *   {{ content }} to print them all, or print a subset such as
  10  *   {{ content.field_example }}. Use the following code to temporarily suppress
  11  *   the printing of a given child element:
  12  *   @code
  13  *   {{ content|without('field_example') }}
  14  *   @endcode
  15  * - created: Formatted date and time for when the comment was created.
  16  *   Preprocess functions can reformat it by calling format_date() with the
  17  *   desired parameters on the 'comment.created' variable.
  18  * - changed: Formatted date and time for when the comment was last changed.
  19  *   Preprocess functions can reformat it by calling format_date() with the
  20  *   desired parameters on the 'comment.changed' variable.
  21  * - permalink: Comment permalink.
  22  * - submitted: Submission information created from author and created
  23  *   during template_preprocess_comment().
  24  * - user_picture: The comment author's profile picture.
  25  * - status: Comment status. Possible values are:
  26  *   unpublished, published, or preview.
  27  * - title: Comment title, linked to the comment.
  28  * - attributes: HTML attributes for the containing element.
  29  *   The attributes.class may contain one or more of the following classes:
  30  *   - comment: The current template type; for instance, 'theming hook'.
  31  *   - by-anonymous: Comment by an unregistered user.
  32  *   - by-{entity-type}-author: Comment by the author of the parent entity,
  33  *     eg. by-node-author.
  34  *   - preview: When previewing a new or edited comment.
  35  *   The following applies only to viewers who are registered users:
  36  *   - unpublished: An unpublished comment visible only to administrators.
  37  * - title_prefix: Additional output populated by modules, intended to be
  38  *   displayed in front of the main title tag that appears in the template.
  39  * - title_suffix: Additional output populated by modules, intended to be
  40  *   displayed after the main title tag that appears in the template.
  41  * - content_attributes: List of classes for the styling of the comment content.
  42  * - title_attributes: Same as attributes, except applied to the main title
  43  *   tag that appears in the template.
  44  * - threaded: A flag indicating whether the comments are threaded or not.
  45  *
  46  * These variables are provided to give context about the parent comment (if
  47  * any):
  48  * - parent_comment: Full parent comment entity (if any).
  49  * - parent_author: Equivalent to author for the parent comment.
  50  * - parent_created: Equivalent to created for the parent comment.
  51  * - parent_changed: Equivalent to changed for the parent comment.
  52  * - parent_title: Equivalent to title for the parent comment.
  53  * - parent_permalink: Equivalent to permalink for the parent comment.
  54  * - parent: A text string of parent comment submission information created from
  55  *   'parent_author' and 'parent_created' during template_preprocess_comment().
  56  *   This information is presented to help screen readers follow lengthy
  57  *   discussion threads. You can hide this from sighted users using the class
  58  *   visually-hidden.
  59  *
  60  * These two variables are provided for context:
  61  * - comment: Full comment object.
  62  * - entity: Entity the comments are attached to.
  63  *
  64  * @see template_preprocess_comment()
  65  *
  66  * @ingroup themeable
  67  */
  68 #}
  69
  70 <article{{ attributes.addClass('js-comment') }}>
  71   {#
  72     Hide the "new" indicator by default, let a piece of JavaScript ask the
  73     server which comments are new for the user. Rendering the final "new"
  74     indicator here would break the render cache.
  75   #}
  76   <mark class="hidden" data-comment-timestamp="{{ new_indicator_timestamp }}"></mark>
  77
  78   <footer>
  79     {{ user_picture }}
  80     <p>{{ submitted }}</p>
  81
  82     {#
  83       Indicate the semantic relationship between parent and child comments for
  84       accessibility. The list is difficult to navigate in a screen reader
  85       without this information.
  86     #}
  87     {% if parent %}
  88       <p class="visually-hidden">{{ parent }}</p>
  89     {% endif %}
  90
  91     {{ permalink }}
  92   </footer>
  93
  94   <div{{ content_attributes }}>
  95     {% if title %}
  96       {{ title_prefix }}
  97       <h3{{ title_attributes }}>{{ title }}</h3>
  98       {{ title_suffix }}
  99     {% endif %}
 100     {{ content }}
 101   </div>
 102 </article>