WP_Font_Utils::sanitize_font_family │ public static │ WP 6.5.0

Sanitizes and formats font family names.

  • 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.

Метод класса: WP_Font_Utils{}

Внутренняя функция — эта функция рассчитана на использование самим ядром. Не рекомендуется использовать эту функцию в своем коде.

Хуков нет.

Возвращает

Строку. Sanitized and formatted font family name(s).

Использование

$result = WP_Font_Utils::sanitize_font_family( $font_family );
$font_family(строка) (обязательный)
Font family name(s), comma-separated.

Заметки

Список изменений

С версии 6.5.0 Введена.

Код WP_Font_Utils::sanitize_font_family() WP 7.0

wp-includes/fonts/class-wp-font-utils.php 
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 );
}