averello/swift-composable-architecture-mirror
1
0
Fork 0
mirror of https://github.com/pointfreeco/swift-composable-architecture.git synced 2025-12-24 12:14:25 +01:00
Code Issues Packages Projects Releases Wiki Activity

Add important note about delegate actions. (#3135)

Browse Source
This commit is contained in:
Brandon Williams
2024-06-04 08:37:21 -05:00
committed by GitHub
parent 7cbde3b07f
commit 1c133ced26
1 changed files with 9 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

9
Sources/ComposableArchitecture/Documentation.docc/Tutorials/MeetTheComposableArchitecture/02-Navigation/01-YourFirstPresentation/02-01-YourFirstPresentation.tutorial
View File

@@ -256,6 +256,15 @@
@Code(name: "AddContactFeature.swift", file: 02-01-04-code-0000.swift, previousFile: 02-01-04-code-0000-previous.swift)
}
> Important: Delegate actions are the most general way of communicating from the child domain
back to the parent, but there are other techniques. We could have also utilized the
[`@Shared`](<doc:Shared>) property wrapper for the collection of sync ups, which would allow
the `AddContactFeature` to insert a new contact directly into the parent collection without
any further steps. This can be powerful, but we will use delegate actions for this tutorial.
To read more about `@Shared` see the <doc:SharingState> article, and see the
<doc:BuildingSyncUps> tutorial where we see this technique, in particular in
<doc:EditingAndDeletingSyncUp#Deleting-the-sync-up> section.
@Step {
Handle the new case in the reducer, but we should never actually perform any logic in this
case. Only the parent should listen for `delegate` actions and respond accordingly.