WordPress как на ладони
wordpress jino

sanitize_html_class() WP 2.8

Подготавливает текст для использования его в html атрибуте class: удаляет все неподходящие символы.

Функция удаляет все октеты и все символы не входящие в значения: A-Z, a-z, 0-9, _, -.
Если в результате получится пустая строка, то функция вернет альтернативный класс, указанный во втором параметре $fallback.

Перед возвращением данных результат прогоняется через фильтр sanitize_html_class.

Обратите внимание, что функция обрабатывает только один класс. Т.е. если передать сразу 2 класса так: foo bar, пробел будет удален и получим: foobar.

✈ 1 раз = 0.000024с = очень быстро | 50000 раз = 0.08с = скорость света PHP 7.1.2, WP 4.7.3
Хуки из функции:
Возвращает

Очищенную строку.

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

$sanitized = sanitize_html_class( $class, $fallback );
$class(строка) (обязательный)
Строка (название класса) которую нужно очистить.
$fallback(строка)
Значение, которое нужно вернуть, если оригинальное значение после очистки окажется пустой строкой.
По умолчанию: ''

Примеры

#1 Демонстрация работы функции

$text = 'Пробный текст';
$text = sanitize_html_class( $text );
// Вернет: пустую строку

$text = 'Some text';
$text = sanitize_html_class( $text );
// Вернет: Sometext

$text = 'my-class';
$text = sanitize_html_class( $text );
// Вернет: my-class

$text = 'Пример на английском - Example';
$text = sanitize_html_class( $text );
// Вернет: -Example

Код sanitize html class: wp-includes/formatting.php VER 4.9.1

<?php
function sanitize_html_class( $class, $fallback = '' ) {
	//Strip out any % encoded octets
	$sanitized = preg_replace( '|%[a-fA-F0-9][a-fA-F0-9]|', '', $class );

	//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 $class     HTML class before sanitization.
	 * @param string $fallback  The fallback string.
	 */
	return apply_filters( 'sanitize_html_class', $sanitized, $class, $fallback );
}

Cвязанные функции

Из метки: sanitize_ (очистка)

Еще из раздела: Очистка данных

sanitize_html_class Комментариев нет

    Здравствуйте, !

    Ваш комментарий
    Предпросмотр