ARIA in HTML 日本語訳

W3C Working Draft

This version:
https://www.w3.org/TR/2020/WD-html-aria-20200813/
Latest published version:
https://www.w3.org/TR/html-aria/
Latest editor's draft:
https://w3c.github.io/html-aria/
Previous version:
https://www.w3.org/TR/2020/WD-html-aria-20200811/
Editors:
Steve Faulkner (The Paciello Group)
Scott O'Hara (The Paciello Group)
Participate:
GitHub w3c/html-aria
バグを送信する
Commit history
Pull requests

概要

この仕様は、[HTML]要素のAccessible Rich Internet Applications (WAI-ARIA) 1.1およびDigital Publishing WAI-ARIA Module 1.0属性の使用に対するウェブ開発者の規則(著者適合性要件)を定義する。また、適合チェックツールに対する要件も定義する。

この文書の位置付け

この節は、公開時点におけるこの文書のステータスについて説明する。他の文書がこの文書に取って代わるかもしれない。W3Cが現在公開しているリストとテクニカルレポートの最新版は、W3C technical reports index at https://www.w3.org/TR/で見つけることができる。

ARIA in HTMLは、[HTML]仕様のモジュールである。この仕様モジュールが参照するが明示的に定義されない、すべてのHTML機能、適合性要件、または用語は、HTML仕様で定義される。

この文書は草案であり、コンテンツは予告なし変更されることがある。

この文書は、Working DraftとしてWeb Applications Working Groupによって発行された。この文書は、W3C勧告になることを意図する。

GitHub Issuesはこの仕様の議論のために優先される。また、メーリングリストにコメントを送ることもできる。public-html@w3.orgアーカイブ)に送信されたい。

Working Draftでの公開はW3Cメンバーの支持を意味するものではない。この文書は草案であり、いつでも更新、他の文書による置き換えや廃止扱いにされうる。進行中の作業以外のものとしてこの文書を引用することは不適切である。

この文書はW3C特許ポリシーの下で活動するグループによって作成された。W3Cは、グループの成果物に関するあらゆる開示特許の公開リストを管理する。ここには、特許開示にあたっての指示も含まれている。特許について十分に知識のある人物が、仕様にEssential Claim(s)が認められると判断した場合は、W3C特許ポリシーの第6章に従い情報を開示する必要がある。

この文書は、2019年3月1日のW3Cプロセス文書によって管理される。

1. ARIA in HTMLの使用に対するウェブ開発者の要件

著者は、強いネイティヴセマンティックスと衝突するまたは与えられるHTML要素の暗黙のARIAセマンティックスと等価である場合を除いた、[wai-aria-1.1]で説明される要求にしたがって、HTML要素ARIA roleおよびaria-*属性を使用してもよい。この制約は、開発者が文書の実際のUIを表すことのない無意味なユーザーインターフェイス情報(UI)を支援技術製品に報告させることから防ぐことを意図する。

ウェブ開発者は、§ 2. HTMLにおけるARIA属性の使用に対する文書適合性の表に示されるセマンティックスと矛盾する方法でARIA roleおよびaria-*属性を使用してはならない。ウェブ開発者は、表に定義される暗黙のARIAセマンティックスと一致する値にARIA roleおよびaria-*属性を設定することは推奨されない。そうすることは不必要であり、意図しない結果につながる可能性がある。

2. ARIA in HTMLの使用に対する文書適合性要件

次の表は、HTML文書でARIAマークアップを使用するための要素ごとの文書適合基準要件を規定し、HTML Accessibility API Mappings 1.0]仕様で定義されるHTML要素に適用される暗黙のARIAセマンティックスについて説明する。

1列目のセルでそれぞれの言語機能(要素または属性)は同じ行の2列目のセルで与えられるARIAセマンティックス(ロール、ステート、およびプロパティ)を意味する。3列目のセルは、使用してもよいARIAロールの値とaria-*属性を定義する。3列目のセルにすべてのroleという用語が含まれる場合、暗黙的なARIAセマンティクスroleの値とは別のroleの値を使用してもよいことを示す。3列目のセルに roleなしという用語が含まれている場合、著者はHTML要素の暗黙のARIAセマンティクスまたはネイティヴセマンティクスを上書きしてはならないことを示す。

Note

暗黙のARIAセマンティクスと一致する ARIA role および/またはaria-*属性を設定することは推奨されないが、状況によっては、これらの属性を明示的に設定すると役立つことがある。 たとえば、特定の暗黙のセマンティクスを欠くユーザーエージェントなどである。

HTMLの機能によるARIA属性利用の規則
HTML feature

暗黙のARIAセマンティクス(これらをマークアップで明示的に割り当てることは推奨されない

使用してもよいARIAロール、ステートおよびプロパティ
hrefをもつa role=link

ロール:button, checkbox, menuitem, menuitemcheckbox, menuitemradio, option, radio, switch, tabまたはtreeitem

DPubロール:doc-backlink, doc-biblioref, doc-glossref, doc-noteref

グローバルaria-*属性ならびに許可されるロールおよび暗黙のロール(もしあれば)に適用されるすべてのaria-*属性

hrefをもたないa 対応するロールなし

すべてのrole

グローバルaria-*属性ならびに許可されるロールおよび暗黙のロール(もしあれば)に適用されるすべてのaria-*属性

abbr 対応するロールなし

すべてのrole

グローバルaria-*属性ならびに許可されるロールおよび暗黙のロール(もしあれば)に適用されるすべてのaria-*属性

address 対応するロールなし

すべてのrole

グローバルaria-*属性ならびに許可されるロールおよび暗黙のロール(もしあれば)に適用されるすべてのaria-*属性

hrefをもつarea role=link

roleなし

グローバルaria-*属性およびlinkロールに受け入れ可能なすべてのaria-*属性

hrefをもたないarea 対応するロールなし

roleなし

グローバルaria-*属性ならびに許可されるロールおよび暗黙のロール(もしあれば)に適用されるすべてのaria-*属性

article role=article

ロール:feed, presentation, none, document, application, mainまたはregion.

グローバルaria-*属性ならびに許可されるロールおよび暗黙のロール(もしあれば)に適用されるすべてのaria-*属性

aside role=complementary

ロール:feed, note, presentation, none, regionまたはsearch.

DPubロール:doc-dedication, doc-example, doc-footnote, doc-pullquote, doc-tip

グローバルaria-*属性ならびに許可されるロールおよび暗黙のロール(もしあれば)に適用されるすべてのaria-*属性

audio 対応するロールなし

ロール:application

グローバルaria-*属性およびapplicationロールに受け入れ可能なすべてのaria-*属性

自律カスタム要素 対応するロールなし

すべてのrole

グローバルaria-*属性ならびに許可されるロールおよび暗黙のロール(もしあれば)に適用されるすべてのaria-*属性

b 対応するロールなし すべてのrole

グローバルaria-*属性ならびに許可されるロールおよび暗黙のロール(もしあれば)に適用されるすべてのaria-*属性

base 対応するロールなし roleまたはaria-*属性なし
bdi 対応するロールなし すべてのrole

グローバルaria-*属性ならびに許可されるロールおよび暗黙のロール(もしあれば)に適用されるすべてのaria-*属性

bdo 対応するロールなし すべてのrole

グローバルaria-*属性ならびに許可されるロールおよび暗黙のロール(もしあれば)に適用されるすべてのaria-*属性

blockquote 対応するロールなし

すべてのrole

グローバルaria-*属性ならびに許可されるロールおよび暗黙のロール(もしあれば)に適用されるすべてのaria-*属性

body role=document

roleなし

グローバルaria-*属性およびdocumentロールに受け入れ可能なすべてのaria-*属性

br 対応するロールなし

ロール:presentationまたはnone.

グローバルaria-*属性ならびに許可されるロールおよび暗黙のロール(もしあれば)に適用されるすべてのaria-*属性

button role=button

ロール:checkbox, link,menuitem, menuitemcheckbox, menuitemradio, option, radio, switchまたはtab.

グローバルaria-*属性ならびに許可されるロールおよび暗黙のロール(もしあれば)に適用されるすべてのaria-*属性

canvas 対応するロールなし

すべてのrole

グローバルaria-*属性ならびに許可されるロールおよび暗黙のロール(もしあれば)に適用されるすべてのaria-*属性

caption 対応するロールなし

roleなし

グローバルaria-*属性

cite 対応するロールなし すべてのrole

グローバルaria-*属性ならびに許可されるロールおよび暗黙のロール(もしあれば)に適用されるすべてのaria-*属性

code 対応するロールなし すべてのrole

グローバルaria-*属性ならびに許可されるロールおよび暗黙のロール(もしあれば)に適用されるすべてのaria-*属性

col

対応するロールなし roleまたはaria-*属性なし

colgroup

対応するロールなし roleまたはaria-*属性なし
data 対応するロールなし すべてのrole

グローバルaria-*属性ならびに許可されるロールおよび暗黙のロール(もしあれば)に適用されるすべてのaria-*属性

datalist role=listbox

roleなし

グローバルaria-*属性およびlistboxロールに受け入れ可能なすべてのaria-*属性。

dd role=definition

roleなし

グローバルaria-*属性およびdefinitionロールに受け入れ可能なすべてのaria-*属性

del 対応するロールなし

すべてのrole

グローバルaria-*属性ならびに許可されるロールおよび暗黙のロール(もしあれば)に適用されるすべてのaria-*属性

dfn role=term すべてのrole

グローバルaria-*属性ならびに許可されるロールおよび暗黙のロール(もしあれば)に適用されるすべてのaria-*属性

details role=group

roleなし

グローバルaria-*属性およびgroupロールに受け入れ可能なすべてのaria-*属性

dialog role=dialog

ロール:alertdialog

グローバルaria-*属性およびdialogロールに受け入れ可能なすべてのaria-*属性

div 対応するロールなし

すべてのrole

グローバルaria-*属性ならびに許可されるロールおよび暗黙のロール(もしあれば)に適用されるすべてのaria-*属性

dl 対応するロールなし

ロール:group, list, presentationまたはnone

グローバルaria-*属性ならびに許可されるロールおよび暗黙のロール(もしあれば)に適用されるすべてのaria-*属性

dt role=term

ロール:listitem

グローバルaria-*属性ならびに許可されるロールおよび暗黙のロール(もしあれば)に適用されるすべてのaria-*属性

em 対応するロールなし

すべてのrole

グローバルaria-*属性ならびに許可されるロールおよび暗黙のロール(もしあれば)に適用されるすべてのaria-*属性

embed 対応するロールなし

ロール:application, document, img, presentationまたはnone.

グローバルaria-*属性ならびに許可されるロールおよび暗黙のロール(もしあれば)に適用されるすべてのaria-*属性

fieldset role=group

ロール:none, presentationまたはradiogroup.

グローバルaria-*属性ならびに許可されるロールおよび暗黙のロール(もしあれば)に適用されるすべてのaria-*属性

figcaption 対応するロールなし

ロール:group, presentationまたはnone

グローバルaria-*属性ならびに許可されるロールおよび暗黙のロール(もしあれば)に適用されるすべてのaria-*属性

figure role=figure

figurefigcaption子孫を持たない場合:
ロール:すべてのrole

figurefigcaption子孫を持つ場合:
ロール:roleなし

グローバルaria-*属性ならびに許可されるロールおよび暗黙のロール(もしあれば)に適用されるすべてのaria-*属性

form form要素がアクセシブルな名前を持つ場合、role=form。そうでなければ、対応するロールなし

ロール:search, noneまたはpresentation

グローバルaria-*属性ならびに許可されるロールおよび暗黙のロール(もしあれば)に適用されるすべてのaria-*属性

フォーム関連カスタム要素 対応するロールなし

ロール:application, button, checkbox, combobox, group, listbox, progressbar, radio, radiogroup, searchbox, slider, spinbutton, switchまたはtextbox

グローバルaria-*属性ならびに許可されるロールおよび暗黙のロール(もしあれば)に適用されるすべてのaria-*属性

h1 ‐ h6 aria-level = 正の整数をもつ、role=heading

ロール:none, presentationまたはtab.

DPubロール:doc-subtitle

グローバルaria-*属性ならびに許可されるロールおよび暗黙のロール(もしあれば)に適用されるすべてのaria-*属性

head 対応するロールなし roleまたはaria-*属性なし
header article, aside, main, navもしくはsection要素の子孫でない、またはrole=article, complementary, main, navigationもしくはregionをもつ要素でない場合、role=banner。そうでなければ、対応するロールなし

ロール:group, noneまたはpresentation

DPubロール:doc-footnote

グローバルaria-*属性ならびに許可されるロールおよび暗黙のロール(もしあれば)に適用されるすべてのaria-*属性

hgroup 対応するロールなし

すべてのrole

グローバルaria-*属性ならびに許可されるロールおよび暗黙のロール(もしあれば)に適用されるすべてのaria-*属性

hr role=separator

ロール:groupまたはpresentation

DPubロール:doc-pagebreak

グローバルaria-*属性およびseparatorロールに受け入れ可能なすべてのaria-*属性

html 対応するロールなし roleまたはaria-*属性なし
i 対応するロールなし

すべてのrole

グローバルaria-*属性ならびに許可されるロールおよび暗黙のロール(もしあれば)に適用されるすべてのaria-*属性

iframe 対応するロールなし

ロール:application, document, img, noneまたはpresentation

グローバルaria-*属性ならびに許可されるロールおよび暗黙のロール(もしあれば)に適用されるすべてのaria-*属性

alt="テキスト"をもつimg role=img

ロール:button, checkbox, link, menuitem, menuitemcheckbox, menuitemradio, option, progressbar, scrollbar, separator, slider, switch, tabまたはtreeitem

DPubロール:doc-cover

グローバルaria-*属性ならびに許可されるロールおよび暗黙のロール(もしあれば)に適用されるすべてのaria-*属性

alt=""をもつimg 対応するロールなし

ロール:groupまたはpresentation

aria-hidden以外のaria-*属性ではない

alt属性をもたないimg role=img

他の方法で著者定義のアクセシブルな名前が提供されない場合:roleばしaria-hidden以外のaria-*属性なし

そうでなければ、imgが著者に定義されたアクセシブルな名前を持つ場合、img alt="テキスト"を参照。

input type=button role=button

ロール:link, menuitem, menuitemcheckbox, menuitemradio, option, radio, switchまたはtab

グローバルaria-*属性ならびに許可されるロールおよび暗黙のロール(もしあれば)に適用されるすべてのaria-*属性

input type=checkbox

role=checkbox

ロール:buttonaria-pressedとともに使用される場合), menuitemcheckbox, optionまたはswitch

