-
Notifications
You must be signed in to change notification settings - Fork 4.2k
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
Docs: Table of styles keys with since versions #48265
Docs: Table of styles keys with since versions #48265
Conversation
Flaky tests detected in 93b48ca. 🔍 Workflow run URL: https://github.com/WordPress/gutenberg/actions/runs/4326947518
|
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.
I haven't checked to see if every setting is here , but I did notice that spacing.spacingScale
and spacing.spacingSizes
were missing. And, color.duotone
. Note sure if you're aiming for complete coverage of all possible settings.
Aren't the items you mentioned in settings? The table is only covering styles as the issue is about mapping style controls to The styles editor UI and not about supports or presets(there are a few presets that do have a UI, though, which should be addressed somewhere along the way.) |
Yes, it wasn't clear to me what was going on. Since these are styles, I think it'd be beneficial to put that in the intro that these keys can apply to the root, blocks, or elements under the Otherwise, it looks good to me. |
I think this PR is ready for a round of approval reviews. I would love to get this pushed live within the next week, so any suggestions to improve on this would be great. |
What?
This PR is a first pass at expanding theme.json documentation with more granular information. Starting with a table of theme.json styles keys and the versions implemented in theme.json and the styles editor, respectively.
I'm not sure this is the best long-term approach to display this information, but working within the confines of what can be accomplished on the DevHub site.
Fixes #44340
ToDo
styles.
to the beginning of each key for the sake of being completeWhy?
It can be difficult to know exactly what options are available in theme.json and, from those, which have a user interface implementation that can be used from the styles editor panel.
This table will ideally also exist on the Theme Developer Handbook, covering only options that have been already made available in Core.
I've created this as a new page since the theme.json How-To page has become extremely long.
How?
This table is a first attempt at making this information available in an easy-to-scan format. This is PR is not ready to publish but is being submitted for feedback about the overall format of the table..
Testing Instructions
Confirm that the list of styles keys is complete and accurate and the Since columns contain accurate versions for WP Core inclusion or N/A if not yet available.