From d7c8b2869078fa499daf045276cbee8ef0f88e58 Mon Sep 17 00:00:00 2001
From: Julian Pustkuchen <3110-Anybody@users.noreply.drupalcode.org>
Date: Sat, 19 Aug 2023 12:30:55 +0000
Subject: [PATCH] Issue #3359592: Better explain $view_mode parameter for
 drupal_field()

---
 docs/cheat-sheet.md | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/docs/cheat-sheet.md b/docs/cheat-sheet.md
index 6b5fefc..277ab70 100644
--- a/docs/cheat-sheet.md
+++ b/docs/cheat-sheet.md
@@ -69,9 +69,21 @@ See [rendering blocks with Twig Tweak](blocks.md#block-plugin) for details.
 
 ## Drupal Field
 ```twig
+{# Render field_image from node 1 in view_mode "full" (default). #}
 {{ drupal_field('field_image', 'node', 1) }}
+
+{# Render field_image from node 1 in view_mode "teaser". #}
 {{ drupal_field('field_image', 'node', 1, 'teaser') }}
+
+{# Render field_image from node 1 and instead of a view mode, provide an array of display
+options, which is documented here: https://api.drupal.org/api/drupal/core!lib!Drupal!Core!Entity!EntityViewBuilderInterface.php/function/EntityViewBuilderInterface%3A%3AviewField #}
 {{ drupal_field('field_image', 'node', 1, {type: 'image_url', settings: {image_style: 'large'}}) }}
+
+{# Render field_image from node 1 in view_mode "teaser" in English with access check disabled. #}
+{{ drupal_field('field_image', 'node', 1, 'teaser', 'en', FALSE) }}
+
+{# Render field_image from node 1 in view_mode "full" (default) with access check disabled (named argument). #}
+{{ drupal_field('field_image', 'node', 1, check_access=false) }}
 ```
 
 ## Drupal Menu