dpearson2699/swift-ios-skills / skills/ios-accessibility
ios-accessibility
VerifiedBuild and audit SwiftUI, UIKit, and AppKit accessibility for VoiceOver, Voice Control, Switch Control, Full Keyboard Access, Dynamic Type, focus restoration, labels/traits/actions, traversal, custom rotors, NSAccessibility, XCTest checks, adaptive system preferences, and App Store accessibility declarations. Use when implementing accessible UI, fixing an accessibility audit, testing assistive-technology behavior, or substantiating App Store Accessibility Nutrition Labels.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 18.2 KB |
| evals/evals.json | config | 5.3 KB |
| references/a11y-patterns.md | markdown | 11.7 KB |
| references/media-accessibility.md | markdown | 3.5 KB |
| references/nutrition-labels.md | markdown | 8.2 KB |
references/media-accessibility.md
View on GitHub# Media Accessibility
Accessibility patterns for audio and video content using AVFoundation.
## Contents
- [Closed Captions and Subtitles](#closed-captions-and-subtitles)
- [SwiftUI VideoPlayer](#swiftui-videoplayer)
- [Custom Player Controls](#custom-player-controls)
## Closed Captions and Subtitles
### AVMediaCharacteristic Tags
AVFoundation uses media characteristics to identify accessibility tracks:
Docs: [AVMediaCharacteristic](https://sosumi.ai/documentation/avfoundation/avmediacharacteristic)
| Characteristic | Purpose |
| -------------- | ------- |
| `.transcribesSpokenDialogForAccessibility` | Captions/SDH — transcribes dialog for deaf or hard of hearing users |
| `.describesMusicAndSoundForAccessibility` | Captions that include descriptions of music and sound effects |
| `.describesVideoForAccessibility` | Audio descriptions — narrates visual content for blind or low-vision users |
| `.easyToRead` | Simplified captions for cognitive accessibility |
| `.containsOnlyForcedSubtitles` | Subtitles that display only when content differs from the device language |
| `.languageTranslation` | Subtitles providing a language translation |
### Selecting Accessible Media
```swift
import AVFoundation
let asset = AVURLAsset(url: videoURL)
let group = try await asset.load(.mediaSelectionGroup(forMediaCharacteristic: .legible))
if let group {
// Find the closed caption option
let ccOptions = AVMediaSelectionGroup.mediaSelectionOptions(
from: group.options,
with: .transcribesSpokenDialogForAccessibility
)
if let ccOption = ccOptions.first {
let playerItem = AVPlayerItem(asset: asset)
playerItem.select(ccOption, in: group)
}
}
```
### Audio Descriptions
```swift
let adGroup = try await asset.load(.mediaSelectionGroup(forMediaCharacteristic: .audible))
if let adGroup {
let adOptions = AVMediaSelectionGroup.mediaSelectionOptions(
from: adGroup.options,
with: .describesVideoForAccessibility
)
if let adOption = adOptions.first {
playerItem.select(adOption, in: adGroup)
}
}
```
### System Accessibility Settings
AVPlayer automatically selects captioned/described tracks when the user
enables these in Settings → Accessibility → Subtitles & Captioning. You don't
need manual selection unless providing a custom media selection UI.
Check user preferences:
```swift
import MediaAccessibility
let captioningEnabled = MACaptionAppearanceIsDisplayedAutomatically(.user)
```
## SwiftUI VideoPlayer
SwiftUI's `VideoPlayer` inherits AVPlayer's automatic accessibility track
selection:
```swift
import AVKit
import SwiftUI
struct AccessibleVideoView: View {
let player: AVPlayer
var body: some View {
VideoPlayer(player: player)
.accessibilityLabel("Training video")
.accessibilityHint("Double-tap to play or pause")
}
}
```
## Custom Player Controls
When building custom video controls, ensure:
- Play/pause, seek, and volume controls are all focusable and labeled
- Current time and duration are announced on focus changes
- Captions toggle is available and labeled
- Progress slider uses `accessibilityValue` to announce time position
- Controls remain visible/accessible when captions overlay is active
```swift
Button(action: toggleCaptions) {
Image(systemName: captionsEnabled ? "captions.bubble.fill" : "captions.bubble")
}
.accessibilityLabel(captionsEnabled ? "Captions on" : "Captions off")
.accessibilityHint("Toggles closed captions")
```
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |