errata1am/signalforms: when-Callback für Schema-Funktionen (#97)

angular/angular@df54e6a

Author: fmalcher

material/errata-1a/README.md

@@ -1,7 +1,7 @@
 ---
 title: "Errata zur 1. Auflage (2026)"
 published: 2026-03-13
-lastModified: 2026-05-09
+lastModified: 2026-05-15
 hidden: true
 ---
 
@@ -23,7 +23,7 @@ Er ist die moderne und ergonomische Alternative zum etablierten Decorator `@Inje
 Der Aufruf kann also direkt ersetzt werden:
 
 ```ts
-// VORHER
+// VORHER (im Buch abgedruckt)
 import { Injectable } from '@angular/core';
 
 @Injectable({
@@ -96,3 +96,25 @@ Die abgedruckte Variante mit `useFactory` ist dennoch nicht falsch und kann weit
 ```
 
 
+
+## 25.5.8 Logik für Schema-Funktionen
+
+Im Theoriekapitel zu Signal Forms erläutern wir die Funktionen `disabled()`, `hidden()` und `readonly()`.
+Dabei erklären wir auch, dass im zweiten Argument eine Logikfunktion übergeben werden kann.
+
+Die Signatur der Schemafunktionen wurde kurz vor dem finalen Release von Angular 22 noch einmal angepasst.
+Die Logik wird nun in der Option `when` notiert.
+Diese Änderung ist sinnvoll, weil andere Schemafunktionen ebenfalls ein `when`-Callback unterstützen.
+Im Buch ist allerdings noch die alte Schnittstelle abgedruckt.
+
+```ts
+// ❌ VORHER (im Buch abgedruckt)
+disabled(path.password, (ctx) => !ctx.valueOf(path.username));
+disabled(path.password, (ctx) => !ctx.valueOf(path.username) ? 'Username is empty.' : false);
+
+// ✅ NACHHER
+disabled(path.password, { when: (ctx) => !ctx.valueOf(path.username) });
+disabled(path.password, {
+  when: (ctx) => !ctx.valueOf(path.username) ? 'Username is empty.' : false
+});
+```

material/signal-forms/README.md

@@ -1,14 +1,14 @@
 ---
 title: 'Updates zu Signal Forms'
 published: 2026-05-06
-lastModified: 2026-05-06
+lastModified: 2026-05-15
 hidden: true
 ---
 
 Im Angular-Buch behandeln wir ausführlich Angulars neuesten Ansatz zur Formularverarbeitung: Signal Forms.
 Dabei berichten wir über experimentelle Schnittstellen.
 
-**Die gute Nachricht: Signal Forms wurden mit Angular 22 als *stable* markiert. Es gibt gegenüber dem gedruckten Stand im Buch keine nennenswerten Änderungen.**
+**Die gute Nachricht: Signal Forms wurden mit Angular 22 als *stable* markiert. Es gibt gegenüber dem gedruckten Stand im Buch keine gravierenden Änderungen.**
 
 Signal Forms können also heute produktiv eingesetzt werden, um Formulare in Angular zu verarbeiten.
 Wir empfehlen, neue Formulare sofort mit Signal Forms zu entwickeln.
@@ -19,4 +19,29 @@ In unserer englischsprachigen Artikelserie zu Signal Forms gehen wir auch auf As
 - [Part 1: Getting Started with Signal Forms](/blog/2025-10-signal-forms-part1)
 - [Part 2: Advanced Validation and Schema Patterns](/blog/2025-10-signal-forms-part2)
 - [Part 3: Child Forms, Custom UI Controls and SignalFormsConfig](/blog/2025-10-signal-forms-part3)
-- [Part 4: Metadata and Accessibility Handling](/blog/2025-12-signal-forms-part4)
+- [Part 4: Metadata and Accessibility Handling](/blog/2025-12-signal-forms-part4)
+
+**In diesem Artikel sammeln wir dennoch einige kleinere Aspekte, die sich nach dem Release des Angular-Buchs geändert haben.**
+
+
+## 25.5.8 Logik für Schema-Funktionen mit `when`
+
+Im Buch erläutern wir die Funktionen `disabled()`, `hidden()` und `readonly()`.
+Dabei erklären wir auch, dass im zweiten Argument eine Logikfunktion übergeben werden kann.
+
+Die Signatur der Schemafunktionen wurde kurz vor dem finalen Release von Angular 22 noch einmal angepasst.
+Die Logik wird nun in der Option `when` notiert.
+Diese Änderung ist sinnvoll, weil andere Schemafunktionen ebenfalls ein `when`-Callback unterstützen.
+Im Buch ist allerdings noch die alte Schnittstelle abgedruckt.
+
+```ts
+// ❌ VORHER (im Buch abgedruckt)
+disabled(path.password, (ctx) => !ctx.valueOf(path.username));
+disabled(path.password, (ctx) => !ctx.valueOf(path.username) ? 'Username is empty.' : false);
+
+// ✅ NACHHER
+disabled(path.password, { when: (ctx) => !ctx.valueOf(path.username) });
+disabled(path.password, {
+  when: (ctx) => !ctx.valueOf(path.username) ? 'Username is empty.' : false
+});
+```