wp_enqueue_style()

Добавляет в очередь таблицу стилей CSS
Функция WordPress
INT 2.6.0
WordPress Icon
Содержание
  1. Описание функции
  2. Примеры использования
  3. Загрузка стилей из внешнего источника
  4. Добавление зависимостей для стилей
  5. Установка версии стилей
  6. Определение медиа-запросов для стилей
  7. Вопросы и ответы
  8. Как добавить стиль в WordPress с помощью функции wp_enqueue_style()?
  9. Как задать уникальное имя для подключаемого стиля в WordPress?
  10. Как указать путь к файлу стиля относительно корневой директории WordPress?
  11. Как указать зависимости для подключаемого стиля в WordPress?
  12. Как добавить версию стиля для обновления кэша в WordPress?
  13. Как указать медиа-запрос для подключаемого стиля в WordPress?
  14. Какие значения принимает параметр $media в функции wp_enqueue_style()?
  15. Какие другие функции могут быть полезны при работе со стилями в WordPress?
  16. Связанные элементы

Описание функции

Функция wp_enqueue_style() используется для добавления CSS стилей на веб-страницу в WordPress. Она регистрирует стиль и добавляет его в очередь для загрузки. После этого стиль будет автоматически подключен к странице, когда она будет отображаться.

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

wp_enqueue_style( string $handle, string $src = '', string[] $deps = array(), string|bool|null $ver = false, string $media = 'all' )

Функция wp_enqueue_style() принимает следующие параметры:

  • $handle (обязательный) — Название стиля. Должно быть уникальным.
  • $src (необязательный) — Полный URL стиля или путь к стилю относительно корневой директории WordPress. По умолчанию: пустая строка.
  • $deps (необязательный) — Массив зарегистрированных стилей, от которых зависит данный стиль. По умолчанию: пустой массив.
  • $ver (необязательный) — Строка, указывающая номер версии стиля, если он имеет таковой. Этот номер версии добавляется в URL в виде строки запроса для целей обновления кэша. Если версия установлена в false, автоматически добавляется номер версии, равный текущей установленной версии WordPress. Если установлено значение null, номер версии не добавляется. По умолчанию: false.
  • $media (необязательный) — Медиа, для которой определен данный стиль. По умолчанию: ‘all’. Принимает типы медиа, такие как ‘all’, ‘print’ и ‘screen’, или медиа-запросы, такие как ‘(orientation: portrait)’ и ‘(max-width: 640px)’.

/**
 * Регистрация и подключение стиля
 */
function my_theme_enqueue_style() {
    // Регистрация стиля
    wp_enqueue_style( 'my-theme-style', get_stylesheet_uri(), array(), '1.0', 'all' );
}
add_action( 'wp_enqueue_scripts', 'my_theme_enqueue_style' );

В этом примере мы создаем функцию my_theme_enqueue_style(), которая регистрирует и подключает стиль с именем ‘my-theme-style’. Мы используем функцию get_stylesheet_uri(), чтобы получить URL текущего активного стиля в теме. Мы также передаем пустой массив в качестве зависимостей, версию стиля ‘1.0’ и медиа-запрос ‘all’. Затем мы добавляем действие wp_enqueue_scripts, чтобы функция была вызвана на странице.

Примеры использования

Загрузка стилей из внешнего источника


/**
 * Загрузка стиля из внешнего источника.
 */
wp_enqueue_style( 'my-style', 'https://example.com/style.css' );

В этом примере мы используем функцию wp_enqueue_style() для загрузки стиля с именем «my-style» из внешнего источника по URL «https://example.com/style.css». Это позволяет нам добавить стиль на нашу WordPress-страницу.

Добавление зависимостей для стилей


/**
 * Загрузка стиля с зависимостями.
 */
wp_enqueue_style( 'my-style', 'https://example.com/style.css', array( 'parent-style' ) );

В этом примере мы используем функцию wp_enqueue_style() для загрузки стиля с именем «my-style» из внешнего источника по URL «https://example.com/style.css». Мы также указываем, что этот стиль зависит от стиля с именем «parent-style». Это гарантирует, что стиль «parent-style» будет загружен перед стилем «my-style».

Установка версии стилей


/**
 * Загрузка стиля с версией.
 */
wp_enqueue_style( 'my-style', 'https://example.com/style.css', array(), '1.0' );

В этом примере мы используем функцию wp_enqueue_style() для загрузки стиля с именем «my-style» из внешнего источника по URL «https://example.com/style.css». Мы также указываем версию стиля как «1.0». Это добавляет версию в URL стиля в виде строки запроса, что позволяет обновлять кэш стиля при изменении версии.

