Skip to content

Commit

Permalink
Editorial: make preload attributes table consistent
Browse files Browse the repository at this point in the history
Helps with #9832.
  • Loading branch information
keithamus authored and domenic committed Oct 17, 2023
1 parent b9ec207 commit 4277faa
Showing 1 changed file with 15 additions and 14 deletions.
29 changes: 15 additions & 14 deletions source
Original file line number Diff line number Diff line change
Expand Up @@ -36851,18 +36851,15 @@ interface <dfn interface>MediaError</dfn> {
<hr>

<p>The <dfn element-attr for="audio,video"><code data-x="attr-media-preload">preload</code></dfn>
attribute is an <span>enumerated attribute</span>. The following table lists the keywords and
states for the attribute &mdash; the keywords in the left column map to the states in the cell in
the second column on the same row as the keyword. The attribute can be changed even once the
<span>media resource</span> is being buffered or played; the descriptions in the table below are
to be interpreted with that in mind.</p>
attribute is an <span>enumerated attribute</span> with the following keywords and
states:</p>

<table>
<thead>
<tr>
<th> Keyword
<th> State
<th> Brief description
<th>Keyword
<th>State
<th>Brief description
<tbody>
<tr>
<td><dfn attr-value for="audio/preload,video/preload"><code
Expand All @@ -36879,17 +36876,21 @@ interface <dfn interface>MediaError</dfn> {
<tr>
<td><dfn attr-value for="audio/preload,video/preload"><code
data-x="attr-media-preload-auto">auto</code></dfn>
<td><dfn data-x="attr-media-preload-auto-state">Automatic</dfn>
<td>Hints to the user agent that the user agent can put the user's needs first without risk to the server, up to and including optimistically downloading the entire resource.
<td rowspan=2><dfn data-x="attr-media-preload-auto-state">Automatic</dfn>
<td rowspan=2>Hints to the user agent that the user agent can put the user's needs first without risk to the server, up to and including optimistically downloading the entire resource.
<tr>
<td>(The empty string)
</table>

<p>The empty string is also a valid keyword, and maps to the <span
data-x="attr-media-preload-auto-state">Automatic</span> state. The attribute's <i data-x="missing
value default">missing value default</i> and <i data-x="invalid value default">invalid value
default</i> are <span>implementation-defined</span>, though the <span
<p>The attribute's <i data-x="missing value default">missing value default</i> and <i
data-x="invalid value default">invalid value default</i> are both
<span>implementation-defined</span>, though the <span
data-x="attr-media-preload-metadata-state">Metadata</span> state is suggested as a compromise
between reducing server load and providing an optimal user experience.</p>

<p>The attribute can be changed even once the <span>media resource</span> is being buffered or
played; the descriptions in the table above are to be interpreted with that in mind.</p>

<p class="note">Authors might switch the attribute from "<code
data-x="attr-media-preload-none">none</code>" or "<code
data-x="attr-media-preload-metadata">metadata</code>" to "<code
Expand Down

0 comments on commit 4277faa

Please sign in to comment.