mcpField
F
flutter-accessibility

flutter-accessibility

github.com/thienqoデザイン・UI944 回インストール1 日前に更新
リポジトリ

flutter-accessibility について

アクセシビリティを実装・検証すべき動作として扱う Flutter スキルです。対応ターゲットでの操作、セマンティクス、テストを開発者に案内します。

主な機能

  1. 01読み上げ順とフォーカスの監査
  2. 02ウィジェットのセマンティクス設定
  3. 03文字拡大とコントラストへの対応
  4. 04テストとスクリーンリーダーでの検証

活用シーン

  1. 01アプリの操作フローの課題確認
  2. 02カスタムコントロールと通知のテスト
  3. 03キーボードやスイッチ操作の確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/thienqo/flutter-skills --skill flutter-accessibility

インストール後、Claude Code で/flutter-accessibilityを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

evals/
cases.json
references/
semantics-and-screen-readers.md
target-sizes-and-contrast.md

詳細

Flutter のアクセシビリティ

アクセシビリティは、単にラベルを整えるのではなく、実装して検証する動作として扱ってください。

フローの監査

各ターゲットプラットフォームで、主なタスク、意味的な読み上げ順序、操作可能なコントロール、動的な通知、フォーカスの遷移、テキストの拡大縮小、コントラスト、モーション、キーボードまたはスイッチによる操作を確認します。

ルール

  • Semantics を手動で追加する前に、組み込みのセマンティックコントロールを優先してください。
  • カスタムのインタラクティブなウィジェットには、子のセマンティクスを重複させずに、役割、ラベル、値、状態、アクションを設定してください。
  • 視覚的なフォーカス順序、セマンティックなフォーカス順序、キーボードのフォーカス順序を一致させてください。
  • テキストを拡大縮小しても、クリップされたり、重要なアクションが隠れたりしないようにしてください。
  • プラットフォームに適したターゲットサイズを満たし、色だけに頼らないでください。
  • モーションの低減とコントラストの増加に関する設定でも、機能を維持してください。
  • 意味のある非同期状態の変化を通知し、通知が繰り返されて煩雑にならないようにしてください。
  • 情報を追加しない装飾的なコンテンツは、セマンティクスツリーから除外してください。

検証

セマンティクスを有効にしたウィジェットテストと、適切な場合は Flutter のアクセシビリティガイドラインのマッチャーを使用してください。また、TalkBack または VoiceOver を使って変更したフローをテストし、サポート対象のデスクトップ/ウェブターゲットではキーボード操作もテストしてください。

参考資料

参考情報

コメント