From 4520d90ef99652b5922619eebc6c4ed1f0c5db4d Mon Sep 17 00:00:00 2001 From: Benjamin Young Date: Thu, 26 Mar 2026 12:32:33 -0400 Subject: [PATCH 1/3] Add outputPreference terms section. --- index.html | 103 ++++++++++++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 102 insertions(+), 1 deletion(-) diff --git a/index.html b/index.html index a8bd844..e70ec3c 100644 --- a/index.html +++ b/index.html @@ -677,7 +677,7 @@

The `html` Render Suite

"digestMultibase": "zQmerWC85Wg6wFl9znFCwYxApG270iEu5h6JqWAPdhyxz2dR" }, "outputPreference": { - "mode": [ + "accessMode": [ "visual" ], "mediaType": "application/html", @@ -851,6 +851,107 @@
Ready and Error Events
of an error.

+

Output Preferences

+

+Rendering environment preferences MAY be provided within the Render Method. The +objective of this object is to provide suggested use, display, and intended +access mode when rendering the provided template. An implementation SHOULD +follow these preferences when provided. +

+ + + + + + + + + + + + + + +
PropertyDescription
outputPreference +An OPTIONAL [=map=] that expresses suggested preferences for the rendering +environment. +
+ +

The `outputPreference` object MAY contain any of the following:

+ + + + + + + + + + + + + + + + + + + + + + + + + + +
PropertyDescription
accessMode +An OPTIONAL [=list=] of one or more [=string=] values of `auditory`, `tactile`, +`textual`, or `visual` as defined in + +https://w3c.github.io/cg-reports/a11y-discov-vocab/CG-FINAL-vocabulary-20260128/#accessMode-vocabulary +
accessMode +An OPTIONAL [=list=] of one or more [=string=] values of `auditory`, `tactile`, +`textual`, or `visual` as defined in + +https://w3c.github.io/cg-reports/a11y-discov-vocab/CG-FINAL-vocabulary-20260128/#accessMode-vocabulary +
mediaType +An OPTIONAL [=string=] stating a valid media type listed in the + +IANA Media Types preferred for rendering. This value MAY be used when +suggesting addtional processing prior to rendering. Examples include converting +an SVG template into a static image or an HTML document into a PDF. +
style +An OPTIONAL [=map=] which defines style properties to potentially be used by +the rendering environment. +
+ +

The `style` object MAY contain any of the following properties:

+ + + + + + + + + + + + + + + + + + +
PropertyDescription
width +An OPTIONAL [=string=] containing a CSS compatible width preference to be set +on the `iframe`. +
height +An OPTIONAL [=string=] containing a CSS compatible height preference to be set +on the `iframe`. +
+

Algorithms

The following sections outline the algorithms that are used by the `html` render From bf4827ad50cfd5c61c3cd647b272010404df7f6b Mon Sep 17 00:00:00 2001 From: BigBlueHat Date: Tue, 5 May 2026 09:11:34 -0400 Subject: [PATCH 2/3] Remove duplicate `accessMode` text. Co-authored-by: Ivan Herman --- index.html | 9 --------- 1 file changed, 9 deletions(-) diff --git a/index.html b/index.html index e70ec3c..6a40d35 100644 --- a/index.html +++ b/index.html @@ -893,15 +893,6 @@

Output Preferences

An OPTIONAL [=list=] of one or more [=string=] values of `auditory`, `tactile`, `textual`, or `visual` as defined in -https://w3c.github.io/cg-reports/a11y-discov-vocab/CG-FINAL-vocabulary-20260128/#accessMode-vocabulary - - - - accessMode - -An OPTIONAL [=list=] of one or more [=string=] values of `auditory`, `tactile`, -`textual`, or `visual` as defined in - https://w3c.github.io/cg-reports/a11y-discov-vocab/CG-FINAL-vocabulary-20260128/#accessMode-vocabulary From 5f14cfb08026c6f7d8bbc2f9ccc9ff741d35e32e Mon Sep 17 00:00:00 2001 From: BigBlueHat Date: Tue, 19 May 2026 09:50:47 -0400 Subject: [PATCH 3/3] Apply suggestions from code review. Co-authored-by: Ted Thibodeau Jr Co-authored-by: BigBlueHat --- index.html | 13 +++++++------ 1 file changed, 7 insertions(+), 6 deletions(-) diff --git a/index.html b/index.html index 6a40d35..29cdd44 100644 --- a/index.html +++ b/index.html @@ -854,7 +854,7 @@
Ready and Error Events

Output Preferences

Rendering environment preferences MAY be provided within the Render Method. The -objective of this object is to provide suggested use, display, and intended +purpose of this object is to provide suggested use, display, and intended access mode when rendering the provided template. An implementation SHOULD follow these preferences when provided.

@@ -870,14 +870,15 @@

Output Preferences

outputPreference -An OPTIONAL [=map=] that expresses suggested preferences for the rendering -environment. +An OPTIONAL [=map=] that expresses the preferred rendering environment for the provided template. -

The `outputPreference` object MAY contain any of the following:

+

+The `outputPreference` object MAY contain any of the following properties: +

@@ -900,8 +901,8 @@

Output Preferences

mediaType An OPTIONAL [=string=] stating a valid media type listed in the - -IANA Media Types preferred for rendering. This value MAY be used when +IANA Media Types preferred for rendering. This value MAY be used when suggesting addtional processing prior to rendering. Examples include converting an SVG template into a static image or an HTML document into a PDF.