# sanitize_html_class()

URL: https://chugunov.pro/api-wordpress/functions/sanitize_html_class/
Проверено на WordPress 6.9, обновлено 06.08.2026.
Источник: независимый русскоязычный справочник chugunov.pro. Не является официальной документацией WordPress.

Тип: функция.
Появился в версии: 2.8.0.

## Сигнатура

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

## Описание

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

## Параметры

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

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

`string`

## Исходный код

Файл: `wp-includes/formatting.php:2437`

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

## Связанные

Использует: [`sanitize_html_class`](https://chugunov.pro/api-wordpress/functions/sanitize_html_class/), [`apply_filters`](https://chugunov.pro/api-wordpress/functions/apply_filters/).
Используется в: `WP_Theme_JSON::remove_insecure_settings`, `WP_Media_List_Table::column_title`, [`_navigation_markup`](https://chugunov.pro/api-wordpress/functions/_navigation_markup/), [`login_header`](https://chugunov.pro/api-wordpress/functions/login_header/), `WP_Screen::add_help_tab`, `WP_Plugin_Install_List_Table::display_rows`, [`iframe_header`](https://chugunov.pro/api-wordpress/functions/iframe_header/), [`attachment_submitbox_metadata`](https://chugunov.pro/api-wordpress/functions/attachment_submitbox_metadata/), [`wp_iframe`](https://chugunov.pro/api-wordpress/functions/wp_iframe/), [`_wp_menu_output`](https://chugunov.pro/api-wordpress/functions/_wp_menu_output/), [`sanitize_html_class`](https://chugunov.pro/api-wordpress/functions/sanitize_html_class/), [`get_body_class`](https://chugunov.pro/api-wordpress/functions/get_body_class/), [`get_post_class`](https://chugunov.pro/api-wordpress/functions/get_post_class/), [`gallery_shortcode`](https://chugunov.pro/api-wordpress/functions/gallery_shortcode/), [`img_caption_shortcode`](https://chugunov.pro/api-wordpress/functions/img_caption_shortcode/), [`get_comment_class`](https://chugunov.pro/api-wordpress/functions/get_comment_class/), `_WP_Editors::editor_settings`.

Оригинал в официальной документации: https://developer.wordpress.org/reference/functions/sanitize_html_class/