グローバルaria-*属性ならびに許可されるロールおよび暗黙のロール(もしあれば)に適用されるすべてのaria-*属性

注: HTML checked属性は、type=checkboxで使用するときのmenuitemcheckbox, optionまたは switcharia-checked属性の代わりに使用できる。

input type=color 対応するロールなし

roleなし

グローバルaria-*属性

input type=date 対応するロールなし

roleなし

グローバルaria-*属性

input type=datetime-local 対応するロールなし

roleなし

グローバルaria-*属性

list属性のないinput type = email role=textbox

roleなし

グローバルaria-*属性およびtextboxロールに受け入れ可能なすべてのaria-*属性

input type=file 対応するロールなし

roleなし

グローバルaria-*属性

input type=hidden 対応するロールなし roleまたはaria-*属性なし
input type=image role=button

ロール:link, menuitem, menuitemcheckbox, menuitemradio, radioまたはswitch

グローバルaria-*属性ならびに許可されるロールおよび暗黙のロール(もしあれば)に適用されるすべてのaria-*属性

input type=month 対応するロールなし

roleなし

グローバル aria-*属性

input type=number role=spinbutton

roleなし

グローバルaria-*属性およびspinbuttonロールに受け入れ可能なすべてのaria-*属性

input type=password 対応するロールなし

roleなし

グローバルaria-*属性およびaria-required

input type=radio role=radio

ロール:menuitemradio

グローバルaria-*属性およびmenuitemradioロールに受け入れ可能なすべてのaria-*属性

注: HTML checked属性は、type=radioで使用するときのmenuitemradioaria-checked属性の代わりに使用できる。

input type=range role=slider

roleなし

グローバルaria-*属性およびsliderロールに受け入れ可能なすべてのaria-*属性

input type=reset role=button

roleなし

グローバルaria-*属性およびbuttonロールに受け入れ可能なすべてのaria-*属性

input type=submit role=button

roleなし

グローバルaria-*属性およびbuttonロールに受け入れ可能なすべてのaria-*属性

list属性のないinput type=tel role=textbox

roleなし

グローバルaria-*属性およびtextboxロールに受け入れ可能なすべてのaria-*属性

list属性のないinput type=text role=textbox

ロール:combobox, searchboxまたはspinbutton

グローバルaria-*属性および許可されるロールに受け入れ可能なすべてのaria-*属性

list>属性をもつinput type=text, search, tel, url,またはemail role=combobox

roleなし

グローバルaria-*属性およびcomboboxロールに受け入れ可能なすべてのaria-*属性

input type=time 対応するロールなし

roleなし

グローバル aria-*属性

list属性のないinput type=url role=textbox

roleなし

グローバルaria-*属性およびtextboxロールに受け入れ可能なすべてのaria-*属性

input type=week 対応するロールなし

roleなし

グローバル aria-*属性

ins 対応するロールなし

すべてのrole

グローバルaria-*属性ならびに許可されるロールおよび暗黙のロール(もしあれば)に適用されるすべてのaria-*属性

kbd 対応するロールなし

すべてのrole

グローバルaria-*属性ならびに許可されるロールおよび暗黙のロール(もしあれば)に適用されるすべてのaria-*属性

label 対応するロールなし

roleなし

グローバル aria-*属性

legend 対応するロールなし

roleなし

グローバル aria-*属性

li role=listitem

ロール:menuitem, menuitemcheckbox, menuitemradio, option, none, presentation, radio, separator, tabまたはtreeitem

DPubロール:doc-biblioentry, doc-endnote

