Accessibility and keyboard

Use Komma CSV with the keyboard or VoiceOver and adjust text size, contrast and motion to suit your needs.

Work without a mouse

  1. Open a document and press ⌃⌘G (Control + Command + G) to focus the table.
  2. Tab moves to the next cell and Shift-Tab to the previous cell, including across row boundaries.
  3. Return or Down moves to the next row in the same column. Shift-Return or Up moves to the previous row. Left/Right still moves the text cursor.
  4. Escape leaves the table and focuses Find. Press Escape again to close Find and return to the last active cell. At the last cell, Tab moves to Find; at the first cell, Shift-Tab does the same.

Use the Table menu for row actions and Sort Current Column. Shift-Command-L selects or deselects the active row; Shift-Command-A selects all data rows, excluding the header. Shift-Command-N adds a row; Shift-Command-Delete deletes selected rows. Command-Z undoes changes and Shift-Command-Z redoes them.

Command-F opens Find; Command-G / Shift-Command-G move between matches. While Find is open: Option-Command-L finds and selects rows, Option-Command-C toggles case sensitivity and Option-Command-X toggles regular expressions. Option-Command-R replaces the current match; Shift-Option-Command-R replaces all matches. Native menus, dialogs and text fields remain accessible using macOS keyboard navigation.

The Table menu also provides Add Columns…, column commands for the active cell, and Move Rows Up/Down. This lets you change the structure without dragging with a mouse.

After clicking a column title, Left/Right selects a neighbouring column, Return edits its header cell (or first data cell without a header), Shift-F10 opens its menu, and Escape clears the column selection. After clicking a row number, Space toggles its selection, Shift-F10 opens its menu, and Return enters a cell in that row.

Enlarge text

Choose View → Larger Table Text or press Command-Plus. Command-Minus decreases the size; Command-0 resets it. Under Komma CSV → Settings → Accessibility, choose a size between 13 and 32 pt. This preference is saved across launches and applies to all document windows. Row heights and column widths grow with the text. Large tables can still be scrolled horizontally and vertically.

Work with VoiceOver

VoiceOver is the screen reader built into your Mac. Turn it on under System Settings → Accessibility → VoiceOver. Then open a document in Komma CSV and press Control-Command-G to start editing the table.

VoiceOver announces the cell value, row, column and column heading where available. It also identifies header cells, selected rows, search matches and modified cells. Press Tab to move to the next cell. VoiceOver cell actions also offer Next cell, Previous cell and Select or deselect row.

When VoiceOver announces a group or scroll area, start interacting with VO-Shift-Down Arrow. VO-Shift-Up Arrow leaves that area. VO means your VoiceOver modifier; with the default settings, you can use Control-Option. Activate a focused button with VO-Space. See Apple’s VoiceOver interaction commands for more guidance.

Moving between search matches announces their position and value. Komma CSV also announces the number of replaced matches and completion of sorting, undo and redo. Character encoding correction identifies the original value and proposed correction by row and column. An invalid regular expression is announced as an error while Find is open.

Colors, contrast and orientation

Under Komma CSV → Settings → Appearance, choose System, Light or Dark. System follows your Mac’s appearance.

To make grid lines and controls easier to distinguish, open System Settings → Accessibility → Display and enable Increase contrast. Komma CSV then draws stronger grid lines. This also works when you explicitly choose Light or Dark in the app. Reduce transparency in the same system settings can provide more solid surfaces.

A magnifying glass marks search matches. Selected rows have a checkbox, and the current match has an outline. Modified cells have a yellow background. Editing a cell shows neither a pencil icon nor an additional focus ring. VoiceOver continues to identify modified cells.

Reduce motion

If animated transitions bother you, enable Reduce motion in System Settings → Accessibility. Depending on your macOS version, the switch is under Motion or Display.

Komma CSV follows this setting automatically and suppresses animated transitions in its interface. While waiting for confirmation of the default-app association, it shows a stationary hourglass with a status message instead of a spinning indicator. No additional setting is needed in Komma CSV.