GitHub

@@ -5925,7 +5925,32 @@ <h4>Plain HTML or Polyfill DOM Result of the MathML Quadratic Formula</h4>

59255925

<div class="role" id="note">

59265926

<rdef>note</rdef>

59275927

<div class="role-description">

5928-

<p>A section whose content is parenthetic or ancillary to the main content of the resource.</p>

5928+

<p>A <rref>section</rref> whose content represents additional information or parenthetical context to the primary content it supplements.</p>

5929+

<p>A <code>note</code> is content provided by the author of the page or document, it is not to be used for providing reactions or suggestions. For these purposes, please review <rref>comment</rref> and <rref>suggestion</rref>.</p>

5930+

<p>When used within the normal flow of a page's content, a <code>note</code> has an implicit association with the content that it supplements. The following example demonstrates using a <code>note</code> to call out additional information in the natural reading order of a page:</p>

5931+

<pre class="example highlight">

5932+

&lt;p>... the following results outline support for the tested features.&lt;/p>

5933+

&lt;div role="note">

5934+

&lt;p>Please keep in mind that at the time of publishing this page all results were accurate.&lt;/p>

5935+

&lt;p>If you find any variations in results, please let us know!&lt;/p>

5936+

&lt;/div>

5937+

&lt;p>...&lt;/p>

5938+

</pre>

5939+

<p>In cases where an element with role <rref>note</rref> has been determined to need a programmatic association with the content it supplements, authors can use one of the following mechanisms to associate the elements:</p>

5940+

<ul>

5941+

<li>If the <code>note</code> contains structured or interactive content (for example, a link, button, list, table, etc.) use <pref>aria-details</pref>.</li>

5942+

<li>If the <code>note</code> is brief and consists of static text, use <pref>aria-describedby</pref>.</li>

5943+

</ul>

5944+

<pre class="example highlight">

5945+

&lt;!-- using aria-details to reference a note containing a link -->

5946+

...

5947+

&lt;button aria-details="info-note">Get Started&lt;/button>

5948+

...

5949+

&lt;div role="note" id="info-note">

5950+

&lt;p>Need more information before you get started?&lt;/p>

5951+

&lt;p>Visit our &lt;a href="...">product description page&lt;/a> to get all the information you need.&lt;/p>

5952+

&lt;/div>

5953+

</pre>

59295954

</div>

59305955

<table class="role-features">

59315956

<caption>Characteristics:</caption>

Read the original on github.com ↗