Page navigation

PageControl

Let users work through a form from the keyboard, as in a desktop app.

Overview

PageControl gives a Blazor page desktop-style keyboard navigation: Tab and Shift+Tab follow the order you define across inputs and grids, and keyboard shortcuts jump between regions. Use it on data-entry screens such as a supplier record, so users keep their hands on the keyboard; the order is a graph of named focus nodes that can wrap at the ends, and FocusFirstNodeOnLoad puts the cursor in the first field when the page opens.

Examples

#A supplier record worked from the keyboard

Click into the first field and press Tab: focus walks the details, enters the grid at its first cell, leaves it for the switches, and after the last switch leaves the record for the rest of the page. Alt+D, Alt+C and Alt+S jump to a region (not on a Mac; see Keys); Previous and Next show another supplier and put focus back in the first field.

Simmer Down Stoves supplier 1 of 4

Details Alt+D

Contacts Alt+C

Contact Role Phone Email Active
Rubeus HaggleOrder desk+1 303 555 0143rubeus.haggle@simmerdown.exampleTrue
Minerva McGadgetAccounts+1 303 555 0144minerva.mcgadget@simmerdown.exampleTrue

Status Alt+S

Documentation

ParameterTypeDefaultDescription
NavigationGraphPageNavigationGraph?nullThe focus nodes and their order; the next table. With no graph the page does not take Tab.
NavigationMapPageNavigationMap?nullOlder linear form: named regions visited in order. Converted to a graph.
FocusFirstNodeOnLoadboolfalseFocus the first target once the page has loaded, retried over a few renders until a grid has rows; never takes focus the user already placed inside the page region.
EnableZoomShortcutsbooltrueWith a ZoomService registered on the host, Ctrl with plus, minus and zero zoom FlexCore text. Off on this page so Ctrl with plus and minus keep the browser's own zoom.
ScrollModePageScrollModeAutoHow the region scrolls when its content is larger than its space. Auto turns each scrollbar on only when that axis overflows.
MaxHeightstring?nullHeight cap for the scroll container, e.g. 100dvh, when the host layout gives none.
ChildContentRenderFragment?—The page content.
An unhandled error has occurred. Reload 🗙

Rejoining the server...

Rejoin failed... trying again in seconds.

Failed to rejoin.
Please retry or reload the page.

The session has been paused by the server.

Failed to resume the session.
Please retry or reload the page.