useRovingFocus API
API reference for the useRovingFocus composable.
Functions
useRovingFocus
(items: () => RovingItem[], options?: RovingFocusOptions) => RovingFocusReturnOptions
target
MaybeRefOrGetter<HTMLElement | null | undefined>orientation
"horizontal" | "vertical" | "both" | undefinedArrow key mapping. Ignored when `columns` is set (grid uses all 4 arrows).
circular
boolean | undefinedcolumns
MaybeRefOrGetter<number> | undefinedColumn count for grid navigation. When set, items are treated as a 2D grid in row-major order: Left/Right step ±1, Up/Down step ±columns, Home/End go to row start/end, Ctrl+Home/End go to first/last overall.
onFocus
((id: ID) => void) | undefined