Pjax 是什麼?
Pjax = history.pushState + Ajax
瀏覽器的 history 物件被強化了一波,重點是對歷史堆疊的操作。以前只有 replace、go 之類的方法,而且一動就會跳轉並刷新整個頁面;現在有了 pushState、replaceState 等純操作歷史堆疊的方法,只是改寫歷史紀錄裡的內容,沒有副作用——頁面不會跳轉、不會刷新。
透過 URL 就能追蹤 Ajax 動態載入的內容。這在 two-step view 的布局裡特別有價值:無刷新換頁意味著回應速度與使用者體驗大幅提升,而靜態腳本與通用模組較多的頁面,還能省下大量重複載入的開銷。Google+、Facebook 與改版後的微博都是這套技術的應用例子。其中 Google+ 的表現最為明顯:點擊導覽列的項目,箭頭會滑向目標、頁面同時淡入,視覺效果相當流暢。
在 pjax 出現之前,要實現「無刷新換頁 + URL 可追蹤」,只能依賴 window.location.hash。做法是寫一個 hashchange 監聽函式,網址的 # 後面改變時就判斷要載入什麼內容。
它的問題不少:低版本瀏覽器(例如 IE6)不支援 hash,得另外建一個 iframe 來記錄歷史網址才能實現前進後退;更麻煩的是,# 後面的內容不會被搜尋引擎索引。Google 曾提出解法,提倡用 #! 把網址引導到 ?escaped_fragment= 的請求位址,Twitter、Facebook、人人、新浪微博都曾用過這種 hash bang。因為不易被搜尋引擎(如百度)收錄,這種 #! 風格的網址被稱為 dirty URL。
相對而言,pjax 能用乾淨的 clean URL 達到同樣效果,並且不依賴 hash,是現階段最合適的方案。
用起來非常簡單,而且這個外掛封裝得很好,可以依喜好高度自訂。以下是一個整合後的基本 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 內容,網址自動更新,而頁面不重載。
後端要做的事其實只有兩件:一是決定套用哪個 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 連結或文章連結後,會出現這樣的換頁效果:

pjax:complete 等事件來重新初始化那些在換頁後失效的第三方元件(日曆、圖表、選單等),這是 pjax 專案最常見的坑。