Определение медиа-запросов для стилей


/**
 * Загрузка стиля с медиа-запросами.
 */
wp_enqueue_style( 'my-style', 'https://example.com/style.css', array(), '1.0', 'screen and (max-width: 600px)' );

В этом примере мы используем функцию wp_enqueue_style() для загрузки стиля с именем «my-style» из внешнего источника по URL «https://example.com/style.css». Мы также указываем, что этот стиль применяется только для устройств с шириной экрана не более 600 пикселей. Это позволяет нам создавать адаптивные стили, которые будут применяться только на определенных устройствах.

Вопросы и ответы

Как добавить стиль в WordPress с помощью функции wp_enqueue_style()?

Для добавления стиля в WordPress используется функция wp_enqueue_style(). Она позволяет подключить CSS-файл к текущей теме или плагину.

wp_enqueue_style( $handle, $src, $deps, $ver, $media );

Как задать уникальное имя для подключаемого стиля в WordPress?

Параметр $handle функции wp_enqueue_style() используется для задания уникального имени стиля. Он должен быть строкой и быть уникальным для каждого стиля.

$handle = 'my-style';

Как указать путь к файлу стиля относительно корневой директории WordPress?

Параметр $src функции wp_enqueue_style() позволяет указать путь к файлу стиля относительно корневой директории WordPress. Если файл находится в корневой директории, то параметр может быть пустым.

$src = get_template_directory_uri() . '/css/style.css';

Как указать зависимости для подключаемого стиля в WordPress?

Параметр $deps функции wp_enqueue_style() позволяет указать зависимости для подключаемого стиля. Зависимости — это массив имен уже зарегистрированных стилей, от которых зависит текущий стиль.

$deps = array( 'parent-style' );

Как добавить версию стиля для обновления кэша в WordPress?

Для добавления версии стиля и обновления кэша в WordPress используется параметр $ver в функции wp_enqueue_style(). Этот параметр принимает строку, которая указывает номер версии стиля. Если номер версии не указан, WordPress автоматически добавит текущую установленную версию WordPress.

Пример кода:


wp_enqueue_style( 'style', get_stylesheet_uri(), array(), '1.0' );

Как указать медиа-запрос для подключаемого стиля в WordPress?

Для указания медиа-запроса для подключаемого стиля в WordPress используется параметр $media в функции wp_enqueue_style(). Этот параметр принимает строку, которая определяет тип медиа, для которого был определен стиль.

Пример кода:


wp_enqueue_style( 'style', get_stylesheet_uri(), array(), '1.0', 'screen' );

Какие значения принимает параметр $media в функции wp_enqueue_style()?

Параметр $media в функции wp_enqueue_style() принимает следующие значения:

  • all: применяется для всех типов медиа.
  • print: применяется для печати.
  • screen: применяется для экрана.
  • speech: применяется для голосовых синтезаторов.
  • aural: применяется для аудио-вывода.

Какие другие функции могут быть полезны при работе со стилями в WordPress?

При работе со стилями в WordPress помимо функции wp_enqueue_style() могут быть полезны следующие функции:

  • wp_register_style(): регистрирует стиль, чтобы он мог быть подключен позже.
  • wp_deregister_style(): отменяет регистрацию стиля.
  • wp_dequeue_style(): удаляет стиль из очереди на подключение.
  • wp_style_is(): проверяет, зарегистрирован ли указанный стиль.

Функция wp_enqueue_style() в WordPress используется для подключения CSS-стилей. Она позволяет указать путь к стилю, зависимости от других стилей, версию стиля для обновления кэша и медиа-запрос для определенного типа медиа. При работе со стилями также могут быть полезны другие функции, такие как wp_register_style(), wp_deregister_style(), wp_dequeue_style() и wp_style_is().

Связанные элементы

  • Функция wp_register_style(): Регистрирует новый стиль для последующей загрузки.
  • Функция wp_deregister_style(): Отменяет регистрацию стиля, ранее зарегистрированного с помощью wp_register_style().
  • Функция wp_style_is(): Проверяет, зарегистрирован ли указанный стиль.
  • Функция wp_dequeue_style(): Отменяет загрузку указанного стиля.
  • Хук wp_enqueue_scripts: Срабатывает при загрузке стилей и скриптов на фронтенде.
  • Хук style_loader_src: Позволяет изменить путь к файлу стиля перед его загрузкой.
  • Класс WP_Styles: Отвечает за управление стилями в WordPress, включая их регистрацию и загрузку.
Стили и CSS
Обсуждение

Этот сайт использует cookie для хранения данных. Продолжая использовать сайт, Вы принимаете условия пользовательского соглашения и даете свое согласие на использование cookie.