Skip to content

Commit d179592

Browse files
committed
[Doc] Mention that Live Components don't work in reusable bundles
1 parent a336938 commit d179592

File tree

1 file changed

+13
-0
lines changed

1 file changed

+13
-0
lines changed

src/LiveComponent/doc/index.rst

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3946,6 +3946,18 @@ Use the addCollectionItem method from the LiveCollectionTrait to dynamically add
39463946
]
39473947
]]);
39483948

3949+
Using Live Components in Reusable Bundles
3950+
-----------------------------------------
3951+
3952+
`Symfony Bundles`_ let you reuse features across many different Symfony
3953+
applications. However, you **cannot include live components in reusable
3954+
bundles** to make them available in any application that installs the bundle.
3955+
3956+
Some projects, such as the `Mezcalito UX File Manager bundle`_, provide live
3957+
components inside reusable bundles. Their implementation relies on unsupported
3958+
hacks that could break at any time, so Symfony does not recommend using this
3959+
approach.
3960+
39493961
Backward Compatibility promise
39503962
------------------------------
39513963

@@ -3982,3 +3994,4 @@ promise. However, any internal implementation in the JavaScript files
39823994
.. _`@symfony/ux-live-component npm package`: https://www.npmjs.com/package/@symfony/ux-live-component
39833995
.. _`Symfony TypeInfo`: https://symfony.com/doc/current/components/type_info.html
39843996
.. _`Symfony PropertyInfo`: https://symfony.com/doc/current/components/property_info.html
3997+
.. _`Mezcalito UX File Manager bundle`: https://github.com/Mezcalito/ux-filemanager

0 commit comments

Comments
 (0)