Skip to content

Commit 9b0625e

Browse files
committed
Port HTML note on zoom/accessibility
Ports the note warning/note recently added to https://w3c.github.io/html/document-metadata.html#the-meta-element about not suppressing/limiting user's ability to zoom, and the note that UAs can ignore these directives anyway
1 parent d1012ee commit 9b0625e

File tree

1 file changed

+19
-1
lines changed

1 file changed

+19
-1
lines changed

css-device-adapt/Overview.bs

Lines changed: 19 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -524,7 +524,9 @@ Computed value: auto, or a non-negative number or percentage as specified
524524
Specifies the largest allowed zoom factor. It is used as input to the
525525
<a href="#constraining-procedure">constraining procedure</a> to constrain
526526
non-''zoom/auto'' 'zoom' values, but also to limit the allowed zoom factor
527-
that can be set through user interaction. The UA should also use this
527+
that can be set through user interaction. Note that the UA may choose to ignore
528+
this limit for accessbility/usability reasons – see the relevant note in
529+
the 'user-zoom' section. The UA should also use this
528530
value as a constraint when choosing an actual zoom factor when the
529531
used value of 'zoom' is ''zoom/auto''.
530532

@@ -578,6 +580,22 @@ Values have the following meanings:
578580
</dd>
579581
</dl>
580582

583+
<div class="note">
584+
Authors should not suppress (with <code>user-zoom: fixed</code>)
585+
or limit (with <code>max-zoom</code>) the ability of users to resize
586+
a document, as this causes accessibility and usability issues.
587+
588+
There may be specific use cases where preventing users from zooming
589+
may be appropriate, such as map applications – where custom zoom
590+
functionality is handled via scripting. However, in general this
591+
practice should be avoided.
592+
593+
Note that most user agents now allow users to always zoom, regardless
594+
of any restrictions specified by web content – either by default, or
595+
as a setting/option (which may however not be immediately apparent
596+
to users).
597+
</div>
598+
581599
<h3 id="orientation-desc">
582600
The 'orientation' descriptor</h3>
583601

0 commit comments

Comments
 (0)