Tablen
Documentation/Localization & Accessibility

Accessibility

Localization & Accessibility

Accessibility

Tablen is built with accessibility in mind, supporting macOS accessibility features to ensure the application is usable by everyone.

VoiceOver Support

Tablen supports macOS VoiceOver screen reader:

Sidebar Navigation

  • Connection names and states are announced
  • Table names are accessible
  • Group headers are navigable
  • Connection health status (healthy, slow, disconnected) is conveyed

Query Editor

  • Editor content is accessible to VoiceOver
  • Line numbers are available
  • Autocomplete suggestions are announced

Result Table

  • Column headers are announced
  • Cell values are readable
  • Row and column positions are conveyed
  • Aggregate values (when cells are selected) are accessible

Dialogs and Sheets

  • All dialog content is accessible
  • Button labels are descriptive
  • Form fields have proper labels

Keyboard Navigation

Tablen is fully navigable by keyboard:

Tab Navigation

  • Tab/Shift+Tab moves between form fields and controls
  • Cmd+1-9 switches between open tabs
  • Cmd+L focuses the sidebar

Sidebar

  • Arrow keys navigate connections and tables
  • Enter connects or selects
  • Disclosure triangles expand/collapse with arrow keys

Result Table

  • Arrow keys move between cells
  • Enter starts editing a cell
  • Escape cancels editing
  • Shift+Click for range selection

Command Palette

  • Cmd+Shift+P opens the palette
  • Arrow keys navigate commands
  • Enter executes the selected command
  • Escape dismisses

Dialogs

  • Tab moves between fields
  • Enter confirms
  • Escape cancels
  • Buttons are reachable via Tab

Visual Accessibility

Themes

  • Multiple themes available with varying contrast levels
  • Dark and light mode support
  • Theme colors are customizable through the plugin system

Font Size

  • Editor font size adjustable from 10pt to 24pt
  • Settings > Appearance > Font Size

Color Indicators

  • Connection health uses colors with distinct meanings:
    • Green: Healthy
    • Yellow: Slow (with latency value)
    • Red: Disconnected
  • Environment tags use distinct colors
  • Database type brand colors are used for visual identification

Alternating Row Colors

  • Toggleable in Settings > Appearance
  • Helps track rows across wide result tables

Focus Management

Focus States

  • Interactive elements show clear focus indicators
  • The sidebar supports @FocusState for programmatic focus management
  • The Command Palette auto-focuses the search field

Focus Shortcuts

Shortcut Target
Cmd+L Sidebar
Cmd+E Toggle editor (returns focus to editor)
Cmd+Shift+P Command Palette search field

macOS Accessibility Integration

Tablen integrates with macOS accessibility features:

System Preferences

  • Respects system-wide accessibility settings
  • Supports increased contrast mode
  • Responds to reduce motion preferences

Dynamic Type

  • UI text responds to system font size preferences where applicable
  • The editor font size is independently configurable

Color Filters

  • UI works with macOS color filter settings
  • Essential information is not conveyed by color alone (icons and text supplement color indicators)

Known Limitations

  • Some complex chart visualizations in the dashboard may have limited VoiceOver support
  • The minimap in the query editor is primarily visual
  • Drag and drop for tab reordering and connection grouping requires mouse interaction (keyboard alternatives are available through context menus)
Was this page helpful?
Report an issue