Главная страница » Функции WordPress » wp_enqueue_style()

wp_enqueue_style()

Описание

Регистрирует файл стилей, если он еще не был зарегистрирован и подключает его в головной части.

Если вызвать wp_enqueue_style() непосредственно в документе, то файл стилей будет подключен в нижней части перед закрывающим тегом body.

Если файл стилей уже был зарегистрирован через wp_register_style(), для его подключения, в функцию wp_enqueue_style() достаточно передать идентификатор этого стилевого файла.

Чтобы подключить стили в свою или дочернюю темы wordpress, используйте файл functions.php

При помощи хуков, в зависимости где нужно использовать стили :

  • wp_enqueue_scripts - если скрипт нужно подключить для внешней части сайта
  • admin_enqueue_scripts - если скрипт нужно подключить для админки
  • login_enqueue_scripts - если скрипт нужно подключить для страницы входа

добавьте свою функцию, в которой уже осуществляйте подключение стилей и скриптов.


add_action( ‘wp_enqueue_scripts’, ‘enqueue_my_styles’ );

function enqueue_my_styles() {
 
    wp_enqueue_style( ‘style-custom’ , get_template_directory_uri() . ‘css/custom.css’ ) ;

}

Сигнатура

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

Параметры

$handle

(string) (Required) Идентификатор подключаемого стилевого файла. Должен быть уникален.

$src

(string) (Optional) Полный URL-адрес к подключаемому файлу или путь относительно корневого каталога WordPress. URL не следует указывать жестко в явном виде. Для этого используйте следующие функции:
Для плагинов - plugins_url()
Для тем - get_template_directory_uri()
Для дочерних тем - get_stylesheet_directory_uri()

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

$deps

(array) (Optional) Массив зарегистрированных идентификаторов стилевых файлов, которые будут подключены выше в документе.

По умолчанию: array()

$ver

(string|bool|null) (Optional) Строка с указанием номера версии таблицы стилей. Добавляется к URL в качестве параметра с целью избежать использования закешированного результата. Если для версии установлено значение false, номер версии автоматически добавляется как текущая версия WordPress. Если установлено значение null - версия не добавляется.

По умолчанию: false

$media

(string) (Optional) Устанавливает @media правила, позволяя подключить файл только для определённых типов устройств и разрешений экранов. Любое ограничение, которое поддерживают @media-запросы.
Например:
'screen (orientation: portrait) and (max-width: 640px)'

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

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

Ничего не возвращает.

Журнал изменений

2.6.0

Исходный файл

wp-includes/functions.wp-styles.php

Читайте также

Добавить комментарий