@@ -177,7 +177,7 @@ matches the stale handle and `args.Cancel = true` wedges focus on a
177177neighboring page element. Always flip `isActive` to false in the same
178178state batch that unmounts the container, or apply the trap to an
179179element that stays in the tree across the open/closed transition
180- (an always-mounted overlay with `.Visible (open)` rather than
180+ (an always-mounted overlay with `.IsVisible (open)` rather than
181181`When(open, ...)`).
182182<!-- /ai:caveat -->
183183
@@ -281,7 +281,7 @@ The standard accessible modal combines three primitives: a controlled
281281`isOpen` boolean, a `UseFocusTrap` keyed on it, and a
282282`UseAnnounce` that announces "Dialog opened" on first render and
283283"Dialog closed" on dismiss. The trap container should stay mounted
284- across the open/closed transition (use `.Visible (open)` not
284+ across the open/closed transition (use `.IsVisible (open)` not
285285`When(open, ...)`) so focus is released cleanly when `isActive`
286286flips false — see the caveat above. The
287287[modal-dialog recipe](recipes/modal-dialog.md) wires all three end
@@ -311,17 +311,17 @@ keeps them keyboard- and pointer-interactive.
311311
312312## Common Mistakes
313313
314- ### Disabled Submit with no `.DisabledFocusable ()`
314+ ### Disabled Submit with no `.IsDisabledFocusable ()`
315315
316316```csharp
317317// Don't:
318- Button("Submit", onSubmit).Disabled(! form.IsValid)
318+ Button("Submit", onSubmit).IsEnabled( form.IsValid)
319319```
320320
321321A disabled button is removed from the Tab order. The user fixes the
322322last field, presses Tab to reach Submit, focus skips past the still-
323323disabled button, and they're stranded with no keyboard route. Use
324- `.DisabledFocusable (!form.IsValid)` on the button — it keeps the
324+ `.IsDisabledFocusable (!form.IsValid)` on the button — it keeps the
325325button keyboard-focusable while presenting as disabled. The
326326[Forms page](forms.md#keeping-submit-reachable) covers the full
327327shape (it composes with `.Immediate()` on commit-on-blur inputs).
@@ -338,7 +338,7 @@ Button("Save", onSave)
338338focus and pointer hit-testing still work. The result is a button the
339339user can Tab to and click but a screen reader user cannot discover.
340340If the control should not be exposed to assistive tech, it should
341- not exist for keyboard users either; use `.Disabled(true )` or pull it
341+ not exist for keyboard users either; use `.IsEnabled(false )` or pull it
342342from the tree with `When(...)`. Use `.AccessibilityHidden()` only on
343343decorative elements that don't accept focus (icons, ornamental
344344borders, redundant labels).
0 commit comments