SPB Git

Repository Public MIT

accessibility.md 3.7 KB 52 lines markdown

1<!--2ORIX Calc3File: docs/accessibility.md4Author: Simon-Pierre Boucher5Contact: contact@spboucher.ai6-->7# Accessibility report89Date: 2026-11-20 · Build 1.0.0 (1) · iOS 26.5 simulator. **No physical-device or assistive-technology user testing was done.**1011## What is implemented1213| Area | Implementation |14|---|---|15| 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: …". |16| Mathematical notation | The Math environment generates a spoken description for every typeset expression ("x squared plus one, over two x"). |17| 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. |18| Charts | Swift Charts marks carry labels and values. |19| Dynamic Type | Forms, results, lists and explanations use text styles. At accessibility sizes `ResultRow` and `NumberField` place the label above the value. |20| 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. |21| 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`). |22| 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. |23| Motion | Reduce Motion disables non-essential animation in the shared pill picker and in the Graph, Workspace, Financial and Statistics screens. |24| 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. |25| Haptics | Optional (Settings). |26| Keyboard | Hardware-keyboard input in the calculator; ⌘1–⌘8 switch environments; ⌘Y opens the history. |2728## Automated verification2930`UITests/ORIXCalcUITests.swift › testAccessibilityAuditOfTheCalculator` runs XCTest's accessibility audit on the Standard31calculator for three categories: Dynamic Type, sufficient element description, hit region. The audit passes with one32documented exclusion: Dynamic Type findings on keypad keys, the display, and the mode strip, which are layout-sized by33design (see "Keys and display").3435Feature packages additionally render their screens at the accessibility-3 text size in tests; the layouts were inspected by36the engineers who built them and corrected where text was clipped or hyphenated.3738## Not verified3940- VoiceOver was not run by a person on a device: labels and values are unit-tested as strings, the navigation order and41  rotor behaviour were not listened to.42- The automated audit covers the Standard calculator screen only. Contrast was not included in the audit categories;43  token contrast was chosen by design, not measured screen by screen.44- Text sizes above accessibility-3, Switch Control, Voice Control, Full Keyboard Access and Bold Text were not exercised.45- The smallest keypad rows (28 pt on small phones in Scientific portrait) are below the 44 pt guideline; landscape and46  iPad layouts give larger keys.4748## Recommended before public release4950A VoiceOver pass on a physical iPhone and iPad through all eight environments, and an audit run extended to every51environment including the contrast category.52
Files main
Menu

Theme