diff --git a/index.html b/index.html index cbbf43e..71956df 100644 --- a/index.html +++ b/index.html @@ -701,29 +701,15 @@

Definition of Roles

doc-biblioentry
-

A single reference to an external source in a bibliography. A biblioentry typically provides - more detailed information than its reference(s) in the content (e.g., full title, author(s), - publisher, publication date, etc.).

-

Authors MUST ensure that elements with role doc-biblioentry are contained - in, or owned, by an element with the role list.

-
<section role="doc-bibliography">
-   <h1>Cited Works</h1>
-   <div role="list">
-      <p role="doc-biblioentry" id="b8cab5dd-bc24-459c-9858-7afa9da69b64">
-         John Steinbeck, The Grapes of Wrath (New York: The Viking Press, 1939)
-      </p>
-   </div>
-   …
-</section>
-
<section role="doc-bibliography">
-   <h1>Select Bibliography</h1>
-   <ul>
-      <li role="doc-biblioentry" id="faulkner-dying">
-         William Faulkner, As I Lay Dying (New York: Jonathan Cape & Harrison Smith, 1930)
-      </li>
-   </ul>
-   …
-</section>
+

[Deprecated in DPUB-ARIA 1.1] A single reference to an external source in a bibliography. A + biblioentry typically provides more detailed information than its reference(s) in the content + (e.g., full title, author(s), publisher, publication date, etc.).

+

The doc-biblioentry + role was designed for use as a list item, but due to clarifications in the WAI-ARIA + specification, it is not valid as a child of the list role. As the + doc-bibliography role already identifies a section of bibliography entries, authors + are instead advised to use the list and listitem roles when native HTML + elements cannot be used to structure the entries.

@@ -740,7 +726,7 @@

Definition of Roles

- + @@ -758,7 +744,7 @@

Definition of Roles

- + @@ -852,7 +838,7 @@

Definition of Roles

- + @@ -1595,33 +1581,15 @@

Definition of Roles

doc-endnote
-

One of a collection of notes that occur at the end of a work, or a section within it, that - provides additional context to a referenced passage of text.

-

Authors MUST ensure that elements with role - doc-endnote are contained in, or owned, by an element with the role - list.

-
<section role="doc-endnotes">
-   <h2>Notes</h2>
-   <ol>
-      <li id="6baa07af" role="doc-endnote">Additional results of this study can be found at … </li>
-      <li id="7b2c0555" role="doc-endnote">…</li>
-      …
-   </ol>
-</section>
-
<section role="doc-endnotes">
-   <h2>Notes</h2>
-   <section id="ch1-notes">
-      <h3>Chapter 1</h3>
-      <div role="list">
-         <p id="6baa07af" role="doc-endnote">1. Additional results of this study can be found at … </p>
-         <div id="7b2c0555" role="doc-endnote">
-            <p>2. The primary source of information …</p>
-            <p class="note-cont">In the case of secondary studies …</p>
-         </div>
-         …
-      </div>
-   </section>
-</section>
+

[Deprecated in DPUB-ARIA 1.1] One of a collection of notes that occur at the end of a work, or a + section within it, that provides additional context to a referenced passage of text.

+

The doc-endnote + role was designed for use as a list item, but due to clarifications in the WAI-ARIA + specification, it is not valid as a child of the list role. As the + doc-endnotes role already identifies a section of endnotes, authors are instead + advised to use the list and listitem roles when native HTML elements + cannot be used to structure the entries. The doc-footnote role can be used within each + list item to identify individual notes when necessary.

Characteristics:
Superclass Role:listitem
Subclass Roles:
Required Context Role:doc-bibliography
Required Owned Elements:
Required Owned Elements:doc-biblioentry
Required States and Properties:
@@ -1656,7 +1624,7 @@

Definition of Roles

- + @@ -1706,13 +1674,16 @@

Definition of Roles

A collection of notes at the end of a work or a section within it.

Note that the doc-endnotes - role is never applied directly to the list of endnotes. See the - doc-endnote role for more information.

+ role is never applied directly to the list of endnotes.

<section role="doc-endnotes">
    <h2>Notes</h2>
    <ol>
-      <li id="6baa07af" role="doc-endnote">Additional results of this study can be found at … </li>
-      <li id="7b2c0555" role="doc-endnote">…</li>
+      <li id="6baa07af">
+         <p role="doc-footnote">Additional results of this study can be found at … </p>
+      </li>
+      <li id="7b2c0555">
+         <p role="doc-footnote">…</p>
+      </li>
       …
    </ol>
 </section>
@@ -1754,7 +1725,7 @@

Definition of Roles

- + @@ -3962,6 +3933,8 @@

Substantive changes since the 25-July-2020: Recommend that doc-pagebreak name be end user-consumable.
  • 24-July-2020: Changed the superclass of doc-example to figure to make compatible with use on HTML figure.
  • +
  • 23-July-2020: Deprecated the doc-biblioentry and doc-endnote roles due to + the inability of them to be recognized as children of list.
  • Characteristics:
    Required Context Role:doc-endnotes
    Required Owned Elements:
    Required Owned Elements:doc-endnote
    Required States and Properties: