From d883d5659dab11da2ad39be9a380551f74682e38 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Simon=20Andr=C3=A9?= <smn.andre@gmail.com>
Date: Fri, 23 Aug 2024 00:39:01 +0200
Subject: [PATCH] [Templating] [Template] Render a block with the `#[Template]`
 attribute

---
 templates.rst | 25 +++++++++++++++++++++++++
 1 file changed, 25 insertions(+)

diff --git a/templates.rst b/templates.rst
index 795ac3a7ac3..1af3de56c5b 100644
--- a/templates.rst
+++ b/templates.rst
@@ -632,6 +632,31 @@ This might come handy when dealing with blocks in
 :ref:`templates inheritance <template_inheritance-layouts>` or when using
 `Turbo Streams`_.
 
+Similarly, you can use the ``#[Template]`` attribute on the controller to specify a block
+to render::
+
+    // src/Controller/ProductController.php
+    namespace App\Controller;
+
+    use Symfony\Bridge\Twig\Attribute\Template;
+    use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+    use Symfony\Component\HttpFoundation\Response;
+
+    class ProductController extends AbstractController
+    {
+        #[Template('product.html.twig', block: 'price_block')]
+        public function price(): array
+        {
+            return [
+                // ...
+            ];
+        }
+    }
+
+.. versionadded:: 7.2
+
+    The ``#[Template]`` attribute's ``block`` argument was introduced in Symfony 7.2.
+
 Rendering a Template in Services
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~