Open bph opened 1 month ago
Heads up @WordPress/docs-issues-coordinators, we have a new issue open. Time to use 'em labels.
Heads up @kafleg @carolinan @TeBenachi - the "themes" label was applied to this issue.
@bph - The URL you referenced is to the Block Editor handbook. Should we open a Gutenberg ticket for it? https://github.com/WordPress/gutenberg/issues
The Theme Handbook has a dedicated page for how to reference presets here: https://developer.wordpress.org/themes/global-settings-and-styles/styles/using-presets/
Issue Description
I see in various theme.json files two different notations to reference presets:
"box-shadow": var:preset|shadow|natural)
"box-shadow": var(--wp--preset--shadow--natural)
URL of the Page with the Issue
Global Settings & Styles (theme.json)>Block Styles > Referencing a style
Why is this a problem?
theme.json syntax is confusing as it is. It'll help if all forms of syntax at least have a mention so it's clear it's official syntax.
Suggested Fix
Add a mention of the syntax. Analog to the existing example.
As for the Why this syntax?
not sure if the Why is actually necessary to mention
A caveat (worth mentioning)