wp_style_add_data()
Додає дані для файлів стилів, що підключаються за допомогою 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 6IE 7– Тільки для IE 7IE 8– Тільки для IE 8IE 9– Тільки для IE 9gt IE 6– тільки для IE більше 6lt IE 9– тільки для IE менше 9gte IE 7– тільки для IE більше або дорівнює 7lte IE 7– тільки для IE менше або дорівнює 7!IE– для всіх браузерів крім IE Працює лише до IE9 включно, подальші версії IE не підтримують умовних коментарів .
alt– Логічний. Для rel=”alternate stylesheet” .title– Рядок. Для кращих/альтернативних стилів.rtl(Right-to-Left) – Логічний / Рядок. Для оголошення RTL стилів. Для арабської писемності…suffix– Рядок. Суфікс для умови RTL.
- $value
(змішаний) (обов’язковий) - Рядок містить дані, які потрібно додати.
Приклади
#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.
#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' />
нотатки
- Дивіться: WP_Dependencies::add_data()
список змін
| З версії 3.6.0 | Введено. |
| З версії 5.8.0 | Added ‘path’ як офіційний рівень для $key . See wp_maybe_inline_styles() . |
Код wp_style_add_data() wp style add data WP 6.0.2
function wp_style_add_data( $handle, $key, $value ) {
return wp_styles()->add_data( $handle, $key, $value );
}