グローバルaria-*属性ならびに許可されるロールおよび暗黙のロール(もしあれば)に適用されるすべてのaria-*属性

main role=main

roleなし

グローバルaria-*属性およびmainロールに受け入れ可能なすべてのaria-*属性

map 対応するロールなし roleまたはaria-*属性なし
math role=math

roleなし

グローバルaria-*属性およびmathロールに受け入れ可能なすべてのaria-*属性

mark 対応するロールなし

すべてのrole

グローバルaria-*属性ならびに許可されるロールおよび暗黙のロール(もしあれば)に適用されるすべてのaria-*属性

menu role=list

ロール:directory, group, listbox, menu, menubar, none, presentation, radiogroup, tablist, toolbarまたはtree

グローバルaria-*属性ならびに許可されるロールおよび暗黙のロール(もしあれば)に適用されるすべてのaria-*属性

meta 対応するロールなし roleまたはaria-*属性なし
meter 対応するロールなし

roleなし

グローバル aria-*属性

nav role=navigation

Roles: group, menu, menubar, none, presentation or tablist.

DPubロール:doc-index, doc-pagelist, doc-toc

グローバルaria-*属性ならびに許可されるロールおよび暗黙のロール(もしあれば)に適用されるすべてのaria-*属性

noscript 対応するロールなし roleまたはaria-*属性なし
object 対応するロールなし

ロール:application, documentまたはimg

グローバルaria-*属性ならびに許可されるロールおよび暗黙のロール(もしあれば)に適用されるすべてのaria-*属性

ol role=list

ロール:directory, group, listbox, menu, menubar, none, presentation, radiogroup, tablist, toolbarまたはtree

グローバルaria-*属性ならびに許可されるロールおよび暗黙のロール(もしあれば)に適用されるすべてのaria-*属性

optgroup role=group

roleなし

グローバルaria-*属性およびgroupロールに受け入れ可能なすべてのaria-*属性

オプションリストで存在するまたはdatalist要素で提案を表すoption要素 role=option

roleなし

グローバルaria-*属性およびoptionロールに受け入れ可能なすべてのaria-*属性

output role=status

すべてのrole

グローバルaria-*属性ならびに許可されるロールおよび暗黙のロール(もしあれば)に適用されるすべてのaria-*属性

p 対応するロールなし

すべてのrole

グローバルaria-*属性ならびに許可されるロールおよび暗黙のロール(もしあれば)に適用されるすべてのaria-*属性

param 対応するロールなし roleまたはaria-*属性なし
picture 対応するロールなし roleまたはaria-*属性なし
pre 対応するロールなし

すべてのrole

グローバルaria-*属性ならびに許可されるロールおよび暗黙のロール(もしあれば)に適用されるすべてのaria-*属性

progress role=progressbar

roleなし

グローバルaria-*属性およびprogressbarロールに受け入れ可能なすべてのaria-*属性

q 対応するロールなし

すべてのrole

グローバルaria-*属性ならびに許可されるロールおよび暗黙のロール(もしあれば)に適用されるすべてのaria-*属性

rp 対応するロールなし

すべてのrole

グローバルaria-*属性ならびに許可されるロールおよび暗黙のロール(もしあれば)に適用されるすべてのaria-*属性

rt 対応するロールなし

すべてのrole

グローバルaria-*属性ならびに許可されるロールおよび暗黙のロール(もしあれば)に適用されるすべてのaria-*属性

ruby 対応するロールなし

すべてのrole

グローバルaria-*属性ならびに許可されるロールおよび暗黙のロール(もしあれば)に適用されるすべてのaria-*属性

s 対応するロールなし

すべてのrole

グローバルaria-*属性ならびに許可されるロールおよび暗黙のロール(もしあれば)に適用されるすべてのaria-*属性

samp 対応するロールなし

すべてのrole

グローバルaria-*属性ならびに許可されるロールおよび暗黙のロール(もしあれば)に適用されるすべてのaria-*属性

script 対応するロールなし roleまたはaria-*属性なし
section section要素がアクセシブルな名前を持つ場合、role=region。そうでなければ、対応するロールなし

ロール:alert, alertdialog, application, banner, complementary, contentinfo, dialog, document, feed, log, main, marquee, navigation, none, note, presentation, search, statusまたはtabpanel

DPubロール:doc-abstract, doc-acknowledgments, doc-afterword, doc-appendix, doc-bibliography, doc-chapter, doc-colophon, doc-conclusion, doc-credit, doc-credits, doc-dedication, doc-endnotes, doc-epigraph, doc-epilogue, doc-errata, doc-example, doc-foreword, doc-glossary, doc-index, doc-introduction, doc-notice, doc-pagelist, doc-part, doc-preface, doc-prologue, doc-pullquote, doc-qna, doc-toc

グローバルaria-*属性ならびに許可されるロールおよび暗黙のロール(もしあれば)に適用されるすべてのaria-*属性

selectmultiple属性をもたず、かつ1より大きい値を持つsize属性がない) role=combobox

ロール:menu

グローバルaria-*属性およびlistboxまたはmenuロールに受け入れ可能なすべてのaria-*属性

selectmultiple属性、または1より大きい値を持つsize属性をもつ) role=listbox

roleなし

グローバルaria-*属性およびlistboxロールに受け入れ可能なすべてのaria-*属性。

slot 対応するロールなし roleまたはaria-*属性なし
small 対応するロールなし

すべてのrole

グローバルaria-*属性ならびに許可されるロールおよび暗黙のロール(もしあれば)に適用されるすべてのaria-*属性

source 対応するロールなし roleまたはaria-*属性なし
span 対応するロールなし

すべてのrole

グローバルaria-*属性ならびに許可されるロールおよび暗黙のロール(もしあれば)に適用されるすべてのaria-*属性

strong 対応するロールなし

すべてのrole

グローバルaria-*属性ならびに許可されるロールおよび暗黙のロール(もしあれば)に適用されるすべてのaria-*属性

style 対応するロールなし roleまたはaria-*属性なし
SVG 対応するロールなし

ロール:application, documentまたはimg

