WordPress 教程: 如何正确加载 Javascript 和 CSS

现在许多 WordPress 网站都开始讲要正确加载 jQuery 、 Javascript 和 CSS 到你的 WordPress 网站。之前也分享过一篇用 wp_enqueue_script() 和 wp_enqueue_style() 加载脚本与样式提高效率的文章。今天来一篇更详细讲解如何使用 WordPress 官方推荐的方式来加载脚本/ CSS 的文章。

有两种常用的 add_action 钩子可以加载脚本和 CSS 到 WordPress：

init：确保始终为您的网站头部加载脚本和 CSS（如果使用 home.php，index.php 或一个模板文件），以及其他「前端」文章、页面和模板样式。
wp_enqueue_scripts：「适当」的钩子方法，并不总是有效的，根据你的 WordPress 设置。

下面的所有例子都在 WordPress 多站点模式、 WordPress 3.4.2 通过测试（如果不支持后续版本，请留言告知）

加载外部 jQuery 库和主题自定义的脚本、样式

下面这个例子在 add_action 钩子中使用 init 。使用 init 有两个原因，一是因为我们正在注销 WordPress 默认的 jQuery 库，然后加载谷歌的 jQuery 库；二是确保在 WordPress 的头部就加载脚本和 CSS 。

使用 if ( !is_admin() ) 是为了确保这些脚本和 css 只在前端加载，不会再后台管理界面加载。

/** Google jQuery Library, Custom jQuery and CSS Files */
function myScripts() {
        wp_register_script( 'google', 'http://googleajax.admincdn.com/ajax/libs/jquery/1.8.2/jquery.js' );
        wp_register_script( 'default', get_template_directory_uri() . '/jquery.js' );
        wp_register_style( 'default', get_template_directory_uri() . '/style.css' );
    if ( !is_admin() ) { /** Load Scripts and Style on Website Only */
        wp_deregister_script( 'jquery' );
        wp_enqueue_script( 'google' );
        wp_enqueue_script( 'default' );
        wp_enqueue_style( 'default' );
    }
}
add_action( 'init', 'myScripts' );

加载 WP 默认 jQuery 库和主题自定义的脚本、样式

第 3 行：使用 array(『jquery』) 是为了告诉 WordPress 这个 jquery.js 是依赖 WordPress 的 jQuery 库文件，从而使 jquery.js 在 WordPress jQuery 库文件后加载。

/** Add Custom jQuery and CSS files to a Theme */
function myScripts() {
        wp_register_script( 'default', get_template_directory_uri() . '/jquery.js', array('jquery'), '' );
        wp_register_style( 'default', get_template_directory_uri() . '/style.css' );
    if ( !is_admin() ) { /** Load Scripts and Style on Website Only */
        wp_enqueue_script( 'default' );
        wp_enqueue_style( 'default' );
    }
}
add_action( 'init', 'myScripts' );

加载 print.css 到你的 WordPress 主题

第 3 行：最后的『print』是媒体屏幕调用，确保 print.css 在网站的打印机中的文件加载时才加载。

/** Adding a Print Stylesheet to a Theme */
function myPrintCss() {
        wp_register_style( 'print', get_template_directory_uri() . '/print.css', '', '', 'print' );
    if ( !is_admin() ) { /** Load Scripts and Style on Website Only */
        wp_enqueue_style( 'print' );
    }
}
add_action( 'init', 'myPrintCss' );

使用 wp_enqueue_scripts 替换 init

如果你要在文章或页面加载唯一的脚本，那就应该使用 wp_enqueue_scripts 替换 init 。使用 wp_enqueue_scripts 仅仅只会在前台加载脚本和 CSS，不会在后台管理界面加载，所以没必要使用 !is_admin() 判断。

使用 is_single() 只在文章加载脚本或 CSS

第 3 行的 # 替换为文章的 ID 就可以让脚本和 css 只加载到那篇文章。当然，如果直接使用 is_single()（不填 ID），就会在所有文章加载脚本和 CSS 。

