Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add non-normative and optional texts. #208

Merged
merged 2 commits into from
Feb 14, 2024
Merged
Changes from 1 commit
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
11 changes: 8 additions & 3 deletions index.bs
Original file line number Diff line number Diff line change
Expand Up @@ -543,18 +543,21 @@ url: https://w3c.github.io/permissions/#permissions-task-source; type: dfn;
and suffix (after stripping out `"web "`) passes the [=parsing a MIME type=] check.

<h3 id="unsanitized-data-types-x"><dfn>Unsanitized data types</dfn></h3>
<em>This section is non-normative.</em>

These data types MUST NOT be sanitized by UAs:
These data types MAY NOT be sanitized by UAs:

* image/png

* [=optional unsanitized data types=]

<dfn>Optional unsanitized data types</dfn> are [=representation/mime type=]s specified by the web authors that MUST NOT be sanitized by the user agent.
<dfn>Optional unsanitized data types</dfn> are [=representation/mime type=]s specified by the web authors that MAY NOT be sanitized by the user agent.
snianu marked this conversation as resolved.
Show resolved Hide resolved
The valid [=optional unsanitized data types=] are listed below:

* text/html

<p class=note> [=optional unsanitized data types=] may not be supported by the user agent. In some privacy modes the [=representation/mime type=]s listed in [=optional unsanitized data types=] may not be unsanitized.</p>
snianu marked this conversation as resolved.
Show resolved Hide resolved

<h2 id="async-clipboard-api">Asynchronous Clipboard API</h2>

<h3 id="navigator-interface">Navigator Interface</h3>
Expand Down Expand Up @@ -817,6 +820,8 @@ url: https://w3c.github.io/permissions/#permissions-task-source; type: dfn;

{{ClipboardUnsanitizedFormats/unsanitized}} is a [=sequence=] of {{DOMString}}s corresponding to the [=representation/mime type=] that the author wants to be treated as [=optional unsanitized data types=].

<p class=note> The {{ClipboardUnsanitizedFormats/unsanitized}} option MAY NOT be supported by the user agent. The web authors shouldn't assume that the content for the MIME types listed in {{ClipboardUnsanitizedFormats/unsanitized}} would be unsanitized as there could be privacy modes where this option may not be allowed. </p>

The <dfn>clipboard task source</dfn> is triggered in response to reading or writing of [=system clipboard data=].

<div id="clipboard-idl" dfn-for="Clipboard">
Expand Down Expand Up @@ -874,7 +879,7 @@ url: https://w3c.github.io/permissions/#permissions-task-source; type: dfn;

Issue: It should be possible to read the data asynchronously from the system clipboard after the author calls getType, however, this set of steps implies that data will be provided at the time of read.

1. The user agent, MUST NOT sanitize |representation|'s [=representation/data=], if it satisfies the below conditions:
1. The user agent, MAY NOT sanitize |representation|'s [=representation/data=], if it satisfies the below conditions:
snianu marked this conversation as resolved.
Show resolved Hide resolved

1. |representation|'s [=representation/MIME type=] is in [=unsanitized data types=] list.

Expand Down
Loading