Skip to content

Commit 4520d90

Browse files
committed
Add outputPreference terms section.
1 parent 533b218 commit 4520d90

1 file changed

Lines changed: 102 additions & 1 deletion

File tree

index.html

Lines changed: 102 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -677,7 +677,7 @@ <h3>The `html` Render Suite</h3>
677677
"digestMultibase": "zQmerWC85Wg6wFl9znFCwYxApG270iEu5h6JqWAPdhyxz2dR"
678678
},
679679
"outputPreference": {
680-
"mode": [
680+
"accessMode": [
681681
"visual"
682682
],
683683
"mediaType": "application/html",
@@ -851,6 +851,107 @@ <h5>Ready and Error Events</h5>
851851
of an error.
852852
</p>
853853

854+
<h3>Output Preferences</h3>
855+
<p>
856+
Rendering environment preferences MAY be provided within the Render Method. The
857+
objective of this object is to provide suggested use, display, and intended
858+
access mode when rendering the provided template. An implementation SHOULD
859+
follow these preferences when provided.
860+
</p>
861+
862+
<table class="simple">
863+
<thead>
864+
<tr>
865+
<th style="white-space: nowrap">Property</th>
866+
<th>Description</th>
867+
</tr>
868+
</thead>
869+
<tbody>
870+
<tr>
871+
<td>outputPreference</td>
872+
<td>
873+
An OPTIONAL [=map=] that expresses suggested preferences for the rendering
874+
environment.
875+
</td>
876+
</tr>
877+
</tbody>
878+
</table>
879+
880+
<p>The `outputPreference` object MAY contain any of the following:</p>
881+
882+
<table class="simple">
883+
<thead>
884+
<tr>
885+
<th style="white-space: nowrap">Property</th>
886+
<th>Description</th>
887+
</tr>
888+
</thead>
889+
<tbody>
890+
<tr>
891+
<td>accessMode</td>
892+
<td>
893+
An OPTIONAL [=list=] of one or more [=string=] values of `auditory`, `tactile`,
894+
`textual`, or `visual` as defined in
895+
<!-- TODO: use Respec ref not URL -->
896+
https://w3c.github.io/cg-reports/a11y-discov-vocab/CG-FINAL-vocabulary-20260128/#accessMode-vocabulary
897+
</td>
898+
</tr>
899+
<tr>
900+
<td>accessMode</td>
901+
<td>
902+
An OPTIONAL [=list=] of one or more [=string=] values of `auditory`, `tactile`,
903+
`textual`, or `visual` as defined in
904+
<!-- TODO: use Respec ref not URL -->
905+
https://w3c.github.io/cg-reports/a11y-discov-vocab/CG-FINAL-vocabulary-20260128/#accessMode-vocabulary
906+
</td>
907+
</tr>
908+
<tr>
909+
<td>mediaType</td>
910+
<td>
911+
An OPTIONAL [=string=] stating a valid media type listed in the
912+
<a href="https://www.iana.org/assignments/media-types/media-types.xhtml">
913+
IANA Media Types</a> preferred for rendering. This value MAY be used when
914+
suggesting addtional processing prior to rendering. Examples include converting
915+
an SVG template into a static image or an HTML document into a PDF.
916+
</td>
917+
</tr>
918+
<tr>
919+
<td>style</td>
920+
<td>
921+
An OPTIONAL [=map=] which defines style properties to potentially be used by
922+
the rendering environment.
923+
</td>
924+
</tr>
925+
</tbody>
926+
</table>
927+
928+
<p>The `style` object MAY contain any of the following properties:</p>
929+
930+
<table class="simple">
931+
<thead>
932+
<tr>
933+
<th style="white-space: nowrap">Property</th>
934+
<th>Description</th>
935+
</tr>
936+
</thead>
937+
<tbody>
938+
<tr>
939+
<td>width</td>
940+
<td>
941+
An OPTIONAL [=string=] containing a CSS compatible width preference to be set
942+
on the `iframe`.
943+
</td>
944+
</tr>
945+
<tr>
946+
<td>height</td>
947+
<td>
948+
An OPTIONAL [=string=] containing a CSS compatible height preference to be set
949+
on the `iframe`.
950+
</td>
951+
</tr>
952+
</tbody>
953+
</table>
954+
854955
<h3>Algorithms</h3>
855956
<p>
856957
The following sections outline the algorithms that are used by the `html` render

0 commit comments

Comments
 (0)