/** Adding Scripts To A Unique Post */
function myScripts() {
    if ( is_single(#) ) { /** Load Scripts and Style on Posts Only */
        /** Add jQuery and/or CSS Enqueue */
    }
}
add_action( 'wp_enqueue_scripts', 'myScripts' );

使用 is_page() 只在页面加载脚本或 CSS

第 3 行的 # 替换为页面的 ID 就可以让脚本和 css 只加载到那个页面。当然，如果直接使用 is_single()（不填 ID），就会在所有页面加载脚本和 CSS 。

/** Adding Scripts To A Unique Page */
function myScripts() {
    if ( is_page(#) ) { /** Load Scripts and Style on Pages Only */
        /** Add jQuery and/or CSS Enqueue */
    }
}
add_action( 'wp_enqueue_scripts', 'myScripts' );

使用 admin_enqueue_scripts 加载脚本到后台

这个例子将在整个后台管理界面加载脚本和 CSS 。这个方法不推荐用在插件上，除非插件重建了整个后台管理区。

第 10 行使用 admin_enqueue_scripts 替换了 init 或 wp_enqueue_scripts

第 5 、 6 行，如果你要自定义后台管理区，你可以需要禁用默认的 WordPress CSS 调用。

/** Adding Scripts To The WordPress Admin Area Only */
function myAdminScripts() {
    wp_register_script( 'default', get_template_directory_uri() . '/jquery.js', array('jquery'), '' );
    wp_enqueue_script( 'default' );
    //wp_deregister_style( 'ie' ); /** removes ie stylesheet */
    //wp_deregister_style( 'colors' ); /** disables default css */
    wp_register_style( 'default', get_template_directory_uri() . '/style.css',  array(), '', 'all' );
    wp_enqueue_style( 'default' );
}
add_action( 'admin_enqueue_scripts', 'myAdminScripts' );

加载脚本和 CSS 到 WordPress 登录界面

第 6 行：我无法弄清楚如何在在登录页面注册/排序 CSS 文件，所以这行手动添加样式表。

第 10-14 行：用来移除 WordPress 默认的样式表。

/** Adding Scripts To The WordPress Login Page */
function myLoginScripts() {
    wp_register_script( 'default', get_template_directory_uri() . '/jquery.js', array('jquery'), '' );
    wp_enqueue_script( 'default' );
?>
    <link rel='stylesheet' id='default-css' href='<?php echo get_template_directory_uri() . '/style.css';?>' type='text/css' media='all' />
<?php }
add_action( 'login_enqueue_scripts', 'myLoginScripts' );
/** Deregister the login css files */
function removeScripts() {
    wp_deregister_style( 'wp-admin' );
    wp_deregister_style( 'colors-fresh' );
}
add_action( 'login_init', 'removeScripts' );

加载脚本和 CSS 到 WordPress 插件

WordPress 插件加载脚本和 CSS 也是常见的。主要的不同之处在于文件的 URL 。主题使用的是 get_template_directory_uri ，而插件应该用 plugins_url ，因为文件是从插件目录进行加载的。

从插件加载脚本和 CSS

这个例子将在整个网站前端加载脚本和 CSS 。

/** Global Plugin Scripts for Outside of Website */
function pluginScripts() {
    wp_register_script( 'plugin', plugins_url( 'jquery.js' , __FILE__ ), array('jquery'), '' );
    wp_register_style( 'plugin', plugins_url( 'style.css' , __FILE__ ) );
    if ( !is_admin() ) { /** Load Scripts and Style on Website Only */
        wp_enqueue_script( 'plugin' );
        wp_enqueue_style( 'plugin' );
    }
}
add_action( 'init', 'pluginScripts' );

从插件加载脚本和 CSS 到后台管理区

如果你需要在整个后台管理区加载脚本和 CSS，就使用 admin_enqueue_scripts 替换 init 。

/** Global Plugin Scripts for The WordPress Admin Area */
function pluginScripts() {
    wp_register_script( 'plugin', plugins_url( 'jquery1.js' , __FILE__ ), array('jquery'), '' );
    wp_enqueue_script( 'plugin' );
    wp_register_style( 'plugin', plugins_url( 'style1.css' , __FILE__ ) );
    wp_enqueue_style( 'plugin' );
}
add_action( 'admin_enqueue_scripts', 'pluginScripts' );

从插件加载脚本和 CSS 到插件设置页面

例子只会加载所需的脚本和 CSS 到插件设置页面，不会在管理区的其他页面加载。

第 3 行：自定义 page= 后面的值为你的插件设置页面

/** Adding Scripts On A Plugins Settings Page */
function pluginScripts() {
    if ( $_GET['page'] == "plugin_page_name.php" ) {
        wp_register_script( 'plugin', plugins_url( 'jquery.js' , __FILE__ ), array('jquery'), '' );
        wp_enqueue_script( 'plugin' );
        wp_register_style( 'plugin', plugins_url( 'style.css' , __FILE__ ) );
        wp_enqueue_style( 'plugin' );
    }
}
add_action( 'admin_enqueue_scripts', 'pluginScripts' );

将 jQuery 库移动到页脚

你不能将 WordPress 默认的 jQuery 库移动到页面底部，但是你可以将自定义的 jQuery 或其他外部 jQuery 库（比如 Google 的）移动到底部。不要将 CSS 移动到页面底部。

第 3 、 4 行：最后的『true』告诉 WordPress 在页面底部加载这些脚本。

/** Moves jQuery to Footer */
function footerScript() {
        wp_register_script('jquery', ("http://googleajax.admincdn.com/ajax/libs/jquery/1.8.2/jquery.js"), false, '', true );
        wp_register_script( 'default', get_template_directory_uri() . '/jquery.js', false, '', true );
    if ( !is_admin() ) { /** Load Scripts and Style on Website Only */
        wp_deregister_script( 'jquery' );
        wp_enqueue_script( 'jquery' );
        wp_enqueue_script( 'default' );
    }
}
add_action( 'init', 'footerScript' );

根据不用的用户角色和功能加载 jQuery 和 CSS

如果你的网站有作者、编辑和其他管理员，你可能需要通过 jQuery 来为他们显示不同的信息。你需要使用 current_user_can 确定登录的用户的角色和功能。

下面三个例子中，如果用户已经登录，将在整个网站加载这些脚本和 CSS 。使用 !is_admin() 包装 enqueue_script 确保只在前台加载，或者在 add_action 使用 admin_enqueue_scripts 就可以确保只在后台管理区加载。

为可以「编辑文章」的管理员加载脚本和 CSS

只对超级管理员和网站管理员生效

/** Add CSS & jQuery based on Roles and Capabilities */
function myScripts() {
    if ( current_user_can('edit_posts') ) {
        /** Add jQuery and/or CSS Enqueue */
    }
}
add_action( 'init', 'myScripts' );

为所有登录用户加载脚本和 CSS

/** Admins / Authors / Contributors /  Subscribers */
function myScripts() {
    if ( current_user_can('read') ) {
        /** Add jQuery and/or CSS Enqueue */
    }
}
add_action( 'init', 'myScripts' );

为管理员以外的已登录用户加载脚本和 CSS

/** Disable for Super Admins / Admins enable for Authors / Contributors /  Subscribers */
function myScripts() {
    if ( current_user_can('read') && !current_user_can('edit_users') ) {
        /** Add jQuery and/or CSS Enqueue */
    }
}
add_action( 'init', 'myScripts' );

最后的提示

上面的很多例子如果使用相同的 add_action，就可以被合并成一个单一的函数。

换句话说，您可以使用多个 if 语句在一个函数中分裂了你的脚本和 CSS 调用，如：if_admin！if_admin，is_page，is_single 和 current_user_can 的，因为每次使用相同的 add_action 的 init 。

参考原文（有删改）：http://technerdia.com/1789_include-jquery-css.html

WordPress 教程: 如何正确加载 Javascript 和 CSS