作者:白狼 出處:www.manks.top/article/yii2_load_js_css_in_end
本文版權歸作者,歡迎轉載,但未經作者同意必須保留此段聲明,且在文章頁面明顯位置給出原文連接,否則保留追究法律責任的權利。
正所謂命由己造,相由心生,那麼我們的問題又是怎麼拋出來的喃?
這個問題也算是個比較久遠但是經常會有人要問到的問題。究其原因,
一來實際開發中不可避免,二來也就是剛接觸yii的小伙伴喜歡揪著不放。那
為啥了解過這個問題的人就不糾結了喃?外星人:樓主你si不si撒,人家都了解怎麼做了還糾結這個問題干嘛。
那行,關乎所以的人看看就行。
一般來說,網頁內部的js文件或代碼,都是放置在網頁底部</body>的前面,這是因為網頁自上而下加載,用戶在訪問我們頁面的時候盡量不要因為加載js展現過長時間的空白頁面,停留時間過長就白白流失了用戶量。
yii2中是集成了jQuery的,而且jQuery文件是加載在頁面底部的,因此,如果我們的js代碼段不在頁面底部加載,就很大可能會發生$未定義的友好提示。
我這廢話一大堆得毛病確實需要去掛個號看看了...
先來看看js代碼段怎麼處理
<?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 <[email protected]> * @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