Можно подключить CSS файл к HTML странице через указание метатега link в блоке head. Но в CMS WordPress есть несколько функций, которые позволяют подключать CSS файлы. При этом подключение происходит через отложенную очередь. А вывод стилей осуществляется при вызове функций
wp_head() или
wp_footer().
Подключение CSS через функции более предпочтителен, потому что даёт возможность использовать различные плагины для обработки CSS кода, к примеру, плагины для минификации кода. Разберём некоторые функции:
wp_register_style - регистрирует CSS файл в WordPress. После чего файл вставляется в документ через функции "wp_head" или "wp_footer" или с помощью функции
wp_enqueue_style.
wp_register_style( $handle, $src, $deps, $ver, $media );
| $handle |
строка |
Идентификатор (уникальное название). К примеру, название подключаемого файла стилей (в нижнем регистре). |
| $src |
строка |
Путь к файлу стилей. Лучше использовать относительные пути (функции "plugins_url()" для плагинов и "get_template_directory_uri()" для тем) |
| $deps |
массив |
Массив из стилей, которые будут подключены до этого стиля. |
| $ver |
строка/логический |
Версия стилей, которая добавляется в конец URL через параметр, к примеру, "style.css?ver=5.2.4. Если не указана, то используется версия WordPress. |
| $media |
строка |
Параметр в media запросе CSS. Принимает значения: all (по умолчанию), screen, handheld, print. |
wp_deregister_style - снимает регистрацию стиля и не даёт ему выводиться.
wp_deregister_style( $handle );
| $handle |
строка |
Идентификатор (уникальное название). К примеру, название подключаемого файла стилей (в нижнем регистре). |
wp_dequeue_style - убирает стиль из вывода, но не удаляет стиль из зарегистрированных.
wp_dequeue_style( $handle );
| $handle |
строка |
Идентификатор (уникальное название). К примеру, название подключаемого файла стилей (в нижнем регистре). |
wp_style_is - показывает был ли файл стилей зарегистрирован, добавлен в очередь на вывод или уже выведен.
wp_style_is( $handle, $list );
| $handle |
строка |
Идентификатор (уникальное название). К примеру, название подключаемого файла стилей (в нижнем регистре). |
| $list |
строка |
Проверяемое условие. Возможные значения:
registered - файл стилей был зарегистрирован, используя wp_register_style().
enqueued или queue - стили были добавлены в очередь.
to_do - стили еще не выведены на экран.
done - стили уже выведены на экран.
|
wp_add_inline_style - добавляет к блоку стилей произвольный CSS код. Код вставляется после вывода зарегистрированного файла стилей.
wp_add_inline_style( $handle, $data );
| $handle |
строка |
Идентификатор (уникальное название). К примеру, название подключаемого файла стилей (в нижнем регистре). |
| $data |
строка |
Чистый CSS код, который будет добавлен. Не нужно обрамлять в тег "style". |
wp_get_custom_css - получает CSS код из настроек в темы. Код будет получен как есть без тега "style". Эта функция автоматически срабатывает при выполнении функции "wp_head".
wp_get_custom_css( $stylesheet = '' );
| $stylesheet |
строка |
Название каталога текущей темы. По умолчанию используется текущая тема. Результат - чисты CSS код, поэтому для вывода в HTML необходимо обрамлять его в тег "style". |
wp_enqueue_style - регистрирует и добавляет в очередь на вывод файл CSS стилей. Функция может быть использована в любом месте документа, а не только в "head" части.
wp_enqueue_style( $handle, $src, $deps, $ver, $media );
| $handle |
строка |
Идентификатор (уникальное название). К примеру, название подключаемого файла стилей (в нижнем регистре). |
| $src |
строка |
Путь к файлу стилей. Лучше использовать относительные пути (функции "plugins_url()" для плагинов и "get_template_directory_uri()" для тем) |
| $deps |
массив |
Массив из стилей, которые будут подключены до этого стиля. |
| $ver |
строка/логический |
Версия стилей, которая добавляется в конец URL через параметр, к примеру, "style.css?ver=5.2.4. Если не указана, то используется версия WordPress. |
| $media |
строка |
Параметр в media запросе CSS. Принимает значения: all (по умолчанию), screen, handheld, print. |
