Skip to content

Commit f7c67d4

Browse files
committed
deploy: 7ed4eb0
1 parent fee3c5c commit f7c67d4

File tree

1 file changed

+18
-5
lines changed

1 file changed

+18
-5
lines changed

index.html

Lines changed: 18 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -5,9 +5,9 @@
55
<title>Web Platform Design Principles</title>
66
<meta content="ED" name="w3c-status">
77
<link href="https://www.w3.org/StyleSheets/TR/2021/W3C-ED" rel="stylesheet">
8-
<meta content="Bikeshed version d765c696b, updated Fri Mar 8 15:58:52 2024 -0800" name="generator">
8+
<meta content="Bikeshed version 4afc1fdf9, updated Tue May 28 15:43:17 2024 -0700" name="generator">
99
<link href="https://www.w3.org/TR/design-principles/" rel="canonical">
10-
<meta content="ca6bfaf2b29a260045b580ff86ed20c67b0f2a2e" name="revision">
10+
<meta content="7ed4eb049c2f860bcff809ef87193c855ac4959a" name="revision">
1111
<meta content="dark light" name="color-scheme">
1212
<link href="https://www.w3.org/StyleSheets/TR/2021/dark.css" media="(prefers-color-scheme: dark)" rel="stylesheet" type="text/css">
1313
<style>
@@ -701,7 +701,7 @@
701701
<div class="head">
702702
<p data-fill-with="logo"><a class="logo" href="https://www.w3.org/"> <img alt="W3C" height="48" src="https://www.w3.org/StyleSheets/TR/2021/logos/W3C" width="72"> </a> </p>
703703
<h1 class="p-name no-ref" id="title">Web Platform Design Principles</h1>
704-
<p id="w3c-state"><a href="https://www.w3.org/standards/types#ED">Editor’s Draft</a>, <time class="dt-updated" datetime="2024-04-22">22 April 2024</time></p>
704+
<p id="w3c-state"><a href="https://www.w3.org/standards/types#ED">Editor’s Draft</a>, <time class="dt-updated" datetime="2024-06-03">3 June 2024</time></p>
705705
<details open>
706706
<summary>More details about this document</summary>
707707
<div data-fill-with="spec-metadata">
@@ -1040,6 +1040,10 @@ <h3 class="heading settled" data-level="1.4" id="consent"><span class="secno">1.
10401040
However, the <a href="#priority-of-constituencies">user benefit</a> of a new feature must justify the additional burden on users
10411041
to decide whether to grant permission for each feature
10421042
whenever it’s requested by a Web page.</p>
1043+
<p>Refusal is most effective if the site cannot
1044+
distinguish refusal from other, common situations.
1045+
This can make it more difficult for a site to
1046+
pressure users to grant consent.</p>
10431047
<p class="example" id="example-07793d34"><a class="self-link" href="#example-07793d34"></a> For example,
10441048
the <a href="https://www.w3.org/TR/geolocation-API/">Geolocation API</a> grants access to a user’s location.
10451049
This can help users in some contexts,
@@ -1283,10 +1287,17 @@ <h3 class="heading settled" data-level="2.5" id="feature-detect"><span class="se
12831287
(such as <a class="css" data-link-type="maybe" href="https://drafts.csswg.org/css-conditional-3/#at-ruledef-supports" id="ref-for-at-ruledef-supports">@supports</a> in CSS).</p>
12841288
<p>In some cases, it may <strong>not</strong> be appropriate to allow feature detection.
12851289
Whether the feature should be detectable or not
1286-
should be based on the <a href="#priority-of-constituencies">user need</a> for the feature:
1287-
if there is a user need or design principle which would fail
1290+
should be based on the <a href="#priority-of-constituencies">user need</a> for the feature.
1291+
If there is a user need or design principle which would fail
12881292
if feature detection were available for the feature,
12891293
then you should not support feature detection.</p>
1294+
<p>Detecting the availability of a feature does not imply
1295+
detecting whether <a href="#consent">consent</a> to use the feature
1296+
has been granted.
1297+
Generally, detecting whether the feature is implemented
1298+
can be done separately from determining whether use of the feature has been authorized.
1299+
In some cases, it might be necessary to disable feature detection
1300+
in order to enable denying requests to use the feature.</p>
12901301
<p>Also, if a feature is generally not exposed to developers,
12911302
it is not appropriate to support feature detection.
12921303
For example, private browsing mode is a concept
@@ -1302,6 +1313,8 @@ <h3 class="heading settled" data-level="2.5" id="feature-detect"><span class="se
13021313
<p><a href="#do-not-expose-use-of-assistive-tech">§ 2.9 Don’t reveal that assistive technologies are being used</a></p>
13031314
<li data-md>
13041315
<p><a href="#secure-context">§ 2.6 Consider limiting new features to secure contexts</a></p>
1316+
<li data-md>
1317+
<p><a href="#consent">§ 1.4 Ask users for meaningful consent</a></p>
13051318
</ul>
13061319
<h3 class="heading settled" data-level="2.6" id="secure-context"><span class="secno">2.6. </span><span class="content">Consider limiting new features to secure contexts</span><a class="self-link" href="#secure-context"></a></h3>
13071320
<p>Always limit your feature to secure contexts

0 commit comments

Comments
 (0)