wp_register_style() WP 2.6.0

Реєструє 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

#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');
}
0

#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');
	}
}

нотатки

список змін

З версії 2.6.0Введено.
З версії 4.3.0A return value був added.

Код 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 );
}

Залишити відповідь

Ваша e-mail адреса не оприлюднюватиметься. Обов’язкові поля позначені *