大熊君學習html5系列之------History API(SPA單頁應用的必備)


一,開篇分析

Hi,大家好!大熊君又和大家見面了,(*^__^*) 嘻嘻……,這系列文章主要是學習Html5相關的知識點,以學習API知識點為入口,由淺入深的引入實例,

讓大家一步一步的體會"h5"能夠做什么,以及在實際項目中如何去合理的運用達到使用自如,完美駕馭O(∩_∩)O~,好了,廢話不多說,直接進入今天的主題,

今天主要講的是“History API”及在單頁應用中的作用,並且會引入一個實際的例子做為講解的原型范例,先來看看“History API”:

  為了提高Web頁面的響應速度,越來越多的開發者開始采用單頁面結構(single-page application)的解決方案。所謂的單頁面結構就是指多個頁面間切換時,不刷新當前整個頁面,更新頁面展示數據,並且相應地改變地址欄中的url,以使用戶可以分享這個url。

  如果你使用chrome或者firefox等瀏覽器訪問"github.com、plus.google.com"等網站時,細心的你會發現頁面之間的點擊是通過ajax異步請求的,

同時頁面的URL發生了了改變。並且能夠很好的支持瀏覽器前進和后退。是什么有這么強大的功能呢?恩,這就會說到今天的主角,HTML5里引用了新的API:

“history.pushState”和“history.replaceState”,就是通過這個接口做到無刷新改變頁面URL的。先來看看"history"接口的詳細方法:

1 interface History {
2   readonly attribute long length;
3   readonly attribute any state;
4   void go(optional long delta);
5   void back();
6   void forward();
7   void pushState(any data, DOMString title, optional DOMString? url = null);
8   void replaceState(any data, DOMString title, optional DOMString? url = null);
9 };

 

(二),重點API說明

 

 

  在這里說明一點:"window.history.replaceState"和"window.history.pushState"類似,不同之處在於replaceState不會在window.history里新增歷史記錄點,其效果類似於window.location.replace(url),都是不會在歷史記錄點里新增一個記錄點的。當你為了響應用戶的某些操作,而要更新當前歷史記錄條目的狀態對象或URL時,使用replaceState()方法會特別合適。

 

(三),引入實例

  今天說說單頁應用中我們通常會這樣做,有一個菜單列表,點擊相關菜單項然后動態加載相關模塊,所有方式都是基於異步請求的,美中不足是,我們會發現地址欄不會有任何變化,以及瀏覽器中的前進和后退操作也不會有任何響應,這對用戶不是很友好,所以為了解決這個問題“History”就有用武之地了,那么如何做到的那?不急先看一下例子中的效果圖展示,然后一步步分析,如下所示:

  

  以下是監測數據,相同的url再次刷新不會重復請求。

  

 

  我們梳理一下流程:

    頁面首次載入,雖然我們訪問的URL是"http://localhost:8888/bbSPA.html",但是,實際URL確是:

"http://localhost:8888/bbSPA.html#shanghai",”history.replaceState“完成了初始化url切換工作,並且初始做了加載

"shanghai.data"的數據工作,鼠標點擊左邊的任意一個菜單項,右側內容是Ajax載入,並且頁面的URL隨之發生改變,例如,點擊北京。

此時,我們點擊地址欄的后退按鈕,又回到了上海,並且顯示內容。原理很簡單,就是通過監聽”window.onpopstate“,達到了自由切換的作用。

好了!其實很簡單大家也嘗試自己實踐一下,以下是完整代碼:

  (1),html部分代碼  

 1 <body>    
 2     <center>
 3         <Strong>bbSPA測試頁面</strong>
 4     </center>
 5     <hr>
 6     <ul 
 7         id="list" 
 8         style="float:left;
 9         list-style:none;"
10     >
11         <li><a href="#beijing">北京</a></li>
12         <li><a href="#shanghai">上海</a></li>
13         <li><a href="#shenzhen">深圳</a></li>
14         <li><a href="#guangzhou">廣州</a></li>
15         <li><a href="#tianjin">天津</a></li>
16     </ul>
17     <div 
18         id="content-main" 
19         style="margin-left:50px;
20         float:left;
21         width:220px;
22         border:1px solid #ccc;
23         height:120px;
24         color:#ff3300;"
25     >
26     </div>
27 </body>

 

(2),Js部分代碼

 

$(function(){
	_init() ;
}) ;
var _history = [] ; // 記錄hash的活動數據容器
function _init(){
	var root = $("#list") ;
	var defaultHash = root.find("li a").eq(1).attr("href") ;
	var currentHash = window.location.hash ;
	_addToHistory(defaultHash,true) ;
	if(currentHash && currentHash != defaultHash){
		_showContent((currentHash.split("#")[1])) ;
	}
	else{
		_showContent((defaultHash.split("#")[1])) ;
	}
	$("#list").on("click","a",function(e){
		var action = ($(this).attr("href").split("#")[1]) ;
		_showContent(action) ;
		e.preventDefault() ;
	}) ;
	window.addEventListener("popstate",function(e){
		if(e.state && e.state.hash){
			var hash = e.state.hash ;
			if(_history[1] && hash === _history[1].hash){//存在歷史記錄,證明是后退事件
				_showContent(hash.split("#")[1].toLowerCase()) ;
			}else{ // 其它認為是非法后退或者前進
				return ;
			}
		}
		else{
			return ;
		}
	},false) ;
} ;
function _showContent(action){
	var samePage = _history[0]["hash"] == "#" + action ;
	if(samePage){ // 同頁面,則不重新加載
		return ;
	}
	_loadContent(action + ".data").done(function(data){
		_renderContent(data["content"]) ;
		_addToHistory("#" + action,samePage) ;
	}).fail(function(){
		throw new Error("load content error !") ;
	}) ;	
} ;
function _loadContent(url){
	return $.ajax({
		url : url ,
		dataType : "json"
	}) ;
} ;
function _renderContent(text){
	$("#content-main").text(text) ;
} ;
function _addToHistory(hash,noState){
	var obj = {
		hash : hash
	} ;
	if(noState){
		_history.shift(obj) ;
		window.history.replaceState(obj,"",hash) ;
	}
	else{
		 window.history.pushState(obj,"",hash) ;
	}
	 _history.unshift(obj) ;
} ;

  

  

(四),最后總結

  (1),理解History Api的使用方式以及具體實例中使用的目的是為了解決哪些問題。

  (2),兩個核心Api的不同之處在哪。

  (3),測試本例子的注意事項如下。

  測試需要搭建一個web服務器,以http://host/的形式去訪問才能生效,如果你在本地測試以file://這樣的方式在瀏覽器打開,就會出現如下的問題:

Uncaught SecurityError: A history state object with URL 'file:///C:/xxx/xxx/xxx/xxx.html' cannot be created in a document with origin 'null'.

  因為你要pushState的url與當前頁面的url必須是同源的,而file://形式打開的頁面是沒有origin的,所以會報這個錯誤。

  

 

                   哈哈哈,本篇結束,未完待續,希望和大家多多交流夠溝通,共同進步。。。。。。呼呼呼……(*^__^*)       


免責聲明!

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



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