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

