Описание функции wp_enqueue_style()
Функция wp_enqueue_style() добавляет CSS-стили в очередь для загрузки на сайте WordPress. Это позволяет правильно управлять зависимостями стилей и предотвращает дублирование кода. Функция часто используется при разработке тем и плагинов для подключения внешних и внутренних стилей.
Функция должна вызываться в хуке ‘wp_enqueue_scripts’ для корректной работы.
Параметры
$handle
Тип: string
Обязательный: Да
Описание: Уникальное имя для стиля, которое будет использоваться для идентификации
Возможные значения:
$src
Тип: string
Обязательный: Да
Описание: URL к файлу CSS
Возможные значения:
$deps
Тип: array
Обязательный: Нет
По умолчанию: array()
Описание: Массив хендлов зависимых стилей
Возможные значения:
$ver
Тип: string|bool
Обязательный: Нет
По умолчанию: false
Описание: Версия стиля для кэширования
Возможные значения:
$media
Тип: string
Обязательный: Нет
По умолчанию: ‘all’
Описание: Тип медиа для стиля (например, ‘all’, ‘screen’, ‘print’)
Возможные значения:
0: all
1: screen
2: print
3: speech
Возвращаемое значение
Тип: void
Описание: Функция ничего не возвращает
Возможные значения:
• Нет значений, так как функция предназначена для регистрации стилей
Примеры использования
Простой пример подключения CSS-файла в теме
function my_theme_enqueue_styles() {
wp_enqueue_style('my-style', get_template_directory_uri() . '/css/style.css');
}
add_action('wp_enqueue_scripts', 'my_theme_enqueue_styles');
Стиль будет загружен на всех страницах
Подключение стиля с зависимостью от Bootstrap
function my_theme_enqueue_styles() {
wp_enqueue_style('bootstrap', 'https://stackpath.bootstrapcdn.com/bootstrap/4.3.1/css/bootstrap.min.css');
wp_enqueue_style('my-style', get_template_directory_uri() . '/css/style.css', array('bootstrap'));
}
add_action('wp_enqueue_scripts', 'my_theme_enqueue_styles');
my-style будет загружен после bootstrap
Безопасность
Валидация входных данных: Параметры проверяются на корректность внутри функции
Санитизация: URL и другие параметры автоматически очищаются WordPress
Рекомендации: Всегда используйте правильные URL для стилей, проверяйте их существование перед использованием
— Связанные функции
Добавляет JavaScript-файлы в очередь для загрузки
Удаляет стиль из очереди загрузки
— Примечания
– Ограничения
Необходимо использовать в соответствующих хуках, иначе стиль не будет загружен
– Частые проблемы
- Стиль не загружается, если функция не привязана к wp_enqueue_scripts
- Ошибки в URL могут привести к отсутствию стиля на странице
