Skip to content

Commit fe71002

Browse files
committed
still proofreading, clarified a small thing - and added link/backlinnk to other reactive ui md doc
1 parent aa7ceed commit fe71002

File tree

2 files changed

+11
-1
lines changed

2 files changed

+11
-1
lines changed

doc/guides/ReactiveUI.md

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -23,7 +23,7 @@ Use the simplest one that fits:
2323
1. **Slot binding** (`data$: this.name$`) — wire a changing value into a child component
2424
2. **`dot()`** (`this.data$.dot('name')`) — track a property inside a changing object
2525
3. **`map()`** (`this.count$.map(n => n + ' items')`) — transform a value for display
26-
4. **`dynamic()`** (`this.dynamic(function(mode) { ... })`) — rebuild DOM when structure changes
26+
4. **`dynamic()`** (`this.dynamic(function(mode) { ... })`) — rebuild DOM when dependent values change and you need different elements
2727

2828
---
2929

@@ -415,6 +415,12 @@ why `this.add(function(prop) { ... })` behaves like `dynamic()`.
415415

416416
---
417417

418+
## See Also
419+
420+
- [Expressions vs dynamic()](dynamic.md) — covers how `expression` (model-level computed properties) differs from `this.dynamic()` (UI rendering), including evaluation semantics (lazy vs eager)
421+
422+
---
423+
418424
## Gotchas
419425

420426
1. **`data:` vs `data$:` is a one-character difference with big consequences**

doc/guides/dynamic.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -25,6 +25,10 @@ The implementation shows that `DynamicFunction` eagerly evaluates and always upd
2525

2626
Both use FOAM's reactive slot system under the hood, but serve different purposes - expressions for computed model data and `this.dynamic()` for reactive UI rendering. The `DynamicFunction` implementation ensures UI updates happen immediately when dependencies change, while expressions only compute when accessed.
2727

28+
## See Also
29+
30+
- [Reactive UI Patterns](ReactiveUI.md) — covers `dynamic()` alongside the other three reactive UI patterns (`slot.dot()`, `slot.map()`, and slot binding via `prop$:`), with a decision framework for choosing between them
31+
2832
Wiki pages you might want to explore:
2933
- [FOAM Framework Overview (kgrgreer/foam3)](/wiki/kgrgreer/foam3#1)
3034
- [Advanced Features and Extensions (kgrgreer/foam3)](/wiki/kgrgreer/foam3#7)

0 commit comments

Comments
 (0)