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