wp_style_is()WP 2.8.0

Определяет был ли файл стилей зарегистрирован / добавлен в очередь на вывод / выведен на экран.

wp_script_is() — Такая же проверка для файла скриптов.

Хуков нет.

Возвращает

true|false.

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

wp_style_is( $handle, $list );
$handle(строка) (обязательный)
Название файла стилей, который нужно проверить. Строка в нижнем регистре.
$list(строка)

Какое условие проверять. Может быть:

  • registered — файл стилей был зарегистрирован, используя wp_register_style().
  • enqueued или queue — стили были добавлены в очередь.
  • done — стили были выведены на экран.
  • to_do — стили еще не были выведены на экран.

По умолчанию: 'enqueued'

Примеры

0

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

Предположим мы добавили в очередь на вывод файл стилей темы, предварительно зарегистрировав его:

// подключим стили темы
add_action( 'wp_enqueue_scripts', 'theme_name_scripts' );
function theme_name_scripts() {
	wp_enqueue_style( 'style-name', get_stylesheet_uri() );
}

Теперь, сделаем тоже самое, только с предварительной проверкой не добавлен ли уже файл в очередь, если добавлен ничего не делаем:

add_action( 'wp_enqueue_scripts', 'theme_name_scripts' );

function theme_name_scripts() {

	// styles are not connected, let's connect them
	if( ! wp_style_is( 'style-name' ) ){
		wp_enqueue_style( 'style-name', get_stylesheet_uri() );
	}
}

Список изменений

С версии 2.8.0 Введена.

Код wp_style_is() WP 6.5.2

function wp_style_is( $handle, $status = 'enqueued' ) {
	_wp_scripts_maybe_doing_it_wrong( __FUNCTION__, $handle );

	return (bool) wp_styles()->query( $handle, $status );
}