SPB Git

Repository Public MIT

accessibility.md 3.7 KB

# Accessibility report

Date: 2026-11-20 · Build 1.0.0 (1) · iOS 26.5 simulator. No physical-device or assistive-technology user testing was done.

# What is implemented

Area Implementation
VoiceOver Native SwiftUI controls. Keys have spoken names ("Divide", "Open parenthesis", "Second functions"); the display announces "Expression: …", "Result: …", "Preview: …"; results combine label, value and unit; mode switches announce selection state and a hint; the RPN registers read "X register: …".
Mathematical notation The Math environment generates a spoken description for every typeset expression ("x squared plus one, over two x").
Graphs The canvas is an accessibility element with a generated description (functions, window, key points) and custom actions (zoom, pan, reset). Analysis results are plain text rows.
Charts Swift Charts marks carry labels and values.
Dynamic Type Forms, results, lists and explanations use text styles. At accessibility sizes ResultRow and NumberField place the label above the value.
Keys and display Sized by the keypad grid, they do not follow Dynamic Type; every key exposes the system Large Content Viewer, and the display shrinks to fit long values instead of truncating.
Colour Adaptive light / dark tokens; semantic colours have separate light and dark values chosen for text; foreground on tinted fills flips with the appearance (ORIXColor.onTint).
Not colour alone Errors, warnings, verification state and result kinds always carry an icon and text; graph curves carry numbers and line styles; shaded regions are labelled.
Motion Reduce Motion disables non-essential animation in the shared pill picker and in the Graph, Workspace, Financial and Statistics screens.
Touch targets Controls outside the keypad are designed to the 44 pt guideline (not measured screen by screen); keypad keys keep at least 28 pt of height in the densest scientific rows on the smallest supported phone.
Haptics Optional (Settings).
Keyboard Hardware-keyboard input in the calculator; ⌘1–⌘8 switch environments; ⌘Y opens the history.

# Automated verification

UITests/ORIXCalcUITests.swift › testAccessibilityAuditOfTheCalculator runs XCTest's accessibility audit on the Standard calculator for three categories: Dynamic Type, sufficient element description, hit region. The audit passes with one documented exclusion: Dynamic Type findings on keypad keys, the display, and the mode strip, which are layout-sized by design (see "Keys and display").

Feature packages additionally render their screens at the accessibility-3 text size in tests; the layouts were inspected by the engineers who built them and corrected where text was clipped or hyphenated.

# Not verified

  • VoiceOver was not run by a person on a device: labels and values are unit-tested as strings, the navigation order and rotor behaviour were not listened to.
  • The automated audit covers the Standard calculator screen only. Contrast was not included in the audit categories; token contrast was chosen by design, not measured screen by screen.
  • Text sizes above accessibility-3, Switch Control, Voice Control, Full Keyboard Access and Bold Text were not exercised.
  • The smallest keypad rows (28 pt on small phones in Scientific portrait) are below the 44 pt guideline; landscape and iPad layouts give larger keys.

A VoiceOver pass on a physical iPhone and iPad through all eight environments, and an audit run extended to every environment including the contrast category.

Files main
Menu

Theme