[wp-trac] [WordPress Trac] #58614: Add a description key to theme.json style variations

[WordPress Trac]

#58614: Add a description key to theme.json style variations
---------------------------------------+---------------------
 Reporter:  ramonopoly                 |       Owner:  (none)
     Type:  enhancement                |      Status:  new
 Priority:  normal                     |   Milestone:  6.3
Component:  Editor                     |     Version:  trunk
 Severity:  normal                     |  Resolution:
 Keywords:  has-patch gutenberg-merge  |     Focuses:
---------------------------------------+---------------------
Description changed by ramonopoly:

Old description:

> Add `description` to `VALID_TOP_LEVEL_KEYS` in `class-wp-theme-json.php`
> to allow for accessibility improvements.
>
> See Gutenberg plugin PR:
> https://github.com/WordPress/gutenberg/pull/45242
>
> The description is added to the aria label of the style variation
> container.
>
> If the style variation has no description, only the title is used.
>
> Style variations are mostly visual, and there needs to be a text
> alternative that describes them.
>
> One purpose is to use the text description to improve the style variation
> preview in the WordPress.org theme directory.
>
> props @carolinan

New description:

 Add `description` to `VALID_TOP_LEVEL_KEYS` in `class-wp-theme-json.php`
 to allow for accessibility improvements.

 See Gutenberg plugin PR: https://github.com/WordPress/gutenberg/pull/45242

 The description is added to the aria label of the style variation
 container.

 If the style variation has no description, only the title is used.

 Style variations are mostly visual, and there needs to be a text
 alternative that describes them.

 One purpose is to use the text description to improve the style variation
 preview in the WordPress.org theme directory.

 props @poena

--

-- 
Ticket URL: <https://core.trac.wordpress.org/ticket/58614#comment:1>
WordPress Trac <https://core.trac.wordpress.org/>
WordPress publishing platform