グローバルaria-*属性ならびに許可されるロールおよび暗黙のロール(もしあれば)に適用されるすべてのaria-*属性

sub 対応するロールなし

すべてのrole

グローバルaria-*属性ならびに許可されるロールおよび暗黙のロール(もしあれば)に適用されるすべてのaria-*属性

summary role=button

roleなし

グローバルaria-*属性およびbuttonロールに受け入れ可能なすべてのaria-*属性

sup 対応するロールなし

すべてのrole

グローバルaria-*属性ならびに許可されるロールおよび暗黙のロール(もしあれば)に適用されるすべてのaria-*属性

table role=table

すべてのrole

グローバルaria-*属性ならびに許可されるロールおよび暗黙のロール(もしあれば)に適用されるすべてのaria-*属性

tbody role=rowgroup

すべてのrole

グローバルaria-*属性ならびに許可されるロールおよび暗黙のロール(もしあれば)に適用されるすべてのaria-*属性

template 対応するロールなし roleまたはaria-*属性なし
textarea role=textbox

roleなし

グローバルaria-*属性およびtextboxロールに受け入れ可能なすべてのaria-*属性

tfoot role=rowgroup

すべてのrole

グローバルaria-*属性ならびに許可されるロールおよび暗黙のロール(もしあれば)に適用されるすべてのaria-*属性

thead role=rowgroup

すべてのrole

グローバルaria-*属性ならびに許可されるロールおよび暗黙のロール(もしあれば)に適用されるすべてのaria-*属性

time 対応するロールなし

すべてのrole

グローバルaria-*属性ならびに許可されるロールおよび暗黙のロール(もしあれば)に適用されるすべてのaria-*属性

title 対応するロールなし roleまたはaria-*属性なし
td

table要素の子孫の場合のrole=cell

role=gridまたはtreegridをもつtable要素の子孫の場合は、role=gridcell

祖先table要素role=tablegrid、またはtreegridを持つ場合、roleなし。 それ以外の場合はすべてのrole

グローバルaria-*属性ならびに許可されるロールおよび暗黙のロール(もしあれば)に適用されるすべてのaria-*属性

th

table要素の子孫の場合、role=columnheaderまたはrowheaderまたはcell(ヘッダーでない場合)。

role=gridまたはtreegridをもつtable要素の子孫の場合、role=columnheaderまたはrowheaderまたはgridcell(ヘッダーでない場合)。

祖先table要素role=tablegrid、またはtreegridを持つ場合、roleなし。 それ以外の場合はすべてのrole

グローバルaria-*属性ならびに許可されるロールおよび暗黙のロール(もしあれば)に適用されるすべてのaria-*属性

tr role=row

祖先table要素role=tablegrid、またはtreegridを持つ場合、roleなし。 それ以外の場合はすべてのrole

グローバルaria-*属性ならびに許可されるロールおよび暗黙のロール(もしあれば)に適用されるすべてのaria-*属性

track 対応するロールなし roleまたはaria-*属性なし
u 対応するロールなし

すべてのrole

グローバルaria-*属性ならびに許可されるロールおよび暗黙のロール(もしあれば)に適用されるすべてのaria-*属性

ul role=list

ロール:directory, group, listbox, menu, menubar, none, presentation, radiogroup, tablist, toolbarまたはtree

グローバルaria-*属性ならびに許可されるロールおよび暗黙のロール(もしあれば)に適用されるすべてのaria-*属性

var 対応するロールなし

すべてのrole

グローバルaria-*属性ならびに許可されるロールおよび暗黙のロール(もしあれば)に適用されるすべてのaria-*属性

video 対応するロールなし

ロール:application

グローバルaria-*属性およびapplicationロールに受け入れ可能なすべてのaria-*属性

wbr 対応するロールなし

すべてのrole

グローバルaria-*属性ならびに許可されるロールおよび暗黙のロール(もしあれば)に適用されるすべてのaria-*属性

disabled属性をもつ要素 aria-disabled="true"

HTMLで許可されるdisabled属性であるすべての要素上のdisabled属性を使用する。

HTMLでdisabled属性を持つことが許可されない要素に対してのみaria-disabled属性を使用する

placeholder属性をもつ要素 aria-placeholder=""

HTMLでplaceholder属性が許可される要素上のplaceholder属性を使用する。

HTMLでplaceholder属性を持つことが許可されない要素に対してのみaria-placeholder属性を使用する。

required属性をもつ要素 aria-required="true"

HTMLで許可されるrequired属性であるすべての要素上のaria-required属性を使用する。required属性が設定されている場合は、falseに設定してはならない

aria-required属性を許可するARIAロールを持つ要素にも使用してもよい

readonly属性をもつ要素 aria-readonly="true"

HTMLで許可されるreadonly属性であるすべての要素上のreadonly属性を使用する。

HTMLでreadonly属性を持つことが許可されない要素に対してのみaria-readonly属性を使用する

hidden属性をもつ要素 aria-hidden="true"

すべてのHTML要素にaria-hidden属性を使用する。

注:要素がhidden属性を持つ場合、aria-hidden属性は必要とされない。

制約の検証のための候補であるが、その制約を満たさない要素 aria-invalid="true"

aria-invalid属性は、検証制約を満たさない送信可能な要素を除いて、グローバルaria-*属性を許可するHTML要素で使用してもよい。

contenteditable="true"をもつ要素。または
contenteditable属性をもつ最も近い祖先がcontenteditable="true"を持つcontenteditable属性のない要素。

注:これは、isContentEditable IDL属性と同等である。

aria-readonly="false" isContentEditable="true"を持つ要素にaria-readonly="true"を設定しない。

表の2列目の対応するロールなしでマークされる要素は、一切の暗黙のARIAセマンティックスを持たないが、意味を持ち、かつこの意味はARIAによって提供されないロール、ステートおよびプロパティで表されてもよく、アクセシビリティAPIを経由して支援技術のユーザーに公開される。したがって、ウェブ開発者は、記載される要素のセマンティックスを上書きするよりも、divまたはspanなどの意味的に中立な要素にrole属性を追加することを推奨する。

Note

