Skip to content
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
279 changes: 279 additions & 0 deletions WIP/export-9.html
Original file line number Diff line number Diff line change
@@ -0,0 +1,279 @@
<h4 id="pdf-bibentry-biblioentry">`BibEntry`</h4>
<table class="data" aria-labelledby="pdf-bibentry-biblioentry">
<tbody>
<tr>
<th>PDF Specification</th>
<td>ISO 32000-2:2020, Annex M</td>
</tr>
<tr>
<th>ARIA Specification</th>
<td><a class="core-mapping" href="#role-map-biblioentry">Role: `doc-biblioentry`</a> <span class="el-context">(DPub)</span></td>
</tr>
<tr>
<th>Analogous HTML Element</th>
<td>Use WAI-ARIA mapping</td>
</tr>
<tr>
<th>MSAA + IAccessible2</th>
<td>Use WAI-ARIA mapping</td>
</tr>
<tr>
<th><abbr title="User Interface Automation">UIA</abbr></th>
<td>Use WAI-ARIA mapping</td>
</tr>
<tr>
<th><abbr title="Accessibility Toolkit">ATK</abbr>/<abbr title="Assistive Technology - Service Provider Interface">AT-SPI</abbr></th>
<td>Use WAI-ARIA mapping</td>
</tr>
<tr>
<th><abbr title="macOS Accessibility Protocol">AX API</abbr></th>
<td>Use WAI-ARIA mapping</td>
</tr>
<tr>
<th><abbr title="Notes">Notes:</abbr></th>
<td>
<span class="property">Note from PDFa: <code>Use WAI-ARIA mapping</code></span>
</td>
</tr>
</tbody>
</table>

<h4 id="pdf-bibentry-listitem">`BibEntry`</h4>
<table class="data" aria-labelledby="pdf-bibentry-listitem">
<tbody>
<tr>
<th>PDF Specification</th>
<td>ISO 32000-2:2020, Annex M</td>
</tr>
<tr>
<th>ARIA Specification</th>
<td><a class="core-mapping" href="#role-map-listitem">Role: `listitem`</a></td>
</tr>
<tr>
<th>Analogous HTML Element</th>
<td>Use WAI-ARIA mapping</td>

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

See my comment at line 46.

</tr>
<tr>
<th>MSAA + IAccessible2</th>
<td>Use WAI-ARIA mapping</td>
</tr>
<tr>
<th><abbr title="User Interface Automation">UIA</abbr></th>
<td>Use WAI-ARIA mapping</td>
</tr>
<tr>
<th><abbr title="Accessibility Toolkit">ATK</abbr>/<abbr title="Assistive Technology - Service Provider Interface">AT-SPI</abbr></th>
<td>Use WAI-ARIA mapping</td>
</tr>
<tr>
<th><abbr title="macOS Accessibility Protocol">AX API</abbr></th>
<td>Use WAI-ARIA mapping</td>
</tr>
<tr>
<th><abbr title="Notes">Notes:</abbr></th>
<td>
<span class="property">Note from PDFa: <code>Use WAI-ARIA mapping</code></span>

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
<span class="property">Note from PDFa: <code>Use WAI-ARIA mapping</code></span>
<span class="property">Note: <code>TBD</code></span>

</td>
</tr>
</tbody>
</table>

<h4 id="pdf-bibentry-paragraph">`BibEntry We used this one in our &quot;article&quot;`</h4>
<table class="data" aria-labelledby="pdf-bibentry-paragraph">
<tbody>
<tr>
<th>PDF Specification</th>
<td>Annex M</td>
</tr>
<tr>
<th>ARIA Specification</th>
<td><a class="core-mapping" href="#role-map-paragraph">Role: `paragraph`</a></td>
</tr>
<tr>
<th>Analogous HTML Element</th>
<td><a class="html-mapping" href="#el-p">Role: `p`</a></td>
</tr>
<tr>
<th>MSAA + IAccessible2</th>
<td>Use WAI-ARIA mapping</td>
</tr>
<tr>
<th><abbr title="User Interface Automation">UIA</abbr></th>
<td>Use WAI-ARIA mapping</td>
</tr>
<tr>
<th><abbr title="Accessibility Toolkit">ATK</abbr>/<abbr title="Assistive Technology - Service Provider Interface">AT-SPI</abbr></th>
<td>Use WAI-ARIA mapping</td>
</tr>
<tr>
<th><abbr title="macOS Accessibility Protocol">AX API</abbr></th>
<td>Use WAI-ARIA mapping</td>
</tr>
<tr>
<th><abbr title="Notes">Notes:</abbr></th>
<td>
<span class="property">Note from PDFa: <code>Use WAI-ARIA mapping</code></span>

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
<span class="property">Note from PDFa: <code>Use WAI-ARIA mapping</code></span>
<span class="property">Note: <code>TBD</code></span>

</td>
</tr>
</tbody>
</table>

<h4 id="pdf-index-doc-index">`Index Parked for ARIA / Reuse discussions`</h4>
<table class="data" aria-labelledby="pdf-index-doc-index">
<tbody>
<tr>
<th>PDF Specification</th>
<td>ISO 32000-2:2020, Annex M</td>
</tr>
<tr>
<th>ARIA Specification</th>
<td><a class="core-mapping" href="#role-map-index">Role: `doc-index`</a> <span class="el-context">(DPub)</span></td>
</tr>
<tr>
<th>Analogous HTML Element</th>
<td>Use WAI-ARIA mapping</td>

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

If my suggestion at line 217 is correct then these subsequent rows should map to DPub, not WAI-ARIA.

</tr>
<tr>
<th>MSAA + IAccessible2</th>
<td>Use WAI-ARIA mapping</td>
</tr>
<tr>
<th><abbr title="User Interface Automation">UIA</abbr></th>
<td>Use WAI-ARIA mapping</td>
</tr>
<tr>
<th><abbr title="Accessibility Toolkit">ATK</abbr>/<abbr title="Assistive Technology - Service Provider Interface">AT-SPI</abbr></th>
<td>Use WAI-ARIA mapping</td>
</tr>
<tr>
<th><abbr title="macOS Accessibility Protocol">AX API</abbr></th>
<td>Use WAI-ARIA mapping</td>
</tr>
<tr>
<th><abbr title="Notes">Notes:</abbr></th>
<td>
<span class="property">Note from PDFa: <code>Use WAI-ARIA mapping</code></span>
</td>
</tr>
</tbody>
</table>

<h4 id="pdf-index-navigation">`Index Parked for ARIA / Reuse discussions`</h4>
<table class="data" aria-labelledby="pdf-index-navigation">
<tbody>
<tr>
<th>PDF Specification</th>
<td>ISO 32000-2:2020, Annex M</td>
</tr>
<tr>
<th>ARIA Specification</th>
<td><a class="core-mapping" href="#role-map-navigation">Role: `navigation`</a></td>
</tr>
<tr>
<th>Analogous HTML Element</th>
<td>Use WAI-ARIA mapping</td>
</tr>
<tr>
<th>MSAA + IAccessible2</th>
<td>Use WAI-ARIA mapping</td>
</tr>
<tr>
<th><abbr title="User Interface Automation">UIA</abbr></th>
<td>Use WAI-ARIA mapping</td>
</tr>
<tr>
<th><abbr title="Accessibility Toolkit">ATK</abbr>/<abbr title="Assistive Technology - Service Provider Interface">AT-SPI</abbr></th>
<td>Use WAI-ARIA mapping</td>
</tr>
<tr>
<th><abbr title="macOS Accessibility Protocol">AX API</abbr></th>
<td>Use WAI-ARIA mapping</td>
</tr>
<tr>
<th><abbr title="Notes">Notes:</abbr></th>
<td>
<span class="property">Note from PDFa: <code>Use WAI-ARIA mapping</code></span>

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
<span class="property">Note from PDFa: <code>Use WAI-ARIA mapping</code></span>
<span class="property">Note: <code>TBD</code></span>

</td>
</tr>
</tbody>
</table>

