-
Notifications
You must be signed in to change notification settings - Fork 22.5k
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
Mark normal
and reset
as non-standard values for zoom
property
#36732
base: main
Are you sure you want to change the base?
Conversation
- Updated the `zoom` property documentation to clarify that `normal` and `reset` are non-standard values. - Included relevant references and links to CSS specifications.
Preview URLs External URLs (1)URL:
(comment last updated: 2024-11-13 04:27:49) |
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Thanks for the suggested updates. I've made several comments on how we can include the legacy / non-standard content in a MDN-standard way.
files/en-us/web/css/zoom/index.md
Outdated
@@ -59,7 +59,7 @@ zoom: unset; | |||
|
|||
```plain | |||
zoom = | |||
normal | reset | <number> | <percentage> | |||
normal | reset | <number> | <percentage> /* Non-standard values */ |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
we can get rid of all the text here, and use the macro:
{{csssyntax}}
this will then include what is included in the spec (and not the non-standard values)
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Thanks for your suggestions, I learn a lot.
files/en-us/web/css/zoom/index.md
Outdated
- `reset` | ||
- : Do not (de)magnify this element if the user applies non-pinch-based zooming (e.g. by pressing <kbd>Ctrl</kbd> \- <kbd>-</kbd> or <kbd>Ctrl</kbd> \+ <kbd>+</kbd> keyboard shortcuts) to the document. **Do not use** this value, _use the standard `unset` value instead_. | ||
- : Do not (de)magnify this element if the user applies non-pinch-based zooming (e.g. by pressing <kbd>Ctrl</kbd> \- <kbd>-</kbd> or <kbd>Ctrl</kbd> \+ <kbd>+</kbd> keyboard shortcuts) to the document. **Non-standard.** Consider using `unset` instead. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Suggest listing the valid values (percent and number) first, then adding a paragraph that reads something to the effect of:
"Non-standard keyword values include reset
and normal
. These values are not recommended. Check browser compatibility data:"
and putting the edited non-standard values after.
update `reset` description Co-authored-by: Estelle Weyl <[email protected]>
update `normal` description Co-authored-by: Estelle Weyl <[email protected]>
update see also Co-authored-by: Estelle Weyl <[email protected]>
apply suggestions on the order of Values and the content of Formal syntax
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Co-authored-by: Estelle Weyl <[email protected]>
tiny format change Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
zoom
property documentation to clarify thatnormal
andreset
are non-standard values.Description
Revises the
zoom
property documentation to indicate that the valuesnormal
andreset
are non-standard and deprecated.Provides clarification on the usage of these values and recommends using
unset
instead.Motivation
To improve the clarity of the
zoom
property's documentation, ensuring that users understand thatnormal
andreset
are non-standard and discouraged for use.Additional details
https://developer.mozilla.org/en-US/docs/Web/CSS/zoom
Related issues and pull requests
Fixes #36720.