WordPress引入css/js兩種方法


WordPress引入css/js 是我們制作主題時首先面對的一個難點,任何一款主題都要加載自己的css,js,甚至很有可能還需要加載Jquery文件,網上方法特多,說法不一,我們今天借鑒wordpress官方最新的twentysixteen主題來學習總結一下WordPress引入css/js各種常用方法,以及最優化的加載方法。

其實網上的N種方法總結起來就兩種:
一、模板文件header.php中直接引入文件
二、在主題的functions.php中通過WP自帶的函數wp_enqueue_scripts來加載JS文件,通過wp_enqueue_style來加載Css樣式。

一、模板文件header.php中直接引入文件

1、最好懂,最直白,最不好的方法在模板文件header.php中直接引入文件

  1. <script type='text/javascript' src='http://www.jquery.com/js/jquery/1.10.2/jquery-1.10.2.min.js'></script>
  2. <script type='text/javascript' src='http://www.511yj.com/css/bootstrapwp.js'></script>
  3. <link rel="stylesheet" href="http://www.511yj.com/css/bootstrapwp.css">

你覺得這樣很無聊的話,還可以這樣

  1. <link rel="stylesheet" href="<?php echo get_template_directory_uri(); ?>/style.css">
  2. <script src="<?php echo get_template_directory_uri(); ?>/bootstrap/js/bootstrap.js"></script>

通過函數get_template_directory_uri()獲得主題目錄 通過echo輸出。

注意啦以下方法雖然放在了functions.php中,表面感覺好了點......

  1. <?php
  2.  function add_stylesheet_to_head() {
  3.     echo "<link href='http://fonts.useso.com/css?family=Open+Sans:300,400,600&subset=latin,latin-ext' rel='stylesheet'>";
  4. }
  5.  add_action( 'wp_head', 'add_stylesheet_to_head' );
  6.  ?>

但是WordPress 不能確定是否在在頁面加載了JS,Css文件,如果另一個插件使用相同的JS,Css文件,就無法檢查JS,Css文件是否已經被包含在頁面中。然后插件第二次加載同一個文件,造成重復的代碼,響應速度變慢。

二、引入WordPress優化解決方案:注冊和排隊

1、注冊
wp_register_style() 函數進行注冊:

  1. <?php wp_register_style( $handle, $src, $deps, $ver, $media ); ?>

參數:
$handle(字符串,必需)是你的樣式表唯一名稱。其他函數將使用這個“handle”來排隊並打印樣式表。
$src(字符串,必需)指的是樣式表的URL。您可以使用函數,如 get_template_directory_uri() 來獲取主題目錄中的樣式文件。永遠不要去想硬編碼了!
$deps (數組,可選)處理相關樣式的名稱。如果丟失某些其他樣式文件將導致你的樣式表將無法正常工作,你可以使用該參數設置“依賴關系”。
$ver (字符串或布爾型,可選)版本號。你可以使用你的主題的版本號或任何一個你想要的。如果您不希望使用一個版本號,將其設置為null。默認為false,這使得WordPress的添加自己的版本號。
$media (字符串,可選)是指CSS的媒體類型,比如“screen”或“handheld”或“print”。如果你不知道是否需要使用這個,那就不使用它。默認為“all”。
例子:

  1. wp_register_style(
  2.     'my-bootstrap-extension', // 名稱
  3.     get_template_directory_uri() . '/css/my-bootstrap-extension.css', // 樣式表的路徑
  4.     array( 'bootstrap-main' ), // 依存的其他樣式表
  5.     '1.2', // 版本號
  6.     'screen', // CSS 媒體類型
  7. );

wp_register_style() 函數進行注冊:

  1. <?php wp_enqueue_script( $handle, $src, $deps, $ver, $in_footer ); ?>

參數
$handle(字符串)(必需)腳本名稱。小寫字符串。默認值:None
$src(字符串)(可選)WordPress根目錄下的腳本路徑示例:"/wp-includes/js/scriptaculous/scriptaculous.js"。該參數只在WordPress不了解腳本情況時使用。默認值:None
$deps(數組)(可選)腳本所依靠的句柄組成的數組;加載該腳本前需要加載的其它腳本。若沒有依賴關系,返回false。該參數只在WordPress不了解腳本情況時使用。默認值:array()
$ver(字符串)(可選)指明腳本版本號的字符串(若存在版本號)。默認為false。該參數可確保即使在啟用緩存的狀態下,發送給客戶端的仍然是正確版本,因此如果版本號可用且對腳本有意義,包含該版本號。默認值:false
$in_footer(布爾型)(可選)通常情況下腳本會被放置在區塊中。如果該函數為true,腳本則會出現在區塊的最下方。要求主題在適當的位置中包含有wp_footer()鈎子。(WordPress新功能)默認值:false

