|
10 | 10 | {
|
11 | 11 | name: "Steve Faulkner",
|
12 | 12 | company: "TPGi",
|
13 |
| - companyURL: "https://www.tpgi.com", |
| 13 | + companyURL: "https://www.tpgi.com/", |
14 | 14 | w3cid: "35007"
|
15 | 15 | },
|
16 | 16 | {
|
17 | 17 | name: "Scott O'Hara",
|
18 | 18 | company: "Microsoft",
|
19 |
| - companyURL: "https://www.microsoft.com", |
| 19 | + companyURL: "https://www.microsoft.com/", |
20 | 20 | w3cid: "103856"
|
21 | 21 | },
|
22 | 22 | { name: "Patrick H. Lauke",
|
|
28 | 28 | previousMaturity: "CR",
|
29 | 29 | previousPublishDate: "2021-07-06",
|
30 | 30 | implementationReportURI: "https://w3c.github.io/html-aria/results/implementation-results.html",
|
31 |
| - github: "w3c/html-aria", |
| 31 | + github: "w3c/html-aria/", |
32 | 32 | maxTocLevel: 2,
|
33 | 33 | shortName: "html-aria",
|
34 | 34 | specStatus: "ED",
|
|
248 | 248 | a cell in the third column includes the term
|
249 | 249 | <dfn><strong>Anystrong> `role`dfn> it indicates that any `role`
|
250 | 250 | value apart from the <a>implicit ARIA semanticsa> `role` value,
|
251 |
| - MAY be used. If a cell in the third column includes the term |
| 251 | + MAY be used, <span class="proposed addition">unless it is a role |
| 252 | + <a href="#docconformance-deprecated">deprecated by ARIAa>. |
| 253 | + Deprecated roles SHOULD NOT be used by authorsspan>. |
| 254 | + If a cell in the third column includes the term |
252 | 255 | <dfn><strong>No `role`strong>dfn> it indicates that authors
|
253 | 256 | MUST NOT overwrite the implicit ARIA semantics, or native semantics
|
254 | 257 | of the HTML element.
|
|
1892 | 1895 | and any `aria-*` attributes applicable to the allowed roles.
|
1893 | 1896 | p>
|
1894 | 1897 | <div class="addition proposal">
|
1895 |
| - <p>Authors SHOULD NOT use the following DPub Roles: |
1896 |
| - <a data-cite="dpub-aria-1.0#doc-biblioentry">`doc-biblioentry`a>, |
1897 |
| - <a data-cite="dpub-aria-1.0#doc-endnote">`doc-endnote`a>. |
| 1898 | + <p>Authors SHOULD NOT use the following <a href="#docconformance-deprecated">deprecateda> DPub Roles: |
| 1899 | + <a data-cite="dpub-aria-1.1#doc-biblioentry">`doc-biblioentry`a>, |
| 1900 | + <a data-cite="dpub-aria-1.1#doc-endnote">`doc-endnote`a>. |
1898 | 1901 | p>
|
1899 |
| - <div class="note"> |
1900 |
| - <p>The `doc-biblioentry` and `doc-endnote` roles are not valid children of an element with an implict or explicit role of `list`. |
1901 |
| - These roles are marked for deprecation in [[[dpub-aria-1.1]]]. |
1902 |
| - Authors can use standard `li` elements without the need for these roles.p> |
1903 |
| - div> |
1904 | 1902 | div>
|
1905 | 1903 | td>
|
1906 | 1904 | tr>
|
|
1991 | 1989 | <td>
|
1992 | 1990 | <p>
|
1993 | 1991 | Roles:
|
1994 |
| - <a href="#index-aria-directory">`directory`a>, |
1995 | 1992 | <a href="#index-aria-group">`group`a>,
|
1996 | 1993 | <a href="#index-aria-listbox">`listbox`a>,
|
1997 | 1994 | <a href="#index-aria-menu">`menu`a>,
|
|
2007 | 2004 | <a data-cite="wai-aria-1.1#global_states">Global `aria-*` attributesa>
|
2008 | 2005 | and any `aria-*` attributes applicable to the allowed roles.
|
2009 | 2006 | p>
|
| 2007 | + <div class="addition proposal"> |
| 2008 | + <p>Authors SHOULD NOT use <a href="#docconformance-deprecated">deprecateda> <a href="#index-aria-directory">`directory`a> role. |
| 2009 | + p> |
| 2010 | + div> |
2010 | 2011 | td>
|
2011 | 2012 | tr>
|
2012 | 2013 | <tr>
|
|
2112 | 2113 | <td>
|
2113 | 2114 | <p>
|
2114 | 2115 | Roles:
|
2115 |
| - <a href="#index-aria-directory">`directory`a>, |
2116 | 2116 | <a href="#index-aria-group">`group`a>,
|
2117 | 2117 | <a href="#index-aria-listbox">`listbox`a>,
|
2118 | 2118 | <a href="#index-aria-menu">`menu`a>,
|
|
2128 | 2128 | <a data-cite="wai-aria-1.1#global_states">Global `aria-*` attributesa>
|
2129 | 2129 | and any `aria-*` attributes applicable to the allowed roles.
|
2130 | 2130 | p>
|
| 2131 | + <div class="addition proposal"> |
| 2132 | + <p>Authors SHOULD NOT use <a href="#docconformance-deprecated">deprecateda> <a href="#index-aria-directory">`directory`a> role. |
| 2133 | + p> |
| 2134 | + div> |
2131 | 2135 | td>
|
2132 | 2136 | tr>
|
2133 | 2137 | <tr>
|
|
2918 | 2922 | <td>
|
2919 | 2923 | <p>
|
2920 | 2924 | Roles:
|
2921 |
| - <a href="#index-aria-directory">`directory`a>, |
2922 | 2925 | <a href="#index-aria-group">`group`a>,
|
2923 | 2926 | <a href="#index-aria-listbox">`listbox`a>,
|
2924 | 2927 | <a href="#index-aria-menu">`menu`a>,
|
|
2934 | 2937 | <a data-cite="wai-aria-1.1#global_states">Global `aria-*` attributesa>
|
2935 | 2938 | and any `aria-*` attributes applicable to the allowed roles.
|
2936 | 2939 | p>
|
| 2940 | + <div class="addition proposal"> |
| 2941 | + <p>Authors SHOULD NOT use <a href="#docconformance-deprecated">deprecateda> <a href="#index-aria-directory">`directory`a> role. |
| 2942 | + p> |
| 2943 | + div> |
2937 | 2944 | td>
|
2938 | 2945 | tr>
|
2939 | 2946 | <tr>
|
|
3354 | 3361 | tbody>
|
3355 | 3362 | table>
|
3356 | 3363 | section>
|
| 3364 | + <section class="proposed addition"> |
| 3365 | + <h2 id="docconformance-deprecated"> |
| 3366 | + Requirements for deprecated ARIA role, state and property and attributes |
| 3367 | + h2> |
| 3368 | + <p> |
| 3369 | + The ARIA Specification's <a data-cite="wai-aria-1.2#deprecated">Deprecated Requirementsa> section indicates that if an ARIA feature is marked as deprecated then authors are advised not to use said feature for new content. |
| 3370 | + p> |
| 3371 | + <p> |
| 3372 | + The following roles and attributes are deprecated features of ARIA and DPub ARIA. Conformance checkers MUST warn authors about the deprecated status of these features. Whenever possible, authors are advised to use alternatives to deprecated features. |
| 3373 | + p> |
| 3374 | + |
| 3375 | + <h3>Deprecated ARIA rolesh3> |
| 3376 | + <ul> |
| 3377 | + <li><a data-cite="wai-aria-1.2#directory">`directory`a>li> |
| 3378 | + ul> |
| 3379 | + <div class="note"> |
| 3380 | + <p>The `directory` role is marked for deprecation in [[wai-aria-1.2|WAI-ARIA 1.2]]. In reality, the `directory` role had no functional difference to an element with an implicit or explicit `list` role. Authors are advised to use one of HTML's native list elements, or an ARIA `list` instead.p> |
| 3381 | + div> |
| 3382 | + |
| 3383 | + <h3>Deprecated DPub ARIA rolesh3> |
| 3384 | + <ul> |
| 3385 | + <li><a data-cite="dpub-aria-1.1#doc-biblioentry">`doc-biblioentry`a>li> |
| 3386 | + <li><a data-cite="dpub-aria-1.1#doc-endnote">`doc-endnote`a>li> |
| 3387 | + ul> |
| 3388 | + <div class="note"> |
| 3389 | + <p>The `doc-biblioentry` and `doc-endnote` roles are marked for deprecation in [[[dpub-aria-1.1]]], as they are not valid children for an element with an implicit or explicit role of `list`. Authors can use standard list and child `li` elements without the need for these roles.p> |
| 3390 | + div> |
| 3391 | + |
| 3392 | + <h3>Deprecated ARIA attributesh3> |
| 3393 | + <ul> |
| 3394 | + <li><a data-cite="wai-aria-1.1#aria-dropeffect">`aria-dropeffect`a>li> |
| 3395 | + <li><a data-cite="wai-aria-1.1#aria-grabbed">`aria-grabbed`a>li> |
| 3396 | + ul> |
| 3397 | + <div class="note"> |
| 3398 | + <p>The `aria-dropeffect` and `aria-grabbed` attributes were deprecated in [[wai-aria-1.1|WAI-ARIA 1.1]]. There is presently no feature in ARIA to replace their proposed functionality.p> |
| 3399 | + div> |
| 3400 | + section> |
3357 | 3401 | <section>
|
3358 |
| - <h2 id="case-sensitivity"> |
3359 |
| - Case requirements for ARIA role, state and property attributes |
3360 |
| - h2> |
3361 |
| - <p> |
3362 |
| - Authors SHOULD use [=ASCII lowercase=] for all `role` token values |
3363 |
| - and any state or property attributes (`aria-*`) whose values are |
3364 |
| - <a data-cite="wai-aria-1.1#propcharacteristic_value">defined as tokensa>. |
3365 |
| - p> |
| 3402 | + <h2 id="case-sensitivity"> |
| 3403 | + Case requirements for ARIA role, state and property attributes |
| 3404 | + h2> |
| 3405 | + <p> |
| 3406 | + Authors SHOULD use [=ASCII lowercase=] for all `role` token values |
| 3407 | + and any state or property attributes (`aria-*`) whose values are |
| 3408 | + <a data-cite="wai-aria-1.1#propcharacteristic_value">defined as tokensa>. |
| 3409 | + p> |
3366 | 3410 |
|
3367 | 3411 | <div class="note">
|
3368 | 3412 | <p>
|
|
4378 | 4422 | <h2>Change logh2>
|
4379 | 4423 | <h3>Substantive changes since the last published Recommendationh3>
|
4380 | 4424 | <ul>
|
| 4425 | + <li> |
| 4426 | + 18-Jan-2022: |
| 4427 | + Added <a href="#docconformance-deprecated">Requirements for deprecated ARIA role, state and property and attributesa>. |
| 4428 | + li> |
4381 | 4429 | <li>
|
4382 | 4430 | 06-Jan-2022:
|
4383 | 4431 | Change allowances for `doc-biblioentry` and `doc-endnote` roles on the <a href="#el-li">`li` elementa>.
|
|
0 commit comments