# sanitize_hex_color()

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

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

## Сигнатура

```php
sanitize_hex_color( string $color ): string|void
```

## Описание

Возвращает либо '', либо трёх- или шестизначный шестнадцатеричный цвет (с #), либо ничего.
Для очистки значений без # см. sanitize_hex_color_no_hash() .

## Параметры

- `$color` `string` — обязательный

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

`string|void`

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

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

```php
function sanitize_hex_color( $color ) {
	if ( '' === $color ) {
		return '';
	}

	// 3 or 6 hex digits, or the empty string.
	if ( preg_match( '|^#([A-Fa-f0-9]{3}){1,2}$|', $color ) ) {
		return $color;
	}
}
```

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

- 3.4.0 — Introduced.

## Связанные

Используется в: [`rest_sanitize_value_from_schema`](https://chugunov.pro/api-wordpress/functions/rest_sanitize_value_from_schema/), [`sanitize_hex_color_no_hash`](https://chugunov.pro/api-wordpress/functions/sanitize_hex_color_no_hash/), [`sanitize_hex_color`](https://chugunov.pro/api-wordpress/functions/sanitize_hex_color/).

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