swiftui-accessibility

xtone's avatarfrom xtone

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.

⭐3stars🔀0forks📁View on GitHub🕐Updated Dec 24, 2025⬇️1downloads

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.
nameswiftui-accessibility
descriptionAccessibility 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テスト方法

使用方法

アクセシビリティ実装時

  1. references/accessibility.mdで実装パターンを確認
  2. VoiceOverでテスト
  3. Dynamic Typeでレイアウト確認

PRレビュー時

  1. アクセシビリティラベルの有無を確認
  2. 画像にaltテキストがあるか確認
  3. タップ領域が十分か確認

クイック実装ガイド

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レビュー時のアクセシビリティチェック