著者は、ここで提供されるものを超えたHTMLにおけるARIAの使用に関するガイダンスのために、以下の文書の利用を推奨する:

  • Using ARIA - Accessible Rich Internet Applications仕様(ARIA 1.1)を使用してHTML要素にアクセシビリティ情報を追加する方法についての開発者のための実用的なガイド。
  • WAI-ARIA 1.2 Authoring Practices - アクセシブル・リッチ・インターネット・アプリケーションを理解して実装する著者のガイド。

3. ARIAロール、ステートおよびプロパティ属性の活字ケース要件

著者は、すべてのroleトークン値、および値がトークンとして定義されるステートまたはプロパティ属性(aria-*)に小文字のASCII文字を使用しなければならない

4. 許可されるARIAロール、ステートおよびプロパティ

ARIAロール、ステート、およびプロパティの表の1~4列目は、HTMLでの使用が許可されるARIAロール、ステート、およびプロパティに関する有益な(非規範的な)参照を提供する。すべてのARIAロール、ステートおよびプロパティはAccessible Rich Internet Applications (WAI-ARIA) 1.1仕様で規範的に定義されている。表におけるARIAロール、ステートおよびプロパティへのリンクは、規範Accessible Rich Internet Applications (WAI-ARIA) 1.1定義を参照する。

ARIA ロール、ステート、およびプロパティの表の5列目は、HTML要素で使用されるときに各roleのカテゴリー([HTML]仕様で定義される)のコンテンツの種類に対する拡張を定義する。6列目は、特定の暗黙的または明示的なrole値をもつ要素の子孫となるHTML要素を定義する。

たとえば、role=buttonをもつ要素はインタラクティブコンテンツであるため、インタラクティコンテンツの子孫を含むことはできない。button要素は暗黙的なrole=buttonを持つため、インタラクティブコンテンツカテゴリー(3列目に記載)にあるロール値を持つ要素を含むことはできない。

適合しない子孫の例
<!-- conformance checkers will report an error -->

<button>
<div role="button">...</div>
</button>

<div role="button">
<button>...</button>
</div>

<div role="link">
<textarea>...</textarea>
</div>
ARIAロール、ステートおよびプロパティ
ロール 説明 必須プロパティ サポートされるプロパティ コンテンツの種類 子孫の制限
すべて ARIAグローバルステートおよびプロパティは、すべてのHTML要素で使用できる。 なし 該当なし 該当なし
alert 重要かつ通常は時間依存の情報をもつライブ領域の種類。関連するalertdialogstatusを参照のこと。 なし aria-expanded(ステート) フローコンテンツ フローコンテンツ
alertdialog 初期のフォーカスがダイアログ内の要素に移動する場合、警告メッセージを含むダイアログの種類。関連するalertdialogを参照のこと。 なし フローコンテンツ フローコンテンツ
application widgetロールによってサポートされる標準的な相互作用パターンに従わない、キーボードまたはジェスチャーイベントなどの、ユーザー入力を要求する1つ以上のフォーカス可能な要素を含む構造。 なし フローコンテンツ フローコンテンツ
article 文書、ページ、またはサイトの独立した部分を形成する構成物から成るページのセクション。 なし

aria-expanded(ステート)

フローコンテンツ main要素の子孫ではない。
banner ページ固有のコンテンツよりもむしろ、主にサイト中心のコンテンツが含まれる領域。 なし aria-expanded(ステート) 文書領域 headerの子孫であるセクショニングコンテンツの子孫ではない、main要素の子孫、またはheaderfooter要素ではない。
button クリックされるまたは押される際に、ユーザートリガーアクションを可能にする入力。関連するlinkを参照のこと。 なし インタラクティブコンテンツ フローコンテンツ、ただしインタラクティブコンテンツの子孫が存在してはならない。
checkbox true、false、またはmixedの3つの取りうる値を持つチェック可能な入力。 aria-checked(ステート) aria-readonly インタラクティブコンテンツ フローコンテンツ、ただしインタラクティブコンテンツの子孫が存在してはならない。
cell テーブルコンテナにおけるセル。 なし フローコンテンツ フローコンテンツ
columnheader 列のヘッダー情報を含むセル。 なし フローコンテンツ フローコンテンツ
combobox 選択のプレゼンテーション、ユーザーがオプションを選択する前に打ち込めるか、リストで新しい項目として任意のテキストを入力するために打ち込める場合、テキストボックスに通常似ている。関連するlistboxを参照のこと。 インタラクティブコンテンツ フローコンテンツ
complementary 主コンテンツから分離される際、DOM階層における同等のレベルで主コンテンツに相補的であるように設計されているが、意味のある文書のサポートするセクション。 なし aria-expanded(ステート) フローコンテンツ フローコンテンツ、ただしmain要素の子孫を除く。
contentinfo 親文書に関する情報を含む大きな認知できる領域。 なし aria-expanded(ステート) フローコンテンツ headerの子孫であるセクショニングコンテンツの子孫ではない、フローコンテンツ、ただしmain要素の子孫、またはheaderfooter要素ではない。
definition 用語または概念の定義。 なし

aria-expanded(ステート)

フレージングコンテンツ フレージングコンテンツ
dialog ダイアログボックスは、情報を入力する、または応答を要求するようユーザーに促すために、アプリケーションの現在の処理を中断するように設計されるアプリケーションウィンドウである。関連するalertdialogを参照のこと。 なし フローコンテンツ フローコンテンツ
directory 静的なコンテンツの表などの、グループのメンバーへの参照リスト。 なし aria-expanded(ステート) フローコンテンツ フローコンテンツ
document ウェブアプリケーションとは対照的に、文書コンテンツとして宣言される関連情報を含む領域。 なし

aria-expanded(ステート)

フローコンテンツ フローコンテンツ
feed スクロールが記事にリストのいずれかの端に追加させるまたは端から削除させるかもしれない場所で記事のスクロール可能なlist。 なし aria-expanded(ステート) フローコンテンツ フローコンテンツ
figure グラフィカルな文書、画像、コード断片、またはテキスト例を通常含むコンテンツの知覚可能なセクション。 なし aria-expanded(ステート) フローコンテンツ フローコンテンツ
form 全体として、フォームを作成するために組み合わせる、項目およびオブジェクトのコレクションを含む目印領域。関連するsearchを参照のこと。 なし

