# 全17アイコンに読み上げ用の名前を付与

送信ボタンが「arrow up circle, button」と読み上げられる問題を受け、アイコンだけの全操作要素にスクリーンリーダー用の名前を付け、アイコンから8行以内のラベルを必須とする静的検査を作成した。

9月 2026

状況. 標準シンボルを操作に使い、ラベルがなければスクリーンリーダーは内部名を読んでいた。送信は「arrow up circle, button」で、ほかのアイコン操作も同様で、計17個が機能ではなく、それぞれの図柄を説明していた。

課題. すべてに動作を示すラベルを付け、次の追加で直ちに再発しないよう検査も加える必要があった。

行動. 17個それぞれに形でなく動作の名を与え、状態で意味が変わればラベルも変えた。汎用の「アクセシブルか」規則はないため、アイコンだけの操作をつくる構文を探し、8行以内にラベルを必須とする検査を設けた。8行は意図的に粗いが、修飾を含む全正当な書き方を覆い、下の別ビューのラベルでは偶然満たしにくいと測って選んだ。精密にはSwiftUI修飾鎖を木として理解する必要があるが、実際のミスは誤ラベルでなく未ラベルなので、安い近接規則で捉えられる。

結果. 17操作が機能を読み上げ、18個目はラベルなしに追加できなくなった。ただし隣のビューのラベルでも満たし得るため、近くの存在を証明するだけで正しさは証明しないと定義箇所に記した。正確さには今も誰かが聞く必要がある。

役割: アクセシビリティ専門家
=> /ja/categories/frontend/ カテゴリー: フロントエンド開発
=> /ja/categories/automation/ カテゴリー: 自動化・CI/CD
=> /ja/categories/testing/ カテゴリー: テスト・品質保証
=> /ja/categories/design-systems/ カテゴリー: デザインシステム・UI
=> /ja/categories/ux-ui/ カテゴリー: UX・UI設計
=> /ja/categories/documentation/ カテゴリー: 文書作成
=> /ja/services/frontend-development/ サービス: フロントエンド開発
=> /ja/services/ui-ux-design/ サービス: UI/UX設計・デザインシステム

=> https://engineer.company/ja/portfolio/named-all-17-icons-for-screen-readers/ このページのウェブ版
