Skip to Content
Post Canvas
Guides

Keyboard and accessibility

Every keyboard shortcut in Post Canvas, how focus and screen reader announcements work, and the gaps we know about.

This page lists what the code does. It is not an accessibility audit, and it does not claim conformance with a standard. Where something is missing or untested, it says so.

In the tables, Mod means Cmd on macOS and Ctrl on Windows and Linux. Tooltips on the toolbar show the shortcut for the reader's platform.

Text formatting

These work when the matching feature is on (see Presets and features).

ActionShortcut
BoldMod-B
ItalicMod-I
UnderlineMod-U
StrikethroughMod-Shift-S
Inline codeMod-E
HighlightMod-Shift-H
SubscriptMod-,
SuperscriptMod-.
LinkMod-K
UndoMod-Z
RedoMod-Shift-Z or Mod-Y
ParagraphMod-Alt-0
Heading 1 to 4Mod-Alt-1 to Mod-Alt-4
Bulleted listMod-Shift-8
Numbered listMod-Shift-7
Task listMod-Shift-9
QuoteMod-Shift-B
Code blockMod-Alt-C
Align left, center, right, justifyMod-Shift-L, Mod-Shift-E, Mod-Shift-R, Mod-Shift-J
Line break inside a paragraphShift-Enter or Mod-Enter

Mod-K opens the link popover. In the popover, Enter applies the link and Escape closes it and returns focus to the text.

Markdown shortcuts

Typing these patterns changes the text as you type. They come from Tiptap's input rules.

TypeResult
# to #### at the start of a lineHeading 1 to 4
- , * or + Bulleted list
1. Numbered list
[ ] or [x] Task list
> Quote
Three backticks, with an optional language, then a spaceCode block
---Divider
**text** or __text__Bold
*text* or _text_Italic
`text`Inline code
~~text~~Strikethrough
==text==Highlight
  • / at the start of a text block opens the insert menu. Keep typing to filter it. It does not open inside a code block.
  • @ and # open mention and hashtag lists, when you pass the mentions or hashtags adapter.
  • In any of these lists, ArrowDown and ArrowUp move through the items, Enter or Tab picks one, and Escape closes the list. Focus stays in the text. The editor points at the active item with aria-activedescendant, and the list is a listbox.
  • Inserting a block by keyboard goes through /, or through the Insert button in the toolbar. The round + button next to a block is for the mouse and for touch, and it is not in the tab order.

Blocks

These shortcuts act on the top-level block that holds the caret, whether it is a paragraph, a list, a table or a picture:

ActionShortcut
Move block upAlt-Shift-Up
Move block downAlt-Shift-Down
Duplicate blockAlt-Shift-D
Delete blockAlt-Shift-Backspace

The grip beside a block (the block handle) opens a menu with the same actions. It is a button that appears beside the block the caret is in, so Tab reaches it from the text, and Enter or Space opens the menu. Dragging it by mouse, or with a long press on touch, moves the block. The shortcuts above are the quicker keyboard route.

A media block takes focus when you click it. While it has focus:

  • Backspace or Delete removes it.
  • ArrowUp or ArrowLeft puts the caret before it. ArrowDown, ArrowRight or Enter puts the caret after it.
  • Escape lets go of focus.

In the collage editor, each photo is a button. With a photo focused, the arrow keys move it (hold Shift for larger steps), + and - resize it, [ and ] rotate it (Shift for larger steps), PageUp and PageDown change its layer, Delete or Backspace removes it, and Escape deselects. Mod-Z and Mod-Shift-Z undo and redo inside the collage.

Paste

  • Mod-V pastes with formatting, cleaned by the paste rules. See Migrating from TinyMCE or Froala.
  • Mod-Shift-V pastes plain text. This also holds when the clipboard carries files next to the text, as an office app does when it puts a picture of the selection beside the copied text: the text is pasted and the files are ignored.

Toolbar, menus and popovers

  • The toolbar is a single Tab stop. Once focus is in it, ArrowLeft and ArrowRight move between buttons, Home and End go to the first and last, and Tab leaves the toolbar. Buttons that do not fit move into a More panel with the same keys.
  • Menus (block type, color, align, insert, the block handle menu) open with Enter or Space. Inside, ArrowDown, ArrowUp, Home and End move between items, typing a letter jumps to the next item that starts with it, and Escape closes the menu and returns focus to the button that opened it.
  • Popovers, such as the link popover, close on Escape and on a press outside, and focus goes back to where it was.

Tab, Enter and Escape

KeyWhereWhat it does
Tab, Shift-TabIn a list itemIndents and outdents the item
TabIn a tableMoves to the next cell. In the last cell it adds a row
Shift-TabIn a tableMoves to the previous cell
TabIn a paragraph, heading or code blockNot captured: focus moves on to the next control, so the editor is not a keyboard trap
Enter or ArrowDown at the end of the titleTitle fieldMoves the caret into the body
EnterWith submitOnEnterCalls onSubmit, unless a suggestion list is open
Shift-EnterWith submitOnEnterAdds a line break
EscapeMenus, popovers, suggestion listsCloses them
EscapeDuring a drag of a media block or photoCancels the drag
EscapeIn the paste-a-link fieldCancels it

Screen readers

  • The editable area has role="textbox", aria-multiline="true" and a label that follows the locale ("Post editor" in English).
  • The toolbar and the selection menu are role="toolbar" with labels. Toggle buttons use aria-pressed and aria-keyshortcuts.
  • Menus use menu, menuitem and menuitemradio roles, with aria-expanded and aria-haspopup on the buttons that open them.
  • Media frames are role="group" with a label such as "Gallery, 3 photos". Each collage photo has a label with its position, size and rotation.
  • Notices (an upload failed, a limit was reached) are announced through two live regions: errors assertively, everything else politely. The same message also shows as a toast.
  • The suggestion list announces its state through a polite live region.
  • Form errors, such as an invalid link or a missing title, use role="alert", aria-invalid and aria-describedby.
  • The restored-draft banner is role="status".

All of these labels come from the locale, so translating the editor translates what a screen reader says. See Internationalization.

Touch and reduced motion

On touch devices (a coarse primary pointer) buttons and menu items grow to at least 44 by 44 pixels, and the controls on pictures stay visible. When the reader asks for reduced motion, animations and transitions are cut to nearly zero length. Both live in the stylesheet. See Theming.

What is not covered

  • The + button is for the mouse and for touch, and it is not in the tab order. Keyboard users insert with / or the toolbar's Insert button, and move, duplicate or delete blocks with the Alt-Shift shortcuts or the block handle's menu.
  • Drag to reorder with a long press on touch has not been tested on a real device. It is built on pointer events.
  • Right-to-left layout is not supported yet.
  • Spell check and grammar are whatever the browser does for an editable area. There is no spell-check interface of our own.
  • Screen reader testing. The roles and live regions above are in the code. We have not published results from testing with specific screen readers, so test with the ones your readers use.

On this page