HTML 中的 ARIA

角色： button， checkbox， menuitem， menuitemcheckbox， menuitemradio， option， radio， switch， tab 或 treeitem。 （link 也允许，但 不建议。）

DPub 角色： doc-backlink， doc-biblioref， doc-glossref 或 doc-noteref

全局 aria-* 属性以及适用于允许角色的任何 aria-* 属性。

在带 href 属性的 a 元素上使用 aria-disabled="true" 不建议。

任意 role，但 generic不应使用。

禁止命名

否则，全局 aria-* 属性 以及适用于允许角色的任意 aria-* 属性。

任意 role

禁止命名

否则，全局 aria-* 属性 以及适用于允许角色的任意 aria-* 属性。

任意 role，但 group 不建议。

否则，全局 aria-* 属性 以及适用于允许角色的任意 aria-* 属性。

不得使用 role 除了 link 外，该角色不建议。

全局 aria-* 属性 以及适用于 link 角色的任意 aria-* 属性。

角色： application, document, feed, main, none, presentation 或 region。 （也允许 article，但不建议。）

全局 aria-* 属性 以及适用于允许角色的任意 aria-* 属性。

角色： feed, none, note, presentation, region 或 search。 （也允许 complementary，但不建议。）

DPub 角色： doc-dedication, doc-example, doc-footnote, doc-glossary, doc-pullquote 或 doc-tip

全局 aria-* 属性 以及适用于允许角色的任意 aria-* 属性。

角色： application

全局 aria-* 属性 以及适用于 application 角色的任意 aria-* 属性。

由作者定义的 ElementInternals 暴露角色

否则 role=generic

如果由 ElementInternals 定义角色， 无 role

否则 任意 role，但 generic不应使用。

如果暴露为generic角色 或 暴露为另一个禁止命名的角色， 禁止命名

否则，全局 aria-* 属性 以及适用于允许角色的任意 aria-* 属性。

任意 role，但 generic不应使用。

禁止命名

否则，全局 aria-* 属性 以及适用于允许角色的任意 aria-* 属性。

无 role 或 aria-* 属性

任意 role，但 generic不应使用。

禁止命名

否则，全局 aria-* 属性 以及适用于允许角色的任意 aria-* 属性。

任意 role，但 generic不应使用。

禁止命名

否则，全局 aria-* 属性 以及适用于允许角色的任意 aria-* 属性。

任意 role，但 blockquote不建议。

全局 aria-* 属性 以及适用于允许角色的任意 aria-* 属性。

无 role 除了 generic不应使用。

禁止命名

否则，全局 aria-* 属性 可用于 generic 角色，但作者不得在 body 元素上设置 aria-hidden=true。

角色： none 或 presentation

作者可以在 br 元素上指定 aria-hidden 属性。否则，不允许其他 aria-* 属性。

role=button

如果 button 是 select 元素的第一个子元素，则该元素为 inert。

角色： checkbox, combobox, gridcell, link, menuitem, menuitemcheckbox, menuitemradio, option, radio, separator, slider, switch, tab, 或 treeitem。 （也允许 button，但不建议。）

全局 aria-* 属性 以及适用于允许角色的任意 aria-* 属性。

如果 button 是 select 元素的第一个子元素： 无 role 或 aria-* 属性

任意 role

全局 aria-* 属性 以及适用于允许角色的任意 aria-* 属性。

无 role 除了 caption，该角色不建议。

禁止命名

否则，全局 aria-* 属性。

任意 role

禁止命名

否则，全局 aria-* 属性 以及适用于所允许角色的任何 aria-* 属性。

任意 role，不过 code 是不建议的。

禁止命名

否则，全局 aria-* 属性 以及适用于所允许角色的任何 aria-* 属性。

无 role 或 aria-* 属性

无 role 或 aria-* 属性

任意 role，不过 generic 不应使用。

禁止命名

否则，全局 aria-* 属性 以及适用于所允许角色的任何 aria-* 属性。

无 role

全局 aria-* 属性 以及任何适用于 definition 角色的 aria-* 属性。

任意 role，不过 deletion 是不建议的。

禁止命名

否则，全局 aria-* 属性 以及适用于所允许角色的任何 aria-* 属性。

无 role 除了 group，该角色不建议。

全局 aria-* 属性 以及任何适用于 group 角色的 aria-* 属性。

任意 role，不过 term 是不建议的。

全局 aria-* 属性 以及适用于所允许角色的任何 aria-* 属性。

角色： alertdialog。 （也允许 dialog，但不建议。）

全局 aria-* 属性 以及适用于 dialog 角色的任何 aria-* 属性。

如果是 dl 元素的直接子元素，则只允许 presentation 或 none。否则， 任意 role，不过 generic 不应使用。

禁止命名

否则，全局 aria-* 属性 以及适用于所允许角色的任何 aria-* 属性。

角色： group、 list、 none 或 presentation

全局 aria-* 属性 以及适用于所允许角色的任何 aria-* 属性。

角色： listitem

全局 aria-* 属性 以及适用于所允许角色的任何 aria-* 属性。

任意 role，不过 emphasis 是不建议的。

禁止命名

否则，全局 aria-* 属性 以及适用于所允许角色的任何 aria-* 属性。

角色： application、 document、 img、 image、 none 或 presentation。

全局 aria-* 属性以及 适用于所允许角色的任何 aria-* 属性。

角色： none、 presentation 或 radiogroup。 （也允许 group，但不建议。）

全局 aria-* 属性 以及适用于所允许角色的任何 aria-* 属性。

角色： group、 none 或 presentation

禁止命名

否则，全局 aria-* 属性 以及适用于所允许角色的任何 aria-* 属性。

如果 figure 具有有效的 figcaption 后代：
无 role 除了 figure， 该角色不建议。

DPub 角色： doc-example。

否则，如果 figure 没有 figcaption 后代：
任意 role，不过 figure 是不建议的。

全局 aria-* 属性 以及适用于所允许角色的任何 aria-* 属性。

如果不是 article、aside、main、 nav 或 section 元素的后代，或不是带有 role=article、 complementary、 main、navigation 或 region 的元素的后代，则 role=contentinfo

否则，role=generic

角色： group、 presentation 或 none。 （如果不是 article、aside、main、 nav 或 section 元素的后代，或不是带有 role=article、 complementary、 main、navigation 或 region 的元素的后代，则也允许 role=contentinfo，但不建议。 否则，role=generic 也允许，但不应使用。）

DPub 角色： doc-footnote

如果作为 generic 暴露则禁止命名。

否则，全局 aria-* 属性 以及适用于所允许角色的任何 aria-* 属性。

role=form

角色： none、 presentation 或 search。 （也允许 form，但不建议。）

全局 aria-* 属性 以及适用于所允许角色的任何 aria-* 属性。

由作者定义的 ElementInternals 暴露角色

否则 role=generic

如果由 ElementInternals 定义角色， 无 role

否则，表单相关角色： button、 checkbox、 combobox、 listbox、 progressbar、 group、 radio、 radiogroup、 searchbox、 slider、 spinbutton、 switch 或 textbox。 （也允许 generic，但不应使用。）

如果作为 generic 角色暴露，则 禁止命名。

否则，全局 aria-* 属性 以及适用于所允许角色的任何 aria-* 属性。

角色： none、 presentation 或 tab。 （也允许 heading，但不建议。）

DPub 角色： doc-subtitle

全局 aria-* 属性 以及适用于所允许角色的任何 aria-* 属性。

无 role 或 aria-* 属性

如果不是 article、aside、main、 nav 或 section 元素的后代，或不是带有 role=article、 complementary、main、navigation 或 region 的元素的后代，则 role=banner

否则为 role=generic

角色： group、 none 或 presentation。 （如果不是 article、aside、main、 nav 或 section 元素的后代，或不是带有 role=article、 complementary、 main、navigation 或 region 的元素的后代，则 也允许 role=banner，但 不建议。 否则，role=generic 也允许，但 不应 使用。）

如果作为 generic 暴露则禁止命名。

否则，全局 aria-* 属性 以及适用于所允许角色的任何 aria-* 属性。

任意 role，不过 group 是 不建议 的。

否则，全局 aria-* 属性 以及适用于所允许角色的任何 aria-* 属性。

角色： none 或 presentation。 （也允许 separator，但 不建议。）

DPub 角色： doc-pagebreak

全局 aria-* 属性 以及适用于 separator 角色的任何 aria-* 属性。

无 role 除了 document 或 generic，它们都 不建议 使用。

无 aria-* 属性。

任意 role，不过 generic 不应使用。

禁止命名

否则，全局 aria-* 属性 以及适用于所允许角色的任何 aria-* 属性。

角色： application、 document、 img、 image、 none 或 presentation。

全局 aria-* 属性以及 适用于所允许角色的任何 aria-* 属性。

角色： button、 checkbox、 link、 math、 menuitem、 menuitemcheckbox、 menuitemradio、 meter、 option、 progressbar、 radio、 scrollbar、 separator、 slider、 switch、 tab 或 treeitem。 （也允许 img or image，但 不建议。）

DPub 角色： doc-cover

全局 aria-* 属性 以及适用于所允许角色的任何 aria-* 属性。

角色： checkbox， combobox， gridcell， link、 menuitem、 menuitemcheckbox、 menuitemradio、 option、 radio、 separator、 slider、 switch、 tab， 或 treeitem。 （也允许 button，但 不建议。）

全局 aria-* 属性 以及适用于所允许角色的任何 aria-* 属性。

角色： menuitemcheckbox、 option 或 switch； button，如果与 aria-pressed 一起使用。 （也允许 checkbox，但 不建议。）

作者不得在 input type=checkbox 元素上使用 aria-checked 属性。

否则，可使用任何全局 aria-* 属性， 以及适用于所允许角色的任何 aria-* 属性。

无 role

全局 aria-* 属性和 aria-disabled 属性。

无 role

全局 aria-* 属性 以及适用于 textbox 角色的任何 aria-* 属性。

无 role

全局 aria-* 属性 以及适用于 textbox 角色的任何 aria-* 属性。

无 role 除了 textbox，该角色 不建议。

全局 aria-* 属性 以及适用于 textbox 角色的任何 aria-* 属性。

无 role

全局 aria-* 属性、 aria-disabled、aria-invalid 和 aria-required 属性。

无 role 或 aria-* 属性

无 role

全局 aria-* 属性 以及适用于 textbox 角色的任何 aria-* 属性。

无 role 除了 spinbutton，该角色 不建议。

全局 aria-* 属性 以及适用于 spinbutton 角色的任何 aria-* 属性。

无 role

全局 aria-* 属性 以及适用于 textbox 角色的任何 aria-* 属性。

角色： menuitemradio。 （也允许 radio，但 不建议。）

作者不得在 input type=radio 元素上使用 aria-checked 属性。

否则，可使用任何全局 aria-* 属性，以及适用于所允许角色的任何 aria-* 属性。

无 role 除了 slider，该角色 不建议。

作者不应在 input type=range 上使用 aria-valuemax 或 aria-valuemin 属性。

否则，可使用任何 全局 aria-* 属性 以及适用于 slider 角色的任何其他 aria-* 属性。

无 role 除了 searchbox，该角色 不建议。

全局 aria-* 属性 以及适用于 searchbox 角色的任何 aria-* 属性。

无 role 除了 textbox，该角色 不建议。

全局 aria-* 属性 以及适用于 textbox 角色的任何 aria-* 属性。

角色： combobox、 searchbox 或 spinbutton。 （也允许 textbox，但 不建议。）

全局 aria-* 属性 以及适用于所允许角色的任何 aria-* 属性。

无 role 除了 combobox，该角色 不建议。

作者不应在带有 list 属性的所示 input 上使用 aria-haspopup 属性。

否则，可使用任何 全局 aria-* 属性 以及适用于 combobox 角色的任何其他 aria-* 属性。

无 role

全局 aria-* 属性 以及适用于 textbox 角色的任何 aria-* 属性。

无 role 除了 textbox，该角色 不建议。

全局 aria-* 属性 以及适用于 textbox 角色的任何 aria-* 属性。

无 role

全局 aria-* 属性 以及适用于 textbox 角色的任何 aria-* 属性。

任意 role，不过 insertion 不建议。

禁止命名

否则，全局 aria-* 属性 以及适用于所允许角色的任何 aria-* 属性。

任意 role

禁止命名

否则，全局 aria-* 属性 以及适用于所允许角色的任何 aria-* 属性。

如果 label 元素被隐式或显式关联到一个 可标记元素， 则 无 role

否则，如果 label 未与某个元素关联，则 任意 role， 不过 generic 不应使用。

禁止命名，如果其暴露为 generic 角色，或暴露为其他禁止命名的角色。

否则，全局 aria-* 属性。

无 role

禁止命名

否则，全局 aria-* 属性。

如果 li 是一个暴露为 role=list 的元素的子元素（例如 ul、ol、 menu）： role=listitem。

否则， role=generic

全局 aria-* 属性 以及适用于所允许角色的任何 aria-* 属性。

无 role 或 aria-* 属性

无 role 除了 main，该角色 不建议。

全局 aria-* 属性 以及适用于 main 角色的任何 aria-* 属性。

无 role 或 aria-* 属性

任意 role

禁止命名

否则，全局 aria-* 属性 以及适用于所允许角色的任何 aria-* 属性。

无 role 除了 math，该角色 不建议。

全局 aria-* 属性 以及适用于 math 角色的任何 aria-* 属性。

角色： group、 listbox、 menu、 menubar、 none、 presentation、 radiogroup、 tablist、 toolbar 或 tree。 （也允许 list，但 不建议。）

全局 aria-* 属性 以及适用于所允许角色的任何 aria-* 属性。

无 role 或 aria-* 属性

无 role 除了 meter，该角色 不建议。

作者 不应 在 meter 元素上使用 aria-valuemax 或 aria-valuemin 属性。

否则，可使用任何 全局 aria-* 属性 以及适用于 meter 角色的任何其他 aria-* 属性。

角色： menu、 menubar、 none、 presentation 或 tablist。 （也允许 navigation，但 不建议。）

DPub 角色： doc-index、 doc-pagelist 或 doc-toc

全局 aria-* 属性 以及适用于所允许角色的任何 aria-* 属性。

无 role 或 aria-* 属性

角色： application、 document、 img 或 image。

全局 aria-* 属性以及 适用于所允许角色的任何 aria-* 属性。

角色： group、 listbox、 menu、 menubar、 none、 presentation、 radiogroup、 tablist、 toolbar 或 tree。 （也允许 list，但 不建议。）

全局 aria-* 属性 以及适用于所允许角色的任何 aria-* 属性。

无 role 除了 group，该角色 不建议。

全局 aria-* 属性 以及适用于 group 角色的任何 aria-* 属性。

无 role 除了 option，该角色 不建议。

作者 不应 在 option 元素上使用 aria-selected 属性。

全局 aria-* 属性以及 适用于 option 角色的任何其他 aria-* 属性。

任意 role，不过 status 不建议。

全局 aria-* 属性 以及适用于所允许角色的任何 aria-* 属性。

任意 role，不过 paragraph 不建议。

禁止命名

否则，全局 aria-* 属性 以及适用于所允许角色的任何 aria-* 属性。

无 role 或 aria-* 属性

无 role

任意 role，不过 generic 不应 使用。

禁止命名

否则，全局 aria-* 属性 以及适用于所允许角色的任何 aria-* 属性。

无 role 除了 progressbar，该角色 不建议。

作者不应在 progress 元素上使用 aria-valuemax 属性。

否则， 任何 全局 aria-* 属性 以及适用于 progressbar 角色的任何其他 aria-* 属性。

任意 role，不过 generic 不应 使用。

禁止命名

否则，全局 aria-* 属性 以及适用于所允许角色的任何 aria-* 属性。

任意 role

禁止命名

全局 aria-* 属性 以及适用于所允许角色的任何 aria-* 属性。

任意 role

禁止命名

否则，全局 aria-* 属性 以及适用于所允许角色的任何 aria-* 属性。

任意 role

全局 aria-* 属性 以及适用于所允许角色的任何 aria-* 属性。

任意 role，不过 deletion 不建议。

禁止命名

否则，全局 aria-* 属性 以及适用于所允许角色的任何 aria-* 属性。

任意 role，不过 generic 不应 使用。

禁止命名

否则，全局 aria-* 属性 以及适用于所允许角色的任何 aria-* 属性。

无 role 或 aria-* 属性

role=search

role=region，如果 section 元素具有 可访问名称

否则，role=generic

角色： alert、 alertdialog、 application、 banner、 complementary、 contentinfo、 dialog、 document、 feed、 group， log、 main、 marquee、 navigation、 none、 note、 presentation、 search、 status 或 tabpanel。 （也允许 role=region， 但 不建议。 role=generic 不应 使用。）

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-* 属性。

角色：menu。 （也允许 combobox，但 不建议。）

作者 不应 在 select 元素上使用 aria-multiselectable 属性。

否则， 可使用任何 全局 aria-* 属性 以及适用于 combobox 或 menu 角色的任何其他 aria-* 属性。

无 role 除了 listbox，该角色 不建议。

作者 不应 在 select 元素上使用 aria-multiselectable 属性。

否则， 可使用任何 全局 aria-* 属性 以及适用于 listbox 角色的任何其他 aria-* 属性。

如果用作 select 元素的有效后代： 无 role 或 aria-* 属性

否则，如果该元素被用于其预期上下文之外，作为可自定义 select 元素的 button 部分的子元素，则 任意 role， 不过 generic 不建议。

禁止命名

否则，全局 aria-* 属性 以及适用于所允许角色的任何 aria-* 属性。

无 role 或 aria-* 属性

任意 role，不过 generic 不应 使用。

禁止命名

否则，全局 aria-* 属性 以及适用于所允许角色的任何 aria-* 属性。

无 role 或 aria-* 属性

任意 role，不过 generic 不应 使用。

禁止命名

否则，全局 aria-* 属性 以及适用于所允许角色的任何 aria-* 属性。

任意 role，不过 strong 是 不建议 的。

禁止命名

否则，全局 aria-* 属性 以及适用于所允许角色的任何 aria-* 属性。

无 role 或 aria-* 属性

任意 role，不过 subscript 不建议。

禁止命名

否则，全局 aria-* 属性 以及适用于所允许角色的任何 aria-* 属性。

无对应角色

任意 role，不过 superscript 不建议。

禁止命名

否则，全局 aria-* 属性 以及适用于所允许角色的任何 aria-* 属性。

任意 role，不过 graphics-document 不建议。

全局 aria-* 属性 以及适用于所允许角色的任何 aria-* 属性。

任意 role，不过 table 不建议。

全局 aria-* 属性 以及适用于所允许角色的任何 aria-* 属性。

任意 role，不过 rowgroup 不建议。

全局 aria-* 属性 以及适用于所允许角色的任何 aria-* 属性。

role=cell 如果祖先 table 元素暴露为 role=table

role=gridcell 如果祖先 table 元素暴露为 role=grid 或 treegrid

如果祖先 table 元素未暴露为 role=table、grid 或 treegrid，则 无对应角色

如果祖先 table 元素具有 role=table、grid 或 treegrid， 则无 role ，除了以下情况：

• 如果祖先 table 元素暴露为 role=table，则 cell 允许，但不建议。
• 如果祖先 table 元素暴露为 role=grid 或 treegrid，则 gridcell 允许，但不建议。

否则，如果祖先 table 元素未暴露为 role=table、 grid 或 treegrid， 任意 role。

全局 aria-* 属性 以及适用于所允许角色的任何 aria-* 属性。

无 role 或 aria-* 属性

无 role 除了 textbox，该角色 不建议。

全局 aria-* 属性 以及适用于 textbox 角色的任何 aria-* 属性。

任意 role，不过 rowgroup 不建议。

全局 aria-* 属性 以及适用于所允许角色的任何 aria-* 属性。

role=columnheader， rowheader 或 cell 如果祖先 table 元素暴露为 role=table

role=columnheader， rowheader 或 gridcell 如果祖先 table 元素暴露为 role=grid 或 treegrid

如果祖先 table 元素未暴露为 role=table、grid 或 treegrid，则 无对应角色

如果祖先 table 元素具有 role=table、grid 或 treegrid， 则无 role ，除了以下情况：

• 如果祖先 table 元素暴露为 role=table，则 columnheader、 rowheader 和 cell 允许，但不建议。
• 如果祖先 table 元素暴露为 role=grid 或 treegrid，则 columnheader、 rowheader 或 gridcell 允许，但不建议。

否则，如果祖先 table 元素未暴露为 role=table、 grid 或 treegrid， 任意 role。

全局 aria-* 属性 以及适用于所允许角色的任何 aria-* 属性。

任意 role，不过 rowgroup 不建议。

全局 aria-* 属性 以及适用于所允许角色的任何 aria-* 属性。

任意 role，不过 time 不建议。

禁止命名

否则，全局 aria-* 属性 以及适用于所允许角色的任何 aria-* 属性。

无 role 或 aria-* 属性

如果祖先 table 元素具有 role=table、grid 或 treegrid， 则无 role ，除了 row，该角色 不建议； 否则 任意 role，不过 row 不建议。

全局 aria-* 属性 以及适用于所允许角色的任何 aria-* 属性。

无 role 或 aria-* 属性

任意 role，不过 generic 不应 使用。

禁止命名

否则，全局 aria-* 属性 以及适用于所允许角色的任何 aria-* 属性。

角色： group、 listbox、 menu、 menubar、 none、 presentation、 radiogroup、 tablist、 toolbar 或 tree。 （也允许 list，但 不建议。）

全局 aria-* 属性 以及适用于所允许角色的任何 aria-* 属性。

任意 role

禁止命名

否则，全局 aria-* 属性 以及适用于所允许角色的任何 aria-* 属性。

角色：application

全局 aria-* 属性 以及适用于 application 角色的任何 aria-* 属性。