Font Library: add font family and font face preview keys to schema (#…

…56793) * Add preview key to theme.json schema * add preview key to php data sanitization schema * update description text Co-authored-by: Jeff Ong <jonger4@gmail.com> * update docs --------- Co-authored-by: Jeff Ong <jonger4@gmail.com>
WordPress · Dec 5, 2023 · 62ecf4a · 62ecf4a · github-actions · Dec 5, 2023
1 parent 0e98444
commit 62ecf4a
Show file tree

Hide file tree

Showing 3 changed files with 11 additions and 1 deletion.
diff --git a/docs/reference-guides/theme-json-reference/theme-json-living.md b/docs/reference-guides/theme-json-reference/theme-json-living.md
@@ -188,7 +188,7 @@ Settings related to typography.
 | textTransform | boolean | true |  |
 | dropCap | boolean | true |  |
 | fontSizes | array |  | fluid, name, size, slug |
-| fontFamilies | array |  | fontFace, fontFamily, name, slug |
+| fontFamilies | array |  | fontFace, fontFamily, name, preview, slug |
 
 ---
 

diff --git a/lib/class-wp-theme-json-gutenberg.php b/lib/class-wp-theme-json-gutenberg.php
@@ -431,6 +431,7 @@ class WP_Theme_JSON_Gutenberg {
 			'fontFamily' => null,
 			'name'       => null,
 			'slug'       => null,
+			'preview'    => null,
 			'fontFace'   => array(
 				array(
 					'ascentOverride'        => null,
@@ -446,6 +447,7 @@ class WP_Theme_JSON_Gutenberg {
 					'sizeAdjust'            => null,
 					'src'                   => null,
 					'unicodeRange'          => null,
+					'preview'               => null,
 				),
 			),
 		),

diff --git a/schemas/json/theme.json b/schemas/json/theme.json
@@ -623,6 +623,10 @@
 										"description": "CSS font-family value.",
 										"type": "string"
 									},
+									"preview": {
+										"description": "URL to a preview image of the font family.",
+										"type": "string"
+									},
 									"fontFace": {
 										"description": "Array of font-face declarations.",
 										"type": "array",
@@ -713,6 +717,10 @@
 												"unicodeRange": {
 													"description": "CSS unicode-range value.",
 													"type": "string"
+												},
+												"preview": {
+													"description": "URL to a preview image of the font face.",
+													"type": "string"
 												}
 											},
 											"required": [ "fontFamily", "src" ],