aria-expanded(ステート)

フローコンテンツ フローコンテンツ
grid 表のように、行と列に配列された表形式のデータセルを含むインタラクティブなコントロールであるグリッド。 なし

フローコンテンツ

インタラクティブコンテンツ

フローコンテンツ
gridcell gridまたはtreegridにおけるセル。 なし

フローコンテンツ

インタラクティブコンテンツ

フローコンテンツ
group 支援技術によってページ概要または目次に含まれることを意図されないユーザーインターフェイスオブジェクトの集合。 なし フローコンテンツ フローコンテンツ
heading ページのセクションに対する見出し。 なし Heading content フローコンテンツ、ただしヘディングコンテンツセクショニングコンテンツセクショニングルートをもたない。
img 画像を形成する要素のコレクションに対するコンテナ。 なし

aria-expanded(ステート)

フローコンテンツ フローコンテンツ
活性化された場合、ユーザーエージェントにそのリソースに移動させる、内部または外部のリソースへのインタラクティブな参照。関連するbuttonを参照のこと。 なし

aria-expanded(ステート)

フローコンテンツ フローコンテンツ、ただしインタラクティブコンテンツまたはa要素の子孫を除く。
list 非対話型リスト項目のグループ。関連するlistboxを参照のこと。 なし

aria-expanded(ステート)

フローコンテンツ フローコンテンツ
listbox ユーザーが選択肢のリストから1つ以上の項目を選択できるウィジェット。関連するcomboboxlistを参照のこと。 なし

フローコンテンツ

インタラクティブコンテンツ

フローコンテンツ
listitem listまたはdirectoryにおける1つの項目。 なし フローコンテンツ フローコンテンツ
log 新しい情報が意味のある順序で追加され、かつ古い情報が消滅する場合のlive regionの種類。関連するmarqueeを参照のこと。 なし

aria-expanded(ステート)

フローコンテンツ フローコンテンツ
main 文書の主コンテンツ。 なし

aria-expanded(ステート)

フローコンテンツ フローコンテンツ、ただしmain要素の子孫を除く
marquee 必須でない情報が頻繁に変更されるライブ領域の種類。関連するlogを参照のこと。 なし

aria-expanded(ステート)

フローコンテンツ フローコンテンツ
math 数式を表すコンテンツ。 なし

aria-expanded(ステート)

フローコンテンツ フローコンテンツ
menu ユーザーに選択肢のリストを提供するウィジェットの種類。 なし

フローコンテンツ

インタラクティブコンテンツ

フローコンテンツ
menubar 一般に表示されたままでかつ水平に提示される、メニューの表示。 なし

フローコンテンツ

インタラクティブコンテンツ

フローコンテンツ
menuitem menumenubarに含まれる選択肢のグループ内のオプション。 なし インタラクティブコンテンツ フローコンテンツ、ただしインタラクティブコンテンツの子孫を除く。
menuitemcheckbox true、false、mixedの、3つの取りうる値を持つチェック可能メニュー項目。 aria-checked(ステート) インタラクティブコンテンツ フローコンテンツ、ただしインタラクティブコンテンツの子孫を除く。
menuitemradio 一度に1つのみがチェックできる、menuitemradioロールのグループにおいてチェック可能なmenuitem aria-checked(ステート) インタラクティブコンテンツ フローコンテンツ、ただしインタラクティブコンテンツの子孫を除く。
navigation 文書または関連する文書をナビゲートするためのナビゲーション要素(通常はリンク)のコレクション。 なし

aria-expanded(ステート)

フローコンテンツ フローコンテンツ、ただしmain要素の子孫を除く
none 暗黙のネイティヴロールセマンティックスがアクセシビリティAPIにマッピングされない要素。類義語presentationを参照のこと。 なし   フローコンテンツ フローコンテンツ
note リソースの主コンテンツに挿入的または付随的であるコンテンツのセクション。 なし

aria-expanded(ステート)

フローコンテンツ フローコンテンツ
option 選択リスト内の選択可能な項目。 なし インタラクティブコンテンツ フローコンテンツ、ただしインタラクティブコンテンツの子孫を除く。
presentation 暗黙のネイティヴロールセマンティックスがアクセシビリティAPIにマッピングされない要素。 なし フローコンテンツ フローコンテンツ
progressbar 長時間かかるタスクの進捗状況を表示する要素。 なし フローコンテンツ フローコンテンツ
radio 一度に1つのみがチェックできる、radioロールのグループでチェック可能な入力。 aria-checked(ステート) インタラクティブコンテンツ フローコンテンツ、ただしインタラクティブコンテンツの子孫を除く。
radiogroup ラジオボタンのグループ。 なし フローコンテンツ フローコンテンツ
region たとえば、ライブスポーツイベントの統計情報を含むページ領域など、著者がページ概要または目次に含まれるのに十分重要であると思うウェブページまたは文書の大きな知覚可能なセクション。 なし

aria-expanded(ステート)

フローコンテンツ フローコンテンツ
row

テーブルコンテナにおけるセルの行。

なし

role=grid, rowgroup, tableまたはtreegridの子の場合:

または、role=treegridの子の場合:

なし フローコンテンツ
rowgroup グリッド内の1つ以上の行要素を含むグループ。 なし   なし フローコンテンツ
rowheader グリッド内の行に対するヘッダー情報を含むセル。 なし なし フローコンテンツ
scrollbar 表示領域内でコンテンツが完全に表示されるかどうかに関わらず、表示領域内でコンテンツのスクロールを制御するグラフィカルオブジェクト。

フローコンテンツ

インタラクティブコンテンツ

フローコンテンツ
全体として、検索機能を作成するために組み合わせる、項目およびオブジェクトのコレクションを含む目印領域。関連するformを参照のこと。 なし aria-expanded(ステート)

フローコンテンツ

フローコンテンツ
検索条件を指定することを意図するテキストボックスの一種。 なし インタラクティブコンテンツ フローコンテンツ、ただしインタラクティブコンテンツの子孫を除く。
separator メニュー項目のコンテンツまたはグループのセクションを分離して区別する仕切り。

