Sanitizes and formats font family names.

Description

• Applies sanitize_text_field.
• Adds surrounding quotes to names containing any characters that are not alphabetic or dashes.

It follows the recommendations from the CSS Fonts Module Level 4.

See also

• sanitize_text_field()

Parameters

$font_familystringrequired

Font family name(s), comma-separated.

Return

Source

public static function sanitize_font_family( $font_family ) {
	if ( ! $font_family ) {
		return '';
	}

	$output          = sanitize_text_field( $font_family );
	$formatted_items = array();
	if ( str_contains( $output, ',' ) ) {
		$items = explode( ',', $output );
		foreach ( $items as $item ) {
			$formatted_item = self::maybe_add_quotes( $item );
			if ( ! empty( $formatted_item ) ) {
				$formatted_items[] = $formatted_item;
			}
		}
		return implode( ', ', $formatted_items );
	}
	return self::maybe_add_quotes( $output );
}

View all references View on Trac View on GitHub

Changelog