DIV CSS 佈局教程網

用 Yii 整合 jquery-pjax(pushState + Ajax)實現無刷新換頁
編輯:AJAX基礎知識     

Pjax 是什麼?

 Pjax = history.pushState + Ajax

瀏覽器的 history 物件被強化了一波,重點是對歷史堆疊的操作。以前只有 replace、go 之類的方法,而且一動就會跳轉並刷新整個頁面;現在有了 pushState、replaceState 等純操作歷史堆疊的方法,只是改寫歷史紀錄裡的內容,沒有副作用——頁面不會跳轉、不會刷新。

Pjax 帶來的效果

透過 URL 就能追蹤 Ajax 動態載入的內容。這在 two-step view 的布局裡特別有價值:無刷新換頁意味著回應速度與使用者體驗大幅提升,而靜態腳本與通用模組較多的頁面,還能省下大量重複載入的開銷。Google+、Facebook 與改版後的微博都是這套技術的應用例子。其中 Google+ 的表現最為明顯:點擊導覽列的項目,箭頭會滑向目標、頁面同時淡入,視覺效果相當流暢。

Dirty URL 與 Clean URL

在 pjax 出現之前,要實現「無刷新換頁 + URL 可追蹤」,只能依賴 window.location.hash。做法是寫一個 hashchange 監聽函式,網址的 # 後面改變時就判斷要載入什麼內容。

它的問題不少:低版本瀏覽器(例如 IE6)不支援 hash,得另外建一個 iframe 來記錄歷史網址才能實現前進後退;更麻煩的是,# 後面的內容不會被搜尋引擎索引。Google 曾提出解法,提倡用 #! 把網址引導到 ?escaped_fragment= 的請求位址,Twitter、Facebook、人人、新浪微博都曾用過這種 hash bang。因為不易被搜尋引擎(如百度)收錄,這種 #! 風格的網址被稱為 dirty URL。

相對而言,pjax 能用乾淨的 clean URL 達到同樣效果,並且不依賴 hash,是現階段最合適的方案。

開始前的準備

  1. jQuery 函式庫
  2. 基於 jQuery 的 pjax 外掛:https://github.com/defunkt/jquery-pjax
  3. 一個 PHP 專案(本文用 Yii 框架示範,其他框架大同小異)

一、前端實作

用起來非常簡單,而且這個外掛封裝得很好,可以依喜好高度自訂。以下是一個整合後的基本 HTML 範例:

 <?php Yii::app()->clientScript->registerCoreScript('jquery'); Yii::app()->clientScript->registerScriptFile(Yii::app()->baseUrl . '/js/jquery-pjax/jquery.pjax.js'); ?> <div id="nav"> <a href="<?php echo Yii::app()->createUrl('article/index');?>">article</a> </div> <div id="main">替換的內容</div> <script type="text/javascript"> $(document).ready(function(){ $("#main").pjax("a"); }); </script>

目標是:點擊 a 標籤時,用 Ajax 取回的結果替換 id 為 main 的 div 內容,網址自動更新,而頁面不重載。

二、PHP 端要處理的兩件事

後端要做的事其實只有兩件:一是決定套用哪個 layout 布局,二是判斷這個請求是不是 pjax 發來的。

Yii 中的實作:

 public function actionIndex() { $this->layout = '//layouts/column1'; $dataProvider = new CActiveDataProvider('Article', array( 'criteria' => array('order' => 'create_time DESC') )); if (array_key_exists('HTTP_X_PJAX', $_SERVER) && $_SERVER['HTTP_X_PJAX']) { $this->renderPartial('index', array( 'dataProvider' => $dataProvider, )); } else { $this->render('index', array( 'dataProvider' => $dataProvider, )); } }

關鍵在 HTTP_X_PJAX:外掛在每次請求時都會帶上 X-PJAX: true 標頭。偵測到它就只渲染局部檢視(renderPartial),否則渲染完整頁面(render)。這個判斷讓同一個 action 同時服務 pjax 請求與一般請求,不必寫兩套邏輯——這也是 pjax 相比純 Ajax 方案最漂亮的地方:伺服器端程式碼幾乎不用為它改頭換面。

效果如下:

點擊 article 連結或文章連結後,會出現這樣的換頁效果:

使用 jquery-pjax 的注意事項

  1. 回傳的模板內容不能是純文字,必須用 HTML 標籤完整包好,否則外掛無法正確選取要替換的節點。
  2. 外掛的具體用法請參考 GitHub 專案說明,版本更新後參數名稱可能有變動。
  3. 對於不支援 pushState 的低版本瀏覽器,外掛會自動判斷並退回傳統的整頁載入模式——這正是它優於自己刻的地方。
  4. 當一次 pjax 請求的耗時超過設定門檻,外掛會改用整頁刷新來載入,需要時請調整外掛內的相關參數。
  5. 記得監聽 pjax:complete 等事件來重新初始化那些在換頁後失效的第三方元件(日曆、圖表、選單等),這是 pjax 專案最常見的坑。
XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved