swiftui-accessibility
Accessibility implementation guide for SwiftUI apps. Use when implementing VoiceOver support, adding accessibilityLabel/Hint/Value, supporting Dynamic Type, ensuring color contrast, testing accessibility, or reviewing accessibility in PRs. Covers iOS accessibility APIs, WCAG guidelines, and testing tools.
When & Why to Use This Skill
This Claude skill provides a comprehensive implementation guide for SwiftUI accessibility, empowering developers to build inclusive and WCAG-compliant iOS applications. It offers practical patterns for VoiceOver optimization, Dynamic Type scaling, and color contrast adjustments, ensuring that apps are usable by everyone regardless of their visual or motor abilities.
Use Cases
- Implementing VoiceOver support by adding descriptive accessibility labels, hints, and traits to interactive SwiftUI components.
- Supporting Dynamic Type to ensure app layouts and typography scale correctly for users with different text size preferences.
- Conducting accessibility audits during Pull Request (PR) reviews using standardized checklists for tap targets and alt-text.
- Ensuring WCAG compliance by verifying color contrast ratios and implementing 'Reduce Motion' alternatives for animations.
- Utilizing the Accessibility Inspector and VoiceOver testing methods to validate the user experience for assistive technology users.
| name | swiftui-accessibility |
|---|---|
| description | Accessibility implementation guide for SwiftUI apps. Use when implementing VoiceOver support, adding accessibilityLabel/Hint/Value, supporting Dynamic Type, ensuring color contrast, testing accessibility, or reviewing accessibility in PRs. Covers iOS accessibility APIs, WCAG guidelines, and testing tools. |
SwiftUI Accessibility Guide
SwiftUIアプリのアクセシビリティ実装ガイド。
ディレクトリ構成
swiftui-accessibility/
├── SKILL.md (このファイル)
└── references/
└── accessibility.md
リファレンスファイル
references/accessibility.md
アクセシビリティ実装ガイド:
- VoiceOver対応:
- accessibilityLabel: 要素の説明
- accessibilityHint: 操作のヒント
- accessibilityValue: 現在の値
- accessibilityTraits: 要素の種類
- Dynamic Type:
- フォントスケーリング
- レイアウト対応
- 色のコントラスト:
- WCAG基準
- ダークモード対応
- モーション:
- reduceMotion対応
- アニメーション代替
- テストとツール:
- Accessibility Inspector
- VoiceOverテスト方法
使用方法
アクセシビリティ実装時
references/accessibility.mdで実装パターンを確認- VoiceOverでテスト
- Dynamic Typeでレイアウト確認
PRレビュー時
- アクセシビリティラベルの有無を確認
- 画像にaltテキストがあるか確認
- タップ領域が十分か確認
クイック実装ガイド
VoiceOver基本
// ラベル(必須)
Image(systemName: "heart.fill")
.accessibilityLabel("お気に入り")
// ヒント(操作説明)
Button("削除") { }
.accessibilityHint("この項目を削除します")
// 値(現在の状態)
Slider(value: $volume)
.accessibilityValue("\(Int(volume))パーセント")
Dynamic Type対応
// 推奨: システムフォント
Text("Hello")
.font(.body)
// カスタムフォントのスケーリング
Text("Hello")
.font(.custom("MyFont", size: 16, relativeTo: .body))
reduceMotion対応
@Environment(\.accessibilityReduceMotion) var reduceMotion
var body: some View {
content
.animation(reduceMotion ? nil : .default, value: isExpanded)
}
チェックリスト
- 全てのインタラクティブ要素にaccessibilityLabelがあるか
- 画像に適切な説明があるか
- Dynamic Typeでレイアウトが崩れないか
- 色だけに依存した情報伝達がないか
- タップ領域は44pt以上あるか
関連スキル
- swiftui-coding-guidelines: 基本的なベストプラクティス
- swiftui-code-review-checklist: PRレビュー時のアクセシビリティチェック