yii2 如何在頁面底部加載css和js

做者:白狼 出處:http://www.manks.top/article/yii2_load_js_css_in_end 本文版權歸做者,歡迎轉載,但未經做者贊成必須保留此段聲明,且在文章頁面明顯位置給出原文鏈接,不然保留追究法律責任的權利。php

正所謂命由己造,相由心生,那麼咱們的問題又是怎麼拋出來的喃?css

這個問題也算是個比較久遠可是常常會有人要問到的問題。究其緣由,html

一來實際開發中不可避免,二來也就是剛接觸yii的小夥伴喜歡揪着不放。那web

爲啥瞭解過這個問題的人就不糾結了喃?外星人:樓主你si不si撒,人家都瞭解怎麼作了還糾結這個問題幹嗎。bootstrap

那行,關乎因此的人看看就行。yii2

通常來講,網頁內部的js文件或代碼,都是放置在網頁底部</body>的前面,這是由於網頁自上而下加載,用戶在訪問咱們頁面的時候儘可能不要由於加載js展示過長時間的空白頁面,停留時間過長就白白流失了用戶量。yii

yii2中是集成了jQuery的,並且jQuery文件是加載在頁面底部的,所以,若是咱們的js代碼段不在頁面底部加載,就很大可能會發生$未定義的友好提示。ide

我這廢話一大堆得毛病確實須要去掛個號看看了...ui

先來看看js代碼段怎麼處理this

<?php
$this->registerJs('
$(function () {
//隨心所欲的寫你想要寫的js代碼吧
$......
});
', \yii\web\View::POS_END);

對,就是用上面的registerJs方法註冊,有小夥伴聽不懂了,啥是註冊,簡單理解就是把你的js代碼放置在你想要放的頁面位置。

第一個參數嘛,很好理解,就是咱們要寫的js代碼塊。第二個參數就是咱們須要指定代碼塊插入在頁面的具體位置了。

第二個參數這裏只討論 \yii\web\View::POS_END,意思就是頁面底部</body>以前插入。

固然還有第三個參數,意思是js代碼塊的一個id標示,不指定會默認生成,此處忽略。

哦對了,上面的$this不要混淆,這裏是指yii\web\View對象

接下來一塊兒看看怎麼引入外部的js文件。

官網的例子是這樣給的

$this->registerJsFile('http://example.com/js/main.js', ['depends' => [\yii\web\JqueryAsset::className()]]);

可是人家說了,咱們不建議這麼用,這樣依賴來依賴去關係複雜。

好了,咱們來看看怎麼使用包管理asset bundles進行註冊吧。

咱們先打開文件 backend\assets\AppAsset.php文件瞅瞅是什麼高大上的東西,我擦,果真高深,我張做徹底看不懂的樣子,完了,下面無法寫了,看不懂怎麼講,迴歸正題,咱們要抓緊時間擴展下。

咱們在AppAsset類裏添加了兩個靜態方法,完整版的AppAsset類以下:

namespace backend\assets;
use yii\web\AssetBundle;
/**
 * @author Qiang Xue <qiang.xue@gmail.com>
 * @since 2.0
 */
class AppAsset extends AssetBundle
{
    public $basePath = '@webroot';
    public $baseUrl = '@web';
    public $css = [
        'css/site.css',
    ];
    public $js = [
    ];
    public $depends = [
        'yii\web\YiiAsset',
        'yii\bootstrap\BootstrapAsset',
    ];
    //定義按需加載JS方法,注意加載順序在最後  
    public static function addScript($view, $jsfile) {  
        $view->registerJsFile($jsfile, [AppAsset::className(), 'depends' => 'backend\assets\AppAsset']);  
    }  
      
    //定義按需加載css方法,注意加載順序在最後  
    public static function addCss($view, $cssfile) {  
        $view->registerCssFile($cssfile, [AppAsset::className(), 'depends' => 'backend\assets\AppAsset']);  
    }  
}

咱們先來講說添加的addScript和addCss有啥做用,意圖是啥,上面說了,不建議在view層直接用$this->registerJsFile方法註冊文件,這裏呢,咱們添加的addScript方法,之後view層直接調用這個方法對文件進行註冊。

那爲啥這個就行了呢?好處是很是明顯的,調用該方法避免了每次註冊文件都要填寫依賴關係,十分方便。

其中須要說明的是,須要註冊的文件都會在yii.js和bootstrap.js文件的後面,這也正是咱們所須要的。

這樣一來,咱們在view層加載外部js文件也就灰常簡單了,像下面這樣,

use backend\assets\AppAsset;
AppAsset::register($this);
AppAsset::addScript($this,'/css/main.js');

而沒必要像下面這樣繁瑣:

$this->registerJsFile('/css/main.js',['depends'=>['backend\assets\AppAsset'], 'position'=> $this::POS_END]);
$this->registerJsFile('/css/left.js',['depends'=>['backend\assets\AppAsset']]);
$this->registerJsFile('/css/extension.js',['depends'=>['backend\assets\AppAsset']]);

到此喃,咱們就完整的實現了在yii2中頁面底部加載css,js代碼或外部文件了。

若是你還想深刻了解更多,能夠繼續參考官方文檔。

官方文檔 http://www.yiiframework.com/doc-2.0/guide-structure-assets.html

http://www.yiiframework.com/doc-2.0/guide-output-client-scripts.html

相關文章
相關標籤/搜索