WP_Font_Face

15class WP_Font_Face {16 17	/**18	 * The font-face property defaults.19	 *20	 * @since 6.4.021	 *22	 * @var string[]23	 */24	private $font_face_property_defaults = array(25		'font-family'  => '',26		'font-style'   => 'normal',27		'font-weight'  => '400',28		'font-display' => 'fallback',29	);30 31	/**32	 * Valid font-face property names.33	 *34	 * @since 6.4.035	 *36	 * @var string[]37	 */38	private $valid_font_face_properties = array(39		'ascent-override',40		'descent-override',41		'font-display',42		'font-family',43		'font-stretch',44		'font-style',45		'font-weight',46		'font-variant',47		'font-feature-settings',48		'font-variation-settings',49		'line-gap-override',50		'size-adjust',51		'src',52		'unicode-range',53	);54 55	/**56	 * Valid font-display values.57	 *58	 * @since 6.4.059	 *60	 * @var string[]61	 */62	private $valid_font_display = array( 'auto', 'block', 'fallback', 'swap', 'optional' );63 64	/**65	 * Generates and prints the `@font-face` styles for the given fonts.66	 *67	 * @since 6.4.068	 *69	 * @param array[][] $fonts Optional. The font-families and their font variations.70	 *                         See {@see wp_print_font_faces()} for the supported fields.71	 *                         Default empty array.72	 */73	public function generate_and_print( array $fonts ) {74		$fonts = $this->validate_fonts( $fonts );75 76		// Bail out if there are no fonts are given to process.77		if ( empty( $fonts ) ) {78			return;79		}80 81		$css = $this->get_css( $fonts );82 83		/*84		 * The font-face CSS is contained within <style> tags and can only be interpreted85		 * as CSS in the browser. Using wp_strip_all_tags() is sufficient escaping86		 * to avoid malicious attempts to close </style> and open a <script>.87		 */88		$css = wp_strip_all_tags( $css );89 90		// Bail out if there is no CSS to print.91		if ( empty( $css ) ) {92			return;93		}94