Проверка наличия CSS-стиля в очереди с помощью wp_style_is()

# WP_STYLE_IS() │ WP 2.8.0

Функция wp_style_is() проверяет, был ли добавлен CSS-стиль в очередь. Это полезно, чтобы избежать дублирования стилей на вашем сайте.

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

Функция возвращает true или false, в зависимости от того, присутствует ли стиль в очереди.

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

```php
wp_style_is( $handle, $status );

Параметры

• $handle (строка, обязательный) — имя CSS-стиля, который вы проверяете.

• $status (строка, необязательный) — статус стиля для проверки. Может принимать значения:

  • 'enqueued' (в очереди)
  • 'registered' (зарегистрирован)
  • 'queue'
  • 'to_do'
  • 'done'

  По умолчанию используется значение 'enqueued'.

Примеры

Пример 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() {
    // Если стили не подключены, подключаем их
    if ( ! wp_style_is( 'style-name' ) ) {
        wp_enqueue_style( 'style-name', get_stylesheet_uri() );
    }
}

Изменения

Функция была введена в версии 2.8.0.

Реализация функции

Вот как выглядит функция в коде:

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

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

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

Вот некоторые функции, которые вы можете использовать вместе с wp_style_is():

• wp_add_inline_style() — добавляет встроенные стили.
• wp_dequeue_style() — удаляет стиль из очереди.
• wp_deregister_style() — отменяет регистрацию стиля.
• wp_enqueue_style() — добавляет стиль в очередь.

Работа со скриптами и стилями

Кроме стилей, вы также можете работать со скриптами с помощью таких функций:

• wp_enqueue_script() — добавляет скрипт в очередь.
• wp_deregister_script() — отменяет регистрацию скрипта.
• wp_add_inline_script() — добавляет встроенный скрипт.

Эти функции помогут вам управлять стиля и скриптами на вашем веб-сайте WordPress более эффективно.