WordPress.org

Ready to get started?Download WordPress

Codex

Attention Interested in functions, hooks, classes, or methods? Check out the new WordPress Code Reference!

Справочник по функциям/wp enqueue style

Описание

Ставит файл CSS стилей в очередь на загрузку.

Использование

<?php wp_enqueue_style$handle$src$deps$ver$media ?>

Параметры

$handle
(string) (required) Название стиля.
Default: None
$src
(string|boolean) (optional) Путь до файла стилей от корневой директории WordPress. Например: '/css/mystyle.css'. Также возможно указание полного URL до файла стилей.
Default: false
$deps
(array) (optional) Массив названий стилей от которых зависит данный файл стилей; стили которые должни быть загружены перед этим стилем. false в случае если нет зависимостей. Этот параметр необходим только в случае, если WordPress еще не знает об этом стиле.
Default: array()
$ver
(string|boolean) (optional) Строка указывающая версию стиля, если она у него есть. По умолчанию false. Этот параметр используется для того чтобы удостовериться, что клиент получил верную версию стилей, а не из кеша.
Default: false
$media
(string|boolean) (optional) Строка указывающая тип медиа к которой относится данный стиль. Например: 'all', 'screen', 'handheld', 'print'. Смотрите список медиа типов чтобы узнать полный список верных медиа типов CSS.
Default: false

Возвращаемые значения

(void) 
Эта функция не возвращает значений.

Примеры

Используем хук

<?php

    /*
     * Этот пример будет работать в WordPress 2.7
     */

    /*
     * регистрируем хук 'wp_print_styles'
     */
    add_action('wp_print_styles', 'add_my_stylesheet');

    /*
     * Добавляем в очередь файл стилей, если он существует.
     */

    function add_my_stylesheet() {
        $myStyleUrl = WP_PLUGIN_URL . '/myPlugin/style.css';
        $myStyleFile = WP_PLUGIN_DIR . '/myPlugin/style.css';
        if ( file_exists($myStyleFile) ) {
            wp_register_style('myStyleSheets', $myStyleUrl);
            wp_enqueue_style( 'myStyleSheets');
        }
    }

?>

Загружаем стили плагина только на его страницах

<?php

    /*
     * Этот пример будет работать как минимум на WordPress 2.6.3,
     * хотя возможно и на более ранних версиях.
     */

    add_action('admin_init', 'my_plugin_admin_init');
    add_action('admin_menu', 'my_plugin_admin_menu');
    
    function my_plugin_admin_init()
    {
        /* Регистрируем наш стиль. */
        wp_register_style('myPluginStylesheet', WP_PLUGIN_URL . '/myPlugin/stylesheet.css');
    }
    
    function my_plugin_admin_menu()
    {
        /* Регистрируем страницу нашего плагина */
        $page = add_submenu_page( 'edit.php', 
                                  __('Мой плагин', 'myPlugin'), 
                                  __('Мой плагин', 'myPlugin'), 9,  __FILE__, 
                                  'my_plugin_manage_menu');
   
        /* Используем зарегистрированный хендл страницы 
           чтобы добавить хук на загрузку стилей */
        add_action('admin_print_styles-' . $page, 'my_plugin_admin_styles');
    }
    
    function my_plugin_admin_styles()
    {
        /*
         * Эта функция будет вызвана только на странице плагина, 
           поставим наш стиль в очередь здесь */
        wp_enqueue_style('myPluginStylesheet');
    }
    
    function my_plugin_manage_menu()
    {
        /* Output our admin page */
    }
    
?>

Примечание

  • Смотрите WP_Styles::add(), WP_Styles::enqueue()
  • Используется global: (unknown type) $wp_styles

История изменений

Начиная с: 2.1 (версия BackPress: r79)

Исходный файл

wp_enqueue_style() содержится в wp-includes/functions.wp-styles.php.

Схожее

См. также содержание справочника по функциям и список тегов шаблонов.