Copyright © 2022 W3C® (MIT, ERCIM, Keio, Beihang). W3C liability, trademark and permissive document license rules apply.
この仕様は、Webコンテンツ制作者に、さまざまな認知障害および学習障害のあるWeb利用者を 支援するための標準的なアプローチを提供する。対象には、次のような利用者が含まれる：
この仕様で説明される技術は、フォーム・コントロール、アイコン、その他のユーザー・インターフェイス要素を含む 一般的なWebコンテンツの外観を、個々の利用者にとってよりなじみがあり理解しやすい 表示へとプログラム的に変換するために使用されることを意図している。ユースケースおよび関連する語彙用語が 定義され、ユーザー・エージェントがコンテンツを拡張または適応させ、特定の利用者の特定の ニーズにより適合させることを可能にする。これにより、多様なニーズをもつ利用者が、Web上のやり取りを 単純化したり、理解する備えが十分でないなじみのない表現に利用者が取り組まざるを得ない状況を 避けたりすることで、Webコンテンツをより容易に理解できるようになる。
このWAI-Adapt: ツール・モジュールは、WAI-Adapt解説文書 [adapt] で導入されたWAI-Adaptシリーズの構成要素である。
この節では、この 文書の公開時点におけるステータスを説明する。現在のW3C 公開文書の一覧およびこの技術報告書の最新改訂版は、 W3C技術 報告書索引（ https://www.w3.org/TR/）で確認できる。
この文書は、Accessible Platform Architectures作業グループにより、 勧告トラックを用いた 作業草案として公開された。 タスクフォースの名称はPersonalizationからWAI-Adaptに変更され、すべての文書名も それに応じて変更される予定である。この公開の目的は、文書名を変更することである。詳細については、 WAI-Adaptタスクフォースの決議および議論 を参照されたい。
コメントするには、W3C WAI-Adapt GitHubリポジトリで課題を提出する。これが 実行可能でない場合は、public-adapt@w3.org（アーカイブ）にメールを送信されたい。コメントは 2022年7月10日までに求められている。
作業草案としての公開は、 W3Cおよびそのメンバーによる承認を意味するものではない。
これは草案文書であり、いつでも他の文書によって更新、置換、または廃止される可能性がある。 この文書を進行中の作業以外のものとして引用することは不適切である。
この文書は、 W3C 特許 ポリシーの下で運営されるグループにより作成された。 W3Cは、 グループの成果物に関連して行われた特許開示の公開一覧 を維持している。そのページには、 特許を開示するための手順も含まれている。個人が、当該個人が 必須クレームを含むと信じる 特許について実際の知識を有する場合、その個人は W3C特許ポリシー第6節に従って情報を開示しなければならない。
この文書は、 2021年11月2日版W3Cプロセス文書に準拠している。
この節は非規範的である。
この仕様モジュールにより、制作者は要素レベルでコンテンツに関する意味情報を追加できる。 これは、個々の利用者に対してメッセージの優先度を示したり、利用者が完了する必要のあるタスクを プログラム的に列挙したりするためであり、記憶に課題のある利用者が以前に完了した手順を 追跡できるようにする。異なる利用者の異なるニーズを満たすために、複数の画面表示 （変換）がサポートされることが想定されている。ヘルパーアプリまたはサードパーティ・ツールによって生成される 最終的な表示は、最終的には利用者の構成設定によって定義される。
この文書は、WAI-Adapt解説の拡張である、パーソナライズされたツールのプロパティの例を列挙する。
これには、
messageimportance、messagefrom、messagecontext、
messagetime、およびstepindicatorのプロパティが含まれる。
WAI-Adaptは、コンテンツに注釈を付けるための一連のプロパティと値を定義する。これらのプロパティを コンテンツおよびセマンティクスに適用する具体的な仕組みは、まだ決定されていない。複数の アプローチが検討中である。将来の草案では進展が示される予定である。提案されたプロパティの理解を 助けるため、この文書では、コンテンツに適用されたWAI-Adaptの例を多数提供し、 接頭辞「data-」で始まる属性を示している。この接頭辞は最終的なアプローチとして 決定されたものではないが、例を説明する方法として使用されている。
WAI-Adapt: ツール・モジュールは、WAI-Adapt技術仕様の3番目かつ最後の部分であり、 追加の意味情報でWebコンテンツをマークアップするために使用できるWAI-Adaptのセマンティクスと語彙を 提供し、利用者のパーソナライズ設定または選好に基づいて、ユーザー・エージェントがさまざまな利用者シナリオに コンテンツを拡張または適応できるようにする。ツール・モジュールは、メッセージの重要度（フィルタリング用）に関する 追加情報を提供し、複数ステップの活動を追跡することでWebコンテンツを強化する。 ユーザー・エージェントは、これらのセマンティクスを使用して、利用者のシナリオに合わせてコンテンツを 拡張または適応できる。たとえば、画面上のメッセージの優先順位付けやフィルタリングを可能にする。 これにより、不要な注意散漫を管理する方法を支援することで、多様なニーズをもつ利用者が コンテンツをフィルタリングしやすくなる。
WAI-Adapt: コンテンツ・モジュールのすべての語彙は、プロパティとその値で構成される。詳しくは、 WAI-Adapt解説を参照されたい。
この文書に含まれる語彙の実装は、実装wikiページで入手できる。
プロパティは、語彙によってサポートされるWAI-Adapt型の主要な単位である。あるプロパティは、 特定の種類のWAI-Adaptをサポートする。そのプロパティは、特定のコンテンツ片では一度だけ 使用されるが、異なるニーズに対応するために、同じコンテンツ片に複数の異なるプロパティを 使用できる。
値は、プロパティに対する具体的なパーソナライズ情報を提供する。各プロパティで使用可能な値は、 モジュール内のプロパティ定義で詳述される。一部のプロパティでは、値が事前定義された 可能な値のリストから来る必要があり、他のプロパティでは任意の文字列を受け入れることができ、 また複数の値を受け入れるものもある。属性値は、次のいずれかの型であり得る：
この仕様における属性および値は、アクセシビリティ・ツリーに公開されるセマンティクスを 上書きするのではなく、それらを拡張するものであることに注意されたい。 要素のセマンティクスと 属性値が競合する場合、検証アルゴリズムは警告を発するべきであるが、 エラーにはすべきではない。
WAI-Adaptの要件では、ユースケースと 要件を説明している。このモジュールは、利用者支援ツールに関連する要件を満たすための プロパティを提供する。
この文書では、さまざまな認知障害および関連する利用者ニーズに関係する、多数の特定の用語を使用する。 これらの用語は、Cognitive and Learning Disabilities Accessibility Task Forceによって定義されている。具体的な定義については、COGA用語集を参照されたい。
利用者が完了する必要のある一連のタスクがある場合は常に、定義済みのstepindicator値を
使用するべきである。これにより、記憶に課題のある利用者が、以前に完了した手順を
追跡できる。
既定値はないことに注意されたい。
なお、これらの定義済みの値を適用する具体的な仕組みは決定されていない：
<div data-stepindicator="book trip">
<div data-status="complete" aria-label="select flight" data-step="1" data-steplocation="uri" />
<div data-status="current" aria-label="book hotel" data-step="2" data-steplocation="uri" />
<div data-status="" aria-label="book car" data-step="3" data-steplocation="uri" />
<div data-status="" aria-label="purchase trip" data-step="4" steplocation="uri" />
</div>
または、ステップ番号はDOMから暗黙的に示すことができる
<div data-stepindicator="book trip">
<div data-status="complete" aria-labelledby="select flight">
<a href="uri">フライトを選択</a>
</div>
<div data-status="current" aria-labelledby="book hotel">
<a href="uri">ホテルを予約</a>
</div>
<div data-status="" aria-labelledby="book car">
<a href="uri">車を予約</a>
</div>
<div data-status="" aria-labelledby="purchase trip">
<a href="uri">旅行を購入</a>
</div>
</div>messageimportance属性は、メッセージの優先度を示すために使用される。
これは、メッセージに圧倒される人が、優先度の低いメッセージを除外し、
重要度の高いメッセージに集中するうえで役立つ可能性がある。
サポートされる値: low、medium（既定）、
critical
これらの定義済みの値を適用する具体的な仕組みは決定されていない
<div role="alert" data-messageimportance="medium">
明日はあなたの娘の誕生日です
</div>| 特性 | 値 |
|---|---|
| 関連概念: | SVG [SVG2] および DOM [DOM4] active |
| 使用されるロール: | 基礎マークアップのすべての要素 |
| 継承先ロール: | プレースホルダー |
| 値: | token |
| 値 | 説明 |
|---|---|
| critical | メッセージがcriticalであるためには、緊急であり、 かつ利用者が重要だと考える可能性が非常に高い内容である必要がある。たとえば、システムが、 更新をインストールするために1分後に再起動すると通知する場合である。 |
| medium（既定） | 利用者の都合のよいときに注意を要する重要なメッセージ。 たとえば、比較的重要なチャットメッセージ。 |
| low | 時間的に敏感な注意を必要としないメッセージ。たとえば、 典型的なチャットメッセージ。 |
messagefrom属性は、利用者が受け取るメッセージが誰からのものかを
識別しやすくするために使用できる。
サポートされる値: メッセージの送信者を識別する文字列値。 複数の名前を使用する場合は、コンマで区切ることができる。
既定値はないことに注意されたい。
これらの定義済みの値を適用する具体的な仕組みは決定されていない
<div role="alert" data-messageimportance="low"
data-messagefrom="lisa seeman, lseeman">
あなたがレビューするために、GitHubに新しいバージョンを投稿しました
</div>これらの定義済みの値を適用する具体的な仕組みは決定されていない
| 特性 | 値 |
|---|---|
| 関連概念: | SVG [SVG2] および DOM [DOM4] active |
| 使用されるロール: | 基礎マークアップのすべての要素 |
| 継承先ロール: | プレースホルダー |
| 値: | string text |
messagecontext属性は、メッセージがどこから来たものかを明確にするのに役立つ。
メッセージが誰からのものか、およびそのメッセージがどの文脈で書かれたものかを知ることは、
受け取ったメッセージの意味を理解するうえでどちらも重要である。
サポートされる値: このメッセージを関連あるものにする 場所を識別する文字列値。典型的な値は「home」および「work」である。複数の 場所が関連する場合は、コンマで区切ることができる。
既定値はないことに注意されたい。
これらの定義済みの値を適用する具体的な仕組みは決定されていない
<div role="alert"
data-messageimportance="low"
data-messagefrom="lisa seeman, lseeman"
data-messagecontext="work">
あなたがレビューするために、GitHubに新しいバージョンを投稿しました
</div>| 特性 | 値 |
|---|---|
| 関連概念: | SVG [SVG2] および DOM [DOM4] active |
| 使用されるロール: | 基礎マークアップのすべての要素 |
| 継承先ロール: | プレースホルダー |
| 値: | string text |
messagetime属性は、メッセージがいつ送信されたかを明確にするのに役立つ。
サポートされる値: 24時間の日付時刻形式。 DD.MM.YEAR.HOUR.MM - DD.MM.YEAR.HOUR.MM。2番目の日付は任意の排他的な 有効期限である。
既定値はないことに注意されたい。
これらの定義済みの値を適用する具体的な仕組みは決定されていない
@@1-line description
<div role="alert"
data-messageimportance="medium"
data-messagefrom="my calender"
data-messagecontext="work"
data-messagetime="10.02.2017.00.00-16.02.2017.00.00">
今週中に運転免許証を更新してください
</div>
<div role="alert"
data-messageimportance="critical"
data-messagefrom="my calender"
data-messagecontext="work"
data-messagetime="16.02.2017.00.00">
できるだけ早く運転免許証を更新してください
</div>これらの定義済みの値を適用する具体的な仕組みは決定されていない
| 特性 | 値 |
|---|---|
| 関連概念: | SVG [SVG2] および DOM [DOM4] active |
| 使用されるロール: | 基礎マークアップのすべての要素 |
| 継承先ロール: | プレースホルダー |
| 値: | string text |
この仕様は、コンテンツに関する文脈情報 を文書に追加するものであり、 セキュリティに影響を与えるべきではない。
この仕様自体は個人の選好および個人情報を公開しないが、われわれの意味情報に基づいて動作する サードパーティのユーザー・エージェントまたはプロキシ・サーバーは、特定の利用者にコンテンツを 提示する方法に関する 個人の選好を保存する必要がある可能性がある。あらゆるユーザー・エージェントまたはプロキシ・サーバーは、 すべての個人の選好および個人情報を保護するためのベストプラクティスを実装することが推奨される。
利用者設定をもつすべてのユーザー・エージェントは、利用者情報を安全に保つための ベストプラクティスに従うことが推奨される。
この節は非規範的である。
次の人々がこの文書の開発に貢献した。
この公開文書は、米国連邦資金により、Health and Human Services、 National Institute on Disability, Independent Living, and Rehabilitation Research（NIDILRR）から、 契約番号HHSP23301500054Cの下で一部資金提供を受けたものである。この公開文書の内容は、 必ずしも米国保健福祉省の見解または方針を反映するものではなく、商号、 商業製品、または組織への言及は、米国政府による支持を意味するものではない。この プロジェクトの一部の作業は、助成契約番号780529および643399の下で、欧州連合のHorizon 2020研究・イノベーション プログラムからも資金提供を受けている。