例子:

  1. <?php
  2. function my_enqueue_scripts() {
  3. if( !is_admin ) { // 前台加載的腳本與樣式表
  4. // 去除已注冊的 jquery 腳本
  5. wp_deregister_script( 'jquery' );
  6. // 注冊 jquery 腳本
  7. wp_register_script( 'jquery', get_template_directory_uri() . '/js/jquery.js', false, '1.0', false );
  8. // 提交加載 jquery 腳本
  9. wp_enqueue_script( 'jquery' );
  10.  } 
  11. } 
  12. // 添加回調函數到 init 動作上
  13. add_action( 'init', 'my_enqueue_scripts' );
  14. ?>

當css/js很多,並且要分情況加載時,需要使用wp_register_script()wp_register_style()函數,可以更好的管理資源,避免重復勞動。下面的示例代碼中,先在init action上把所有需要用到樣式表都注冊一遍,之后不管想在哪里引入,都可以簡單的用wp_enqueue_style( $handle )來加載。

  1. // 在init action處注冊腳本,可以與其它邏輯代碼放在一起
  2. function my_init(){
  3.     $url = get_template_directory_uri();
  4.     // 注冊樣式表
  5.     $styles = array(
  6.         'style1' => $url . '/css/style1.css',
  7.         'style2' => $url . '/css/style2.css',
  8.         'style3' => $url . '/css/style3.css'
  9.     );
  10.      foreach( $styles as $k => $v ){
  11.         wp_register_style( $k, $v, false );
  12.     } 
  13.     // 注冊腳本     
  14.     // 其它需要在init action處運行的腳本
  15. }
  16. add_action( 'init', 'my_init' );

注冊腳本時需要運行$wp_scripts->add( $handle, $src, $deps, $ver );,若腳本沒有注冊直接使用wp_enqueue_script,需要先調用add方法,也就是說重復enqueue一個腳本就會運行多次add方法,降低了程序的效率。
在WordPress中,注冊樣式是“可選的”。如果你的樣式不會被其他插件使用,或者你不打算使用任何代碼來再次加載它,你可以自由地排隊樣式而不需要注冊它。繼續看看它是如何實現的。
2、排隊 
wp_register_style() 函數是不強制使用的,我要告訴你,你可以用兩種不同的方式使用 wp_enqueue_style():

  1. <?php
  2.  // 如果我們之前已經注冊過樣式
  3. wp_enqueue_style( 'my-bootstrap-extension' ); 
  4. // 如果我們之前沒有注冊,我們不得不設置 $src 參數!
  5. wp_enqueue_style(
  6.     'my-bootstrap-extension',
  7.     get_template_directory_uri() . '/css/my-bootstrap-extension.css',
  8.     array( 'bootstrap-main' ),
  9.     null, // 舉例不適用版本號
  10.     // ...並且沒有指定CSS媒體類型
  11. ); 
  12. ?>

切記:如果一個插件將要用到你的樣式表,或者你打算將在你的主題的不同地方進行加載,你絕對應該先注冊。
3、加載樣式到我們的網站
我們不能在主題中隨便找個地方使用 wp_enqueue_style() 函數 - 我們需要使用“動作”鈎子。還有我們可以使用各種用途的三個動作鈎子:
wp_enqueue_scripts 用來在網站前台加載腳本和CSS
admin_enqueue_scripts 用來在后台加載腳本和CSS
login_enqueue_scripts 用來在WP登錄頁面加載腳本和CSS
以下是這些鈎子的示例:

  1. <?php
  2.  // 在網站前台加載css
  3. function mytheme_enqueue_style() {
  4.     wp_enqueue_style( 'mytheme-style', get_stylesheet_uri() ); 
  5. }
  6. add_action( 'wp_enqueue_scripts', 'mytheme_enqueue_style' );
  7.  
  8. // 在后台加載css
  9. function mytheme_enqueue_options_style() {
  10.     wp_enqueue_style( 'mytheme-options-style', get_template_directory_uri() . '/css/admin.css' ); 
  11. }
  12. add_action( 'admin_enqueue_scripts', 'mytheme_enqueue_options_style' );
  13.  
  14. // 在登錄頁面加載css
  15. function mytheme_enqueue_login_style() {
  16.     wp_enqueue_style( 'mytheme-options-style', get_template_directory_uri() . '/css/login.css' ); 
  17. }
  18. add_action( 'login_enqueue_scripts', 'mytheme_enqueue_login_style' );
  19.  ?>

