WP_Font_Utils

20class WP_Font_Utils {21	/**22	 * Adds surrounding quotes to font family names that contain special characters.23	 *24	 * It follows the recommendations from the CSS Fonts Module Level 4.25	 * @link https://www.w3.org/TR/css-fonts-4/#font-family-prop26	 *27	 * @since 6.5.028	 *29	 * @param string $item A font family name.30	 * @return string The font family name with surrounding quotes, if necessary.31	 */32	private static function maybe_add_quotes( $item ) {33		// Matches strings that are not exclusively alphabetic characters or hyphens, and do not exactly follow the pattern generic(alphabetic characters or hyphens).34		$regex = '/^(?!generic\([a-zA-Z\-]+\)$)(?!^[a-zA-Z\-]+$).+/';35		$item  = trim( $item );36		if ( preg_match( $regex, $item ) ) {37			$item = trim( $item, "\"'" );38			return '"' . $item . '"';39		}40		return $item;41	}42 43	/**44	 * Sanitizes and formats font family names.45	 *46	 * - Applies `sanitize_text_field`.47	 * - Adds surrounding quotes to names containing any characters that are not alphabetic or dashes.48	 *49	 * It follows the recommendations from the CSS Fonts Module Level 4.50	 * @link https://www.w3.org/TR/css-fonts-4/#font-family-prop51	 *52	 * @since 6.5.053	 * @access private54	 *55	 * @see sanitize_text_field()56	 *57	 * @param string $font_family Font family name(s), comma-separated.58	 * @return string Sanitized and formatted font family name(s).59	 */60	public static function sanitize_font_family( $font_family ) {61		if ( ! $font_family ) {62			return '';63		}64 65		$output          = sanitize_text_field( $font_family );66		$formatted_items = array();67		if ( str_contains( $output, ',' ) ) {68			$items = explode( ',', $output );69			foreach ( $items as $item ) {70				$formatted_item = self::maybe_add_quotes( $item );71				if ( ! empty( $formatted_item ) ) {72					$formatted_items[] = $formatted_item;73				}74			}75			return implode( ', ', $formatted_items );76		}77		return self::maybe_add_quotes( $output );78	}79 80	/**81	 * Generates a slug from font face properties, e.g. `open sans;normal;400;100%;U+0-10FFFF`82	 *83	 * Used for comparison with other font faces in the same family, to prevent duplicates84	 * that would both match according the CSS font matching spec. Uses only simple case-insensitive85	 * matching for fontFamily and unicodeRange, so does not handle overlapping font-family lists or86	 * unicode ranges.87	 *88	 * @since 6.5.089	 * @access private90	 *91	 * @link https://drafts.csswg.org/css-fonts/#font-style-matching92	 *93	 * @param array $settings {94	 *     Font face settings.95	 *96	 *     @type string $fontFamily   Font family name.97	 *     @type string $fontStyle    Optional font style, defaults to 'normal'.98	 *     @type string $fontWeight   Optional font weight, defaults to 400.99	 *     @type string $fontStretch  Optional font stretch, defaults to '100%'.