wp_register_style()
Реєструє CSS файл у WordPress. Після реєстрації файл можна додати до html документа за допомогою функції wp_enqueue_style() .
Потрібно використовувати цю функцію, щоб правильно підключити файли CSS в WordPress. Для скриптів такою функцією є wp_register_script() .
Ця функція лише реєструє файл, щоб він був підключений та виведений, його потрібно додати до черги за допомогою wp_enqueue_style() . Файл буде додано до <head> частини документа.
Підключати файли так, а не безпосередньо у коді, вигідно для подальшої оптимізації. Якщо всі файли підключені через систему реєстрації WP, то можна використовувати плагіни, щоб об’єднати всі стилі в один і віддавати їх у стислому вигляді, на льоту.
Щоб викликати цю функцію, використовуйте події: wp_enqueue_scripts
та/або admin_enqueue_scripts
. Виклик функції за межами цієї події може спричинити помилки.
Список усіх зареєстрованих стилів за промовчанням у WordPress дивіться у коді функції wp_default_styles()
Хуків немає.
Повертає
true|false
. 3 вертає true/false. До цього нічого не повертала.
Використання
wp_register_style($handle, $src, $deps, $ver, $media);
-
$handle
(рядок) (обов’язковий) - Назва файлу стилів, що підключається (літери в нижньому регістрі). Має бути унікальним, оскільки він буде використаний як ідентифікатор у системі.
-
$src
(рядок) (обов’язковий) УРЛ до файлу стилів. Наприклад, http://example.com/css/style.css . Не потрібно вказувати шлях жорстко, використовуйте функції: get_template_directory_uri() (для тем).
Зовнішні домени можна вказувати з неявним протоколом //notmyexample.com/css/style.css .
-
$deps
(масив) -
Масив ідентифікаторів інших стилів, від яких залежить файл стилів, що підключається. Вказані тут стилі будуть підключені до поточного.
За замовчуванням: array() -
$ver
(рядок/логічний) -
Рядок визначає версію стилів. Версія буде додана до кінця посилання на файл:
?ver=3.5.1
. Якщо не вказати (встановлено false), буде використано версію WordPress. Якщо встановити null, то жодної версії не буде встановлено.
Типово: false -
$media
(рядок) Встановлюється значення атрибута media. media вказує тип пристрою, для якого буде працювати поточний стиль. Може бути:
all
screen
handheld
print
Повний список дивіться тут .
За замовчуванням: ‘all’
Приклади
#1 Під час написання плагіна (за межами PHP класу)
// реєструємо стилі add_action( 'wp_enqueue_scripts', 'register_plugin_styles' ); // реєструємо файл стилів і додаємо його в чергу function register_plugin_styles() { wp_register_style( 'my-plugin', plugins_url( 'my-plugin/css/plugin.css' ) ); wp_enqueue_style( 'my-plugin'); }
#2 При написанні плагіна (всередині PHP класу)
class my_plugin { function __construct() { // реєструємо стилі add_action( 'wp_enqueue_scripts', array( $this, 'register_plugin_styles' ) ); } // реєструємо файл стилів і додаємо його в чергу public function register_plugin_styles() { wp_register_style( 'my-plugin', plugins_url( 'my-plugin/css/plugin.css' ) ); wp_enqueue_style( 'my-plugin'); } }
нотатки
- Дивіться: WP_Dependencies::add()
список змін
З версії 2.6.0 | Введено. |
З версії 4.3.0 | A return value був added. |
Код wp_register_style() wp register style WP 6.0.2
function wp_register_style( $handle, $src, $deps = array(), $ver = false, $media = 'all' ) { _wp_scripts_maybe_doing_it_wrong( __FUNCTION__, $handle ); return wp_styles()->add( $handle, $src, $deps, $ver, $media ); }