You can do every EditRail task with the keyboard. Each drag has a keyboard path. Screen readers announce each insert and each change to your toolbar.
Reach the toolbar
- The toolbar is one Tab stop. Press Tab to move focus to it, and again to move past it.
- The toolbar is also an editor region named “Tool rail”. Press Ctrl+` to move to the next region of the editor. Press Ctrl+Shift+` to move to the previous region.
Move between tools
- On a toolbar at the left edge, the right edge or floating, press Up Arrow and Down Arrow.
- On a toolbar at the top or the bottom, press Left Arrow and Right Arrow.
- Press Home for the first tool and End for the last tool.
- From the last tool, the next arrow press goes to the first tool.
Some tools have a flyout with more tools. To open it, press Right Arrow on a vertical toolbar or Down Arrow on a horizontal toolbar. Press Escape to close it.
Arm a tool and insert its block
- Move to a tool and press Enter. The tool is armed.
- Select the block that you want the new block to follow. You can stay on the toolbar or go to the canvas.
- Press Ctrl+Enter (Cmd+Enter on a Mac).
The block goes in after the selected block. If no block is selected, it goes in at the end of the post. If the selected block is an empty paragraph, the new block replaces it. The block inserter does the same. The new block is selected.
- Press Ctrl+Shift+Enter to insert the block and keep the tool armed.
- Press Enter on the armed tool again to disarm it.
- Press Escape anywhere in the editor to disarm the tool and return to Select.
Ctrl+Enter does not insert while Toolbar settings, the help panel, a flyout or the Section overview is open.
If you arm a tool in a flyout, focus goes back to the toolbar button that opened the flyout.
What screen readers announce
- After an insert: “Paragraph inserted. Select is active.”
- After an insert with Ctrl+Shift+Enter: “Paragraph inserted. The tool stays armed.”
- After you disarm a tool: “Tool disarmed. Select is active.”
- When the block cannot go at that point: “Paragraph cannot be inserted here.” The tool stays armed.
- When you pin, unpin or move a tool, or save or delete a set, the result is announced. For example: “Quote pinned to the toolbar.”
- When the settings sidebar width changes: “Settings sidebar width: 400 pixels.”
The name in each message is the name of the block or pattern.
The toolbar has the toolbar role and the name “Tools”. Each tool is a button. An armed tool is a pressed button. A flyout is a menu. A tool in a flyout that has an on or off state is a menu item with a checkbox.
Panels and dialogs
- Toolbar settings and the flyouts close when you press Escape and when you Tab past them.
- The help panel closes when you press Escape.
- While the Section overview is open, Tab stays inside it.
Keyboard paths for each drag
- Drag a tool into the canvas: arm the tool, then press Ctrl+Enter.
- Drag the toolbar to an edge: use Toolbar position in Toolbar settings.
- Drag a block from the inserter onto the toolbar: search under Add a block or pattern in Toolbar settings, or use Pin to toolbar in the block’s options menu.
- Drop a block from the canvas onto the toolbar: use Save as pattern and pin to toolbar… in the block’s options menu.
- Drag an outline in the Section overview: use the move up and move down buttons. See Section overview.
- Drag the edge of the settings sidebar: press Tab to move to the edge and use the arrow keys, or type a width in Toolbar settings. See Settings sidebar width.