summaryrefslogtreecommitdiffstats
path: root/core/modules/media/templates/media.html.twig
diff options
context:
space:
mode:
Diffstat (limited to 'core/modules/media/templates/media.html.twig')
-rw-r--r--core/modules/media/templates/media.html.twig51
1 files changed, 51 insertions, 0 deletions
diff --git a/core/modules/media/templates/media.html.twig b/core/modules/media/templates/media.html.twig
new file mode 100644
index 0000000..bff3545
--- /dev/null
+++ b/core/modules/media/templates/media.html.twig
@@ -0,0 +1,51 @@
+{#
+/**
+ * @file
+ * Default theme implementation to present a media item.
+ *
+ * Available variables:
+ * - media: The media item, 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:
+ * - entity.getEntityTypeId() will return the entity type ID.
+ * - entity.hasField('field_example') returns TRUE if the entity includes
+ * field_example. (This does not indicate the presence of a value in this
+ * field.)
+ * Calling other methods, such as entity.delete(), will result in
+ * an exception.
+ * See \Drupal\Core\Entity\EntityInterface for a full list of methods.
+ * - name: Name of the media item.
+ * - content: Media content.
+ * - 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".
+ * - attributes: HTML attributes for the containing element.
+ * - title_attributes: Same as attributes, except applied to the main title
+ * tag that appears in the template.
+ *
+ * @see template_preprocess_media()
+ *
+ * @todo Make the HTML wrapper tag for media items more semantically correct.
+ * https://www.drupal.org/node/2878115
+ *
+ * @ingroup themeable
+ */
+#}
+<article{{ attributes }}>
+ {#
+ In the 'full' view mode the entity label is assumed to be displayed as the
+ page title, so we do not display it here.
+ #}
+ {{ title_prefix }}
+ {% if label and view_mode != 'full' %}
+ <h2{{ title_attributes }}>
+ {{ label }}
+ </h2>
+ {% endif %}
+ {{ title_suffix }}
+
+ {{ content }}
+</article>