функция since 2.8.0

sanitize_html_class()

Проверено на WordPress 6.9, обновлено Источник: WordPress Developer Resources.

Сигнатура

sanitize_html_class( string $classname, string $fallback = '' ): string

Описание

Сокращает строку до символов A-Z, a-z, 0-9, _, -. Если в результате получается пустая строка, возвращается переданное альтернативное значение.

Оригинал (английский)

Strips the string down to A-Z,a-z,0-9,_,-. If this results in an empty string then it will return the alternative value supplied.

Параметры

$classname string обязательный
Имя класса, которое нужно очистить.
$fallback string необязательный = ''
Значение, возвращаемое если после очистки получается пустая строка.

Возвращаемое значение

string

Исходный код

wp-includes/formatting.php:2437

function sanitize_html_class( $classname, $fallback = '' ) {
	// Strip out any percent-encoded characters.
	$sanitized = preg_replace( '|%[a-fA-F0-9][a-fA-F0-9]|', '', $classname );

	// Limit to A-Z, a-z, 0-9, '_', '-'.
	$sanitized = preg_replace( '/[^A-Za-z0-9_-]/', '', $sanitized );

	if ( '' === $sanitized && $fallback ) {
		return sanitize_html_class( $fallback );
	}
	/**
	 * Filters a sanitized HTML class string.
	 *
	 * @since 2.8.0
	 *
	 * @param string $sanitized The sanitized HTML class.
	 * @param string $classname HTML class before sanitization.
	 * @param string $fallback  The fallback string.
	 */
	return apply_filters( 'sanitize_html_class', $sanitized, $classname, $fallback );
}

История изменений

ВерсияОписание
2.8.0 Introduced.

Что будем искать? Например,Продвижение

Этот сайт использует куки-файлы. Оставаясь на сайте, Вы соглашаетесь на их использование. Для получения дополнительной информации, пожалуйста, ознакомьтесь с политикой в отношении персональных данных.