wp_style_add_data() WP 3.6.0

Додає дані для файлів стилів, що підключаються за допомогою wp_enqueue_style() . Використовуйте, коли, наприклад, потрібно підключити стилі тільки для IE.

Працює лише якщо стилі вже знаходяться в черзі на виведення на сторінці за допомогою wp_enqueue_style() .

Аналогічна функція, тільки для скриптів, що підключаються: wp_script_add_data()

Працює на основі:
wp_styles()

Хуків немає.

Повертає

true|false. True при успішному виконанні, false при помилці.

Використання

wp_style_add_data($handle, $key, $value);
$handle
(рядок) (обов’язковий)
Назва файлу стилів, що підключається. Вказується параметром
$handle wp_enqueue_style
() .
$key
(рядок) (обов’язковий)

Назва типу даних, до яких буде додано значення.
Може бути:

  • conditional– Рядок. Умовні коментарі, наприклад підключення стилів тільки для IE 6, більш ніж або рано IE 7 (gte) і т.д.

    Приклади значень параметра $valueпри параметрі $key = conditional :

    • IE– тільки для IE (будь-якої версії)
    • IE 6– тільки для IE 6
    • IE 7– Тільки для IE 7
    • IE 8– Тільки для IE 8
    • IE 9– Тільки для IE 9
    • gt IE 6– тільки для IE більше 6
    • lt IE 9– тільки для IE менше 9
    • gte IE 7– тільки для IE більше або дорівнює 7
    • lte IE 7– тільки для IE менше або дорівнює 7
    • !IE– для всіх браузерів крім IE Працює лише до IE9 включно, подальші версії IE не підтримують умовних коментарів .
  • alt– Логічний. Для rel=”alternate stylesheet” .
  • title– Рядок. Для кращих/альтернативних стилів.
  • rtl(Right-to-Left) – Логічний / Рядок. Для оголошення RTL стилів. Для арабської писемності…
  • suffix– Рядок. Суфікс для умови RTL.
$value
(змішаний) (обов’язковий)
Рядок містить дані, які потрібно додати.

Приклади

0

#1 Додамо умови підключення файлу стилів

Цей приклад взятий із теми Twenty Fifteen.

Використовується для завантаження файлу стилів лише для IE8 та нижче. IE10 та вище у звичайному режимі не підтримують умовні коментарі.

add_action( 'wp_enqueue_scripts', 'wpdocs_enqueue_scripts' );
function wpdocs_enqueue_scripts() {
	// Підключаємо спеціальні стилі для Internet Explorer
	wp_enqueue_style( 'twentyfifteen-ie', get_template_directory_uri() . '/css/ie.css', array( 'twentyfifteen-style' ), '20141010' );
	wp_style_add_data( 'twentyfifteen-ie', 'conditional', 'lt IE 9');

	// Підключаємо спеціальні стилі для Internet Explorer 7
	wp_enqueue_style( 'twentyfifteen-ie7', get_template_directory_uri() . '/css/ie7.css', array( 'twentyfifteen-style' ), '20141010' );
	wp_style_add_data( 'twentyfifteen-ie7', 'conditional', 'lt IE 8');
}

Виведе тег link в умовних коментарях:

<!--[if lt IE 9]>
<link rel='stylesheet' id='twentyfifteen-ie-css' href='http://test.ru/wp-content/themes/twentyfifteen/css/ie.css?ver=20141010' type='text/ css' media='all' />
<![endif]-->
<!--[if lt IE 8]>
<link rel='stylesheet' id='twentyfifteen-ie7-css' href='http://test.ru/wp-content/themes/twentyfifteen/css/ie7.css?ver=20141010' type='text/ css' media='all' />
<![endif]-->

ltозначає “lower than” – менше ніж. Щоб вказати більше, використовуйте gt.

0

#2 Інші приклади висновку

//alt
wp_enqueue_style( 'mystyle_id', 'http://example.com/css/mystyle.css');
wp_style_add_data( 'mystyle_id', 'alt', true);
// <link rel='alternate stylesheet' id='mystyle_id-css' href='http://example.com/css/mystyle.css?ver=4.4.1' type='text/css' media=' all' />

// title
wp_style_add_data( 'mystyle_id', 'title', 'foo');
// <link rel='stylesheet' id='mystyle_id-css' title='foo' href='http://example.com/css/mystyle.css?ver=4.4.1' type='text/css 'media='all' />

нотатки

список змін

З версії 3.6.0Введено.
З версії 5.8.0Added ‘path’ як офіційний рівень для $key . See wp_maybe_inline_styles() .

Код wp_style_add_data() WP 6.0.2

function wp_style_add_data( $handle, $key, $value ) {
	return wp_styles()->add_data( $handle, $key, $value );
}

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

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