Constructor FocusScopeSettings

Namespace

Velvet

Assembly

Velvet.Docs.dll

FocusScopeSettings(bool, bool, bool, bool)

Focus-management behavior for a container subtree: Contain, RestoreFocus, and AutoFocus are straightforward toggles; SingleTabStop is the WAI-ARIA composite-widget (roving) contract adapted to UI Toolkit, where arrow/dpad movement inside the group is already engine-native 2D navigation. Record structural equality simplifies DiffProps.

public FocusScopeSettings(bool Contain = false, bool RestoreFocus = false, bool AutoFocus = false, bool SingleTabStop = false)

Parameters

Contain bool

Tab/Shift-Tab wrap within the subtree (computed by a focus ring scoped to it); a 2D/pointer move that exits the subtree is snapped back within the same event flush, wherever it landed. A press on empty non-focusable space clears focus to nothing first — that path re-focuses the scope on the panel's next scheduler tick instead.

RestoreFocus bool

On unmount while holding focus, refocus the element focus came FROM when it first entered the scope (skipped if that element is gone, detached, or cannot grab focus).

AutoFocus bool

On mount (the scope's FIRST attach-to-panel, never a re-attach such as a keyed reorder's), focus the scope's first focusable descendant (skipped when focus is already inside the scope).

SingleTabStop bool

The subtree behaves as one Tab stop: Tab from inside exits past the remaining members (wrapping within the nearest containing scope, if any); Tab entering from outside — in either direction — lands on the last-focused member, else the scope's first. Members keep tabIndex 0, so engine 2D arrow/dpad navigation inside is untouched.