4、另外一個函數:wp_print_scripts()
雖然將 JavaScript 文件都放到頁面末尾加載對於頁面加載速度很有幫助,但是請注意,所謂頁面末尾指的是在 WordPress 的 wp_footer() 函數中調用,這個函數通常剛好位於頁面的 標簽前面(當然是末尾了)。
有時候我們可能會在 wp_footer 函數出現之前就需要用到某些 JavaScript,比如 jquery.js 文件。
這樣的情況也是很常見的。比如我單獨創建了一個鏈接頁面,在這個頁面中我使用了 jQuery 方法來獲取鏈接網站的 favicon。很顯然,我只需要在這唯一一個頁面使用這部分代碼,所以將這段代碼直接放在這個頁面模板中是最好的做法。
問題來了:這部分內容顯然是在 wp_footer 之前出現的,那么這段代碼就在 jquery.js 文件之前出現了,導致該代碼段實際上無法工作,因為調用 jQuery 方法的代碼段必須比 jquery.js 文件后加載。
那么如何處理這種特殊情況呢?其實也很簡單。以上面的情景為例,既然我們需要先調用 jquery.js 文件,那我們就在該代碼段之前直接輸出需要的 jquery.js 文件,不使用 wp_enqueue_script() 函數,而改用wp_print_scripts() 函數。
wp_enqueue_script() 與 wp_print_scripts() 的區別是:wp_enqueue_script() 是告訴 WordPress “我在這個頁面上需要用到某個 JavaScript 文件,你可要記得加載啊”。WordPress 默認在 wp_head() 中處理,而我們改為在 wp_footer() 中處理。wp_print_scripts() 則直接在你使用此方法的位置輸出需要的 JavaScript 文件,而不是加入到 WordPress 的處理任務中。
如果我們在頁面的中間使用,

  1.  <?php wp_print_scripts('jquery'); ?>

直接輸出了 jquery.js 文件(通常是其壓縮版本 jquery.min.js),那么即使其它的插件或者什么東西使用,

  1.  <?php wp_enqueue_script('jquery'); ?>

告訴 WordPress 需要加載 jquery.js,WordPress 在 wp_footer() 中處理的時候也會先檢查前面是不是已經有了,如果有了就不會再重新加載一次。
5、一些額外的函數
WordPress 有一些關於 CSS 非常有用的函數:他們允許我們打印內嵌樣式,查看樣式文件的排隊狀態,添加元數據以及注銷樣式。
添加動態內聯樣式:wp_add_inline_style()
如果你的主題有選項可自定義主題的樣式,你可以使用 wp_add_inline_style() 函數來打印內置的樣式:

  1. function mytheme_custom_styles() {
  2.     wp_enqueue_style( 'custom-style', get_template_directory_uri() . '/css/custom-style.css' );
  3.     $bold_headlines = get_theme_mod( 'headline-font-weight' ); // 比方說,它的值是粗體“bold”
  4.     $custom_inline_style = '.headline { font-weight: ' . $bold_headlines . '; }';
  5.     wp_add_inline_style( 'custom-style', $custom_inline_style );
  6. }
  7. add_action( 'wp_enqueue_scripts', 'mytheme_custom_styles' );

方便快捷。但請記住:你必須使用與后面要添加的內聯樣式樣式表相同的hadle名稱。

添加元數據到樣式表:wp_style_add_data()

wp_style_add_data() 是一個非常棒的函數,它可以讓你添加元數據到你的樣式中,包括條件注釋、RTL的支持和更多!

  1. <?php
  2. // wp_style_add_data() 示例
  3. function mytheme_extra_styles() {
  4.     wp_enqueue_style( 'mytheme-ie', get_template_directory_uri() . '/css/ie.css' );
  5.     wp_style_add_data( 'mytheme-ie', 'conditional', 'lt IE 9' );
  6.     /*
  7.      * alternate usage:
  8.      * $GLOBALS['wp_styles']->add_data( 'mytheme-ie', 'conditional', 'lte IE 9' );
  9.      * wp_style_add_data() is cleaner, though.
  10.      */
  11. }
  12.  
  13. add_action( 'wp_enqueue_scripts', 'mytheme_ie_style' );
  14.  
  15. ?>


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM