RFR: JDK-8221871: javadoc should not set role=region on <section> elements
Jonathan Gibbons
jonathan.gibbons at oracle.com
Tue Apr 2 21:13:39 UTC 2019
Please review a small change to bring javadoc in line with the HTML 5 spec.
The HTML5 spec advises that `role="region"` should not be set on
<section> elements.
> Allowed ARIA role attribute values
> <https://www.w3.org/TR/html5/dom.html#allowed-aria-role-attribute-values>:
>
>
> |region| <https://www.w3.org/TR/wai-aria-1.1/#region> role
> (default - /do not set/
> <https://www.w3.org/TR/html5/dom.html#do-not-set>), |alert|
> <https://www.w3.org/TR/wai-aria-1.1/#alert>, |alertdialog|
> <https://www.w3.org/TR/wai-aria-1.1/#alertdialog>, |application|
> <https://www.w3.org/TR/wai-aria-1.1/#application>, |contentinfo|
> <https://www.w3.org/TR/wai-aria-1.1/#contentinfo> , |dialog|
> <https://www.w3.org/TR/wai-aria-1.1/#dialog>, |document|
> <https://www.w3.org/TR/wai-aria-1.1/#document>, |feed|, |log|
> <https://www.w3.org/TR/wai-aria-1.1/#log>, |main|
> <https://www.w3.org/TR/wai-aria-1.1/#main>, |marquee|
> <https://www.w3.org/TR/wai-aria-1.1/#marquee>, |presentation|
> <https://www.w3.org/TR/wai-aria-1.1/#presentation>, |region|
> <https://www.w3.org/TR/wai-aria-1.1/#region>, |search|
> <https://www.w3.org/TR/wai-aria-1.1/#search>, |status|
> <https://www.w3.org/TR/wai-aria-1.1/#status> or |tabpanel|
> <https://www.w3.org/TR/wai-aria-1.1/#tabpanel>.
>
The attribute was being set unconditionally. The lines to do this have
been removed and the necessary tests updated.
-- Jon
Spec: https://www.w3.org/TR/html5/sections.html#the-section-element
JBS: https://bugs.openjdk.java.net/browse/JDK-8221871
Webrev: http://cr.openjdk.java.net/~jjg/8221871/webrev.00/index.html
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://mail.openjdk.java.net/pipermail/javadoc-dev/attachments/20190402/8a24d6f5/attachment.html>
More information about the javadoc-dev
mailing list