Uploaded image for project: 'JDK'
  1. JDK
  2. JDK-8225448

String::translateEscapes javadoc has accessibility issues

XMLWordPrintable

    • b25
    • Not verified

        The recent update to String.java JDK-8223780 contained a <table> with accesibility issues:

        build/linux-x86_64-server-release/images/docs/api/java.base/java/lang/String.html:3750: no row header for row 1
        build/linux-x86_64-server-release/images/docs/api/java.base/java/lang/String.html:3751: no row header for row 1
        build/linux-x86_64-server-release/images/docs/api/java.base/java/lang/String.html:3755: no row header for row 2
        build/linux-x86_64-server-release/images/docs/api/java.base/java/lang/String.html:3756: no row header for row 2
        build/linux-x86_64-server-release/images/docs/api/java.base/java/lang/String.html:3760: no row header for row 3
        build/linux-x86_64-server-release/images/docs/api/java.base/java/lang/String.html:3761: no row header for row 3
        build/linux-x86_64-server-release/images/docs/api/java.base/java/lang/String.html:3765: no row header for row 4
        build/linux-x86_64-server-release/images/docs/api/java.base/java/lang/String.html:3766: no row header for row 4
        build/linux-x86_64-server-release/images/docs/api/java.base/java/lang/String.html:3770: no row header for row 5
        build/linux-x86_64-server-release/images/docs/api/java.base/java/lang/String.html:3771: no row header for row 5
        build/linux-x86_64-server-release/images/docs/api/java.base/java/lang/String.html:3775: no row header for row 6
        build/linux-x86_64-server-release/images/docs/api/java.base/java/lang/String.html:3776: no row header for row 6
        build/linux-x86_64-server-release/images/docs/api/java.base/java/lang/String.html:3780: no row header for row 7
        build/linux-x86_64-server-release/images/docs/api/java.base/java/lang/String.html:3781: no row header for row 7
        build/linux-x86_64-server-release/images/docs/api/java.base/java/lang/String.html:3785: no row header for row 8
        build/linux-x86_64-server-release/images/docs/api/java.base/java/lang/String.html:3786: no row header for row 8
        build/linux-x86_64-server-release/images/docs/api/java.base/java/lang/String.html:3790: no row header for row 9
        build/linux-x86_64-server-release/images/docs/api/java.base/java/lang/String.html:3791: no row header for row 9

        Here is the table:

        3002 * <table class="plain">
        3003 * <caption style="display:none">Escape sequences</caption>
        3004 * <thead>
        3005 * <tr>
        3006 * <th scope="col">Escape</th>
        3007 * <th scope="col">Name</th>
        3008 * <th scope="col">Unicode/action</th>
        3009 * </tr>
        3010 * </thead>
        3011 * <tr>
        3012 * <td>{@code \u005Cb}</td>
        3013 * <td>backspace</td>
        3014 * <td>{@code \u005Cu0008}</td>
        3015 * </tr>
        3016 * <tr>
        3017 * <td>{@code \u005Ct}</td>
        3018 * <td>horizontal tab</td>
        3019 * <td>{@code \u005Cu0009}</td>
        3020 * </tr>
        3021 * <tr>
        3022 * <td>{@code \u005Cn}</td>
        3023 * <td>line feed</td>
        3024 * <td>{@code \u005Cu000A}</td>
        3025 * </tr>
        3026 * <tr>
        3027 * <td>{@code \u005Cf}</td>
        3028 * <td>form feed</td>
        3029 * <td>{@code \u005Cu000C}</td>
        3030 * </tr>
        3031 * <tr>
        3032 * <td>{@code \u005Cr}</td>
        3033 * <td>carriage return</td>
        3034 * <td>{@code \u005Cu000D}</td>
        3035 * </tr>
        3036 * <tr>
        3037 * <td>{@code \u005C"}</td>
        3038 * <td>double quote</td>
        3039 * <td>{@code \u005Cu0022}</td>
        3040 * </tr>
        3041 * <tr>
        3042 * <td>{@code \u005C'}</td>
        3043 * <td>single quote</td>
        3044 * <td>{@code \u005Cu0027}</td>
        3045 * </tr>
        3046 * <tr>
        3047 * <td>{@code \u005C\u005C}</td>
        3048 * <td>backslash</td>
        3049 * <td>{@code \u005Cu005C}</td>
        3050 * </tr>
        3051 * <tr>
        3052 * <td>{@code \u005C0 - \u005C377}</td>
        3053 * <td>octal escape</td>
        3054 * <td>code point equivalents</td>
        3055 * </tr>
        3056 * </table>


        I suggest using <table class="striped"> and change the first element of each row to <th scope="row">...</th>
        Also suggest putting <tbody> around the body rows.

              jlaskey Jim Laskey
              jjg Jonathan Gibbons
              Votes:
              0 Vote for this issue
              Watchers:
              2 Start watching this issue

                Created:
                Updated:
                Resolved: