Review Request : 7198272 - RFE : Javadoc Accessibility : Generate WAI-ARIA compliant HTML

Jonathan Gibbons jonathan.gibbons at oracle.com
Tue Nov 6 16:38:32 PST 2012


On 11/05/2012 08:06 AM, jayashree viswanathan wrote:
> Hi Jon ,
>
> Can you please review the changeset for the bug 7198272 ?
>
> The Changeset and example page are available in the below link .
>
> http://cr.openjdk.java.net/~jviswana/7198272/
>
> Thanks a lot !
>
> Regards,
> Jayashree V
>

Jayashree,

javadoc is currently specified to generate HTML 4.01 output.  I don't 
see the ROLE, ARIA-LABEL and ARIA-LABELLED-BY attribute being defined 
there.  Is this a new attribute for HTML 5 or did I mis it somewhere in 
the 4.01 spec?  If this is new for HTML 5, we need to think about how 
best to handle having javadoc generate HTML 5 docs -- for example, what 
about frames?

Also, in reading through your code in HtmlWriter, we are moving away 
from building long strings in favor of building HtmlTree nodes.  So, it 
would be better to follow that paradigm here as well.

-- Jon




More information about the javadoc-dev mailing list