Remark on functional vs live components

phoenixframework · Aug 14, 2023 · ba9065c · ba9065c
1 parent 52d5304
commit ba9065c
Showing 1 changed file with 7 additions and 0 deletions.
diff --git a/lib/phoenix_live_component.ex b/lib/phoenix_live_component.ex
@@ -32,6 +32,13 @@ defmodule Phoenix.LiveComponent do
   component. All other attributes will be available as assigns inside the
   LiveComponent.
 
+  > #### Functional components or live components? {: .neutral}
+  >
+  > Generally speaking, you should prefer functional components over live
+  > components, as they are a simpler abstraction, with a smaller surface
+  > area. The use case for live components only arises when there is a need
+  > for encapsulating both event handling and additional state.
+
   ## Life-cycle
 
   ### Mount and update