インタラクティブコンテンツ(フォーカス可能な場合)。

フローコンテンツ
slider ユーザーが与えられた範囲内から値を選択する場合の、ユーザーの入力。 インタラクティブコンテンツ フローコンテンツ
spinbutton ユーザーが個別の選択肢の中から選択するように期待する範囲のフォーム。

フローコンテンツ

インタラクティブコンテンツ

フローコンテンツ
status ユーザーのための助言情報だが、通知を正当化するほど重要ではなく、多くの場合ステータスバーとして必ずしも表示されないコンテンツのコンテナ。関連するalertを参照のこと。 なし

aria-expanded(ステート)

フローコンテンツ

フローコンテンツ
switch checked/unchecked値とは対照的に、on/off値を表すチェックボックスの種類。 aria-checked(ステート) aria-readonly

インタラクティブコンテンツ

フローコンテンツ、ただしインタラクティブコンテンツの子孫を除く。
tab ユーザーにレンダリングされるタブコンテンツを選択するためのメカニズムを提供するグループ化ラベル。 なし

インタラクティブコンテンツ

フローコンテンツ
table 行と列に配置されたデータを含むセクション。tableロールは、インタラクティブでない表形式のコンテナを意図する。 なし フローコンテンツ フローコンテンツ
tablist tabpanel要素への参照である、tab要素のリスト。 なし フローコンテンツ フローコンテンツ
tabpanel tabtablistに含まれる場合、tabに関連付けられたリソースのコンテナ。 なし

aria-expanded(ステート)

フローコンテンツ フローコンテンツ
term 対応する定義をもつ単語またはフレーズ。関連するdefinitionを参照のこと。 なし aria-expanded(ステート) フレージングコンテンツ フレージングコンテンツ
textbox 入力値として自由形式のテキストを許可する入力。 なし インタラクティブコンテンツ フローコンテンツ、ただしインタラクティブコンテンツの子孫を除く。
timer 始点からの経過時間または終点までの残り時間を示す数値カウンタを含むライブ領域の種類。 なし

aria-expanded(ステート)

フローコンテンツ フローコンテンツ
toolbar コンパクトな見た目で示した一般的に使用される機能ボタンのコレクション。 なし フローコンテンツ フローコンテンツ
tooltip 要素の説明を表示するコンテキストポップアップ。 なし

aria-expanded(ステート)

フローコンテンツ フローコンテンツ
tree 折りたたみおよび展開することができるサブレベルのネストされたグループを含むことができるリストの種類。 なし フローコンテンツ フローコンテンツ
treegrid ツリーと同様に展開または折り畳むことができる行のグリッド。 なし フローコンテンツ フローコンテンツ
treeitem ツリーのオプション項目。ツリー項目のサブレベルグループを含む場合、これは展開または折りたたみできるツリー内の要素である。 なし インタラクティブコンテンツ フローコンテンツ

5. 適合

非規範的とマークされたセクションだけでなく、この仕様のすべてのオーサリングガイドライン、ダイアグラム、例、および注も非規範的である。この仕様におけるその他すべては規範的である。

この文書におけるキーワードMAYMUSTMUST NOTNOT RECOMMENDEDは、ここに示すように、すべて大文字で表記される場合に限り、BCP 14 [RFC2119] [RFC8174]で記述されるように解釈される。

ARIA in HTMLのチェックに対するサポートを主張する適合チェッカーは、この仕様で定義されるようにHTML要素のARIAroleおよびaria-*属性の使用のための文書適合性要件に対するチェックを実装しなければならない。 

文書は、(もしあれば)3列目でその要素に記載されるような対応するロール値以外、(マークアップでの明示的な使用が推奨されない)2列目に示したもの以外、§ 2. HTMLテーブルにおけるARIA属性の使用に対する文書の適合性要件における要素をもつすべてのrole値を使用してはならない

A. 参考文献

A.1 Normative references

[dpub-aria-1.0]
Digital Publishing WAI-ARIA Module 1.0. Matt Garrish; Tzviya Siegman; Markus Gylling; Shane McCarron. W3C. 14 December 2017. W3C Recommendation. URL: https://www.w3.org/TR/dpub-aria-1.0/
[HTML]
HTML Standard. Anne van Kesteren; Domenic Denicola; Ian Hickson; Philip Jägenstedt; Simon Pieters. WHATWG. Living Standard. URL: https://html.spec.whatwg.org/multipage/
[html-aam-1.0]
HTML Accessibility API Mappings 1.0. Steve Faulkner; Alexander Surkov; Scott O'Hara; Bogdan Brinza; Jason Kiss; Cynthia Shelly. W3C. 11 August 2020. W3C Working Draft. URL: https://www.w3.org/TR/html-aam-1.0/
[RFC2119]
Key words for use in RFCs to Indicate Requirement Levels. S. Bradner. IETF. March 1997. Best Current Practice. URL: https://tools.ietf.org/html/rfc2119
[RFC8174]
Ambiguity of Uppercase vs Lowercase in RFC 2119 Key Words. B. Leiba. IETF. May 2017. Best Current Practice. URL: https://tools.ietf.org/html/rfc8174
[wai-aria-1.1]
Accessible Rich Internet Applications (WAI-ARIA) 1.1. Joanmarie Diggs; Shane McCarron; Michael Cooper; Richard Schwerdtfeger; James Craig. W3C. 14 December 2017. W3C Recommendation. URL: https://www.w3.org/TR/wai-aria-1.1/

A.2 Informative references

[using-aria]
Using ARIA. Steve Faulkner; David MacDonald. W3C. 27 September 2018. W3C Working Draft. URL: https://www.w3.org/TR/using-aria/
[wai-aria-practices-1.2]
WAI-ARIA Authoring Practices 1.2. Matthew King; JaEun Ku; James Nurthen; Zoë Bijl; Michael Cooper; Joseph Scheuhammer; Lisa Pappas; Richard Schwerdtfeger. W3C. 18 December 2019. W3C Working Draft. URL: https://www.w3.org/TR/wai-aria-practices-1.2/