Overview

Grid Mode

What happens after the move depends on the command you used. command.enterGridModeAndMoveCursor moves without clicking; command.enterGridModeAndLeftClick clicks on arrival.

Use Grid Mode when there is no element to target, which is where Element Mode runs out: canvases, image editors, video timelines, custom-drawn UI.

Grid types#

Keyboard Grid#

Uses number and letter keys to locate a target in two steps: the first key picks an approximate group, the second the position inside it. Designed to reach a target in the fewest selections.

Proportional Grid#

A two-step spatial hint. The first character comes from left-hand keys (QWERT, ASDFG, ZXCVB) and selects a region; the second comes from right-hand keys (UIOP, JKL;, NM,.) and selects the position inside it.

Key positions match screen positions, so keys toward the top left of the keyboard point at the top left of the screen. That lets you aim from spatial memory instead of reading every hint.

When a region holds several cells, it also has a same-sized target at its center, selected by repeating the first character. A region with DU, DI, DJ, and DK also accepts DD. The center cell stays visible but its hint is hidden to keep the overlay readable.

Neighboring regions alternate fill intensity, a subtle checkerboard that makes the first-character groups readable at a glance.

Nine-Square Grid#

Each step divides the current grid into a fixed 3x3 layout. Hint distribution is consistent, though it suits some screen sizes better than others.

Bisection Grid#

Each step splits the current grid top/bottom and left/right. A good fit if you think in directions rather than hints.

Hint style#

Two styles are available: default and largeText. The largeText style puts larger hints near each cell's center, which reads better on a busy screen.

Offset the grid#

Press Tab to offset the grid toward the lower right, Shift + Tab to move it back toward the upper left.

This rescues the awkward case where your target sits right on a grid boundary: nudge the grid and the point falls cleanly inside a cell.

Switch displays#

Press - for the previous display and = for the next. Number keys jump directly to a display when they are not in use for grid positioning. Each display's number shows in the status indicator at the top left.

Next#