docs

Author: dunglas

src/Turbo/CHANGELOG.md

@@ -2,7 +2,8 @@
 
 ## 2.2
 
--   The topics defined in the Broadcast attribute now support expression language when prefixed with `@=`.
+-   The topics defined in the `Broadcast` attribute now support expression language when prefixed with `@=`.
+-   The `Broadcast` attribute can now be repeated, this is convenient to render several Turbo Streams Twig templates for the same change
 
 ## 2.1
 

src/Turbo/Resources/doc/index.rst

@@ -620,6 +620,11 @@ The ``Broadcast`` attribute comes with a set of handy options:
    is derived from the FQCN of the entity and from its id
 -  ``template`` (``string``): Twig template to render (see above)
 
+The ``Broadcast`` attribute can be repeated. This is convenient to
+to render several templates associated with their own topics for the
+same change (e.g. the same data is rendered in different way in the
+list and in the detail pages).
+
 Options are transport-specific. When using Mercure, some extra options
 are supported:
 
@@ -638,7 +643,8 @@ Example::
 
     use Symfony\UX\Turbo\Attribute\Broadcast;
 
-    #[Broadcast(topics: ['@="books_by_author_" ~ entity.author?.id', 'books'], template: 'foo.stream.html.twig', private: true)]
+    #[Broadcast(topics: ['@="book_detail" ~ entity.id', 'books'], template: 'book_detail.stream.html.twig', private: true)]
+    #[Broadcast(topics: ['@="book_list" ~ entity.id', 'books'], template: 'book_list.stream.html.twig', private: true)]
     class Book
     {
         // ...

src/Turbo/Tests/app/Entity/Song.php

@@ -40,7 +40,7 @@ class Song
     public $title = '';
 
     /**
-     * @ORM\ManyToOne(targetEntity="App\Entity\Artist", inversedBy="songs")
+     * @ORM\ManyToOne(targetEntity=Artist::class, inversedBy="songs")
      *
      * @var Artist|null
      */