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

Mark normal and reset as non-standard values for zoom property #36732

Open
wants to merge 12 commits into
base: main
Choose a base branch
from

Conversation

FelixTakeOne
Copy link
Contributor

  • Updated the zoom property documentation to clarify that normal and reset are non-standard values.
  • Included relevant references and links to CSS specifications.

Description

Revises the zoom property documentation to indicate that the values normal and reset 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 that normal and reset 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.

- Updated the `zoom` property documentation to clarify that `normal` and `reset` are non-standard values.
- Included relevant references and links to CSS specifications.
@FelixTakeOne FelixTakeOne requested a review from a team as a code owner November 11, 2024 12:53
@FelixTakeOne FelixTakeOne requested review from estelle and removed request for a team November 11, 2024 12:53
@github-actions github-actions bot added Content:CSS Cascading Style Sheets docs size/s [PR only] 6-50 LoC changed labels Nov 11, 2024
Copy link
Contributor

github-actions bot commented Nov 11, 2024

Preview URLs

External URLs (1)

URL: /en-US/docs/Web/CSS/zoom
Title: zoom

(comment last updated: 2024-11-13 04:27:49)

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Copy link
Member

@estelle estelle left a 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.

@@ -59,7 +59,7 @@ zoom: unset;

```plain
zoom =
normal | reset | <number> | <percentage>
normal | reset | <number> | <percentage> /* Non-standard values */
Copy link
Member

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)

Copy link
Contributor Author

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 Show resolved Hide resolved
- `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.
Copy link
Member

@estelle estelle Nov 13, 2024

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.

files/en-us/web/css/zoom/index.md Outdated Show resolved Hide resolved
FelixTakeOne and others added 7 commits November 13, 2024 11:58
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>
FelixTakeOne and others added 3 commits November 13, 2024 12:22
tiny format change

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Content:CSS Cascading Style Sheets docs size/s [PR only] 6-50 LoC changed
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Mark zoom: normal and reset as non-standard
2 participants