<h4 id="pdf-index-region">`Index Parked for ARIA / Reuse discussions`</h4>
<table class="data" aria-labelledby="pdf-index-region">
<tbody>
<tr>
<th>PDF Specification</th>
<td>ISO 32000-2:2020, Annex M</td>
</tr>
<tr>
<th>ARIA Specification</th>
<td><a class="core-mapping" href="#role-map-region">Role: `region (with an accessible name) OR generic`</a> <span class="el-context">(if no accessible name)</span></td>
</tr>
<tr>
<th>Analogous HTML Element</th>
<td><a class="html-mapping" href="#el-section">Role: `section - IF the section element has an accessible name`</a></td>
</tr>
<tr>
<th>MSAA + IAccessible2</th>
<td>Use WAI-ARIA mapping</td>
</tr>
<tr>
<th><abbr title="User Interface Automation">UIA</abbr></th>
<td>Use WAI-ARIA mapping</td>
</tr>
<tr>
<th><abbr title="Accessibility Toolkit">ATK</abbr>/<abbr title="Assistive Technology - Service Provider Interface">AT-SPI</abbr></th>
<td>Use WAI-ARIA mapping</td>
</tr>
<tr>
<th><abbr title="macOS Accessibility Protocol">AX API</abbr></th>
<td>Use WAI-ARIA mapping</td>
</tr>
<tr>
<th><abbr title="Notes">Notes:</abbr></th>
<td>
<span class="property">Note from PDFa: <code>NOTE: There is no &quot;section with (or without) accessible name&quot; but the ARIA role could be different based on whether or not there is an accessible name.</code></span>

@PaulRayius-2 PaulRayius-2 May 8, 2026

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
<span class="property">Note from PDFa: <code>NOTE: There is no &quot;section with (or without) accessible name&quot; but the ARIA role could be different based on whether or not there is an accessible name.</code></span>
<span class="property">Note: <code>TBD</code></span>

Question: NOTE: The ARIA role could be different based on whether or not there is an accessible name? Is that right or did I misunderstand, before? There is something about using ARIA - "region" if there is an accessible name but "generic" if there is no accessible name. Not sure about this.

</td>
</tr>
</tbody>
</table>

<h4 id="pdf-index-generic">`Index Parked for ARIA / Reuse discussions`</h4>
<table class="data" aria-labelledby="pdf-index-generic">
<tbody>
<tr>
<th>PDF Specification</th>
<td>ISO 32000-2:2020, Annex M</td>
</tr>
<tr>
<th>ARIA Specification</th>
<td><a class="core-mapping" href="#role-map-generic">Role: `generic`</a></td>
</tr>
<tr>
<th>Analogous HTML Element</th>
<td><a class="html-mapping" href="#el-section">Role: `section - IF the section element does not have an accessible name`</a></td>
</tr>
<tr>
<th>MSAA + IAccessible2</th>
<td>Use WAI-ARIA mapping</td>
</tr>
<tr>
<th><abbr title="User Interface Automation">UIA</abbr></th>
<td>Use WAI-ARIA mapping</td>
</tr>
<tr>
<th><abbr title="Accessibility Toolkit">ATK</abbr>/<abbr title="Assistive Technology - Service Provider Interface">AT-SPI</abbr></th>
<td>Use WAI-ARIA mapping</td>
</tr>
<tr>
<th><abbr title="macOS Accessibility Protocol">AX API</abbr></th>
<td>Use WAI-ARIA mapping</td>
</tr>
<tr>
<th><abbr title="Notes">Notes:</abbr></th>
<td>
<span class="property">Note from PDFa: <code>Hold for consultation with W3C experts. The HTML table and Derivation group said to use &quot;generic,&quot; (and the related ARIA mapping), but the ARIA roll mapping table says otherwise.</code></span>

@PaulRayius-2 PaulRayius-2 May 8, 2026

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
<span class="property">Note from PDFa: <code>Hold for consultation with W3C experts. The HTML table and Derivation group said to use &quot;generic,&quot; (and the related ARIA mapping), but the ARIA roll mapping table says otherwise.</code></span>
<span class="property">Note: <code>Use this mapping if there is not an accessible name.</code></span>

There is a question here, though: The HTML table and Derivation group said to use "generic," (and the related ARIA mapping), but the ARIA roll mapping table says otherwise. @romantoda , @daniel-montalvo , @zakkinsey

</td>
</tr>
</tbody>
</table>