您现在的位置是:网站首页> 编程资料编程资料
HTML5学习笔记之History API详解HTML5之pushstate、popstate操作history,无刷新改变当前urlHTML5 History API 实现无刷新跳转 HTML5 history新特性pushState、replaceState及两者的区别 深入探究HTML5的History API浅析HTML5中的 History 模式
2021-08-31
1171人已围观
简介 这系列文章主要是学习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"接口的详细方法:
interface History {
readonly attribute long length;
readonly attribute any state;
void go(optional long delta);
void back();
void forward();
void pushState(any data, DOMString title, optional DOMString? url = null);
void replaceState(any data, DOMString title, optional DOMString? url = null);
};
(二),重点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部分代码
bbSPA测试页面
style="margin-left:50px;
float:left;
width:220px;
border:1px solid #ccc;
height:120px;
color:#ff3300;"
>
(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的,所以会报这个错误。
以上就是本文的全部内容了,希望大家能够喜欢。
相关内容
- HTML5 Canvas绘制圆点虚线实例html5 canvas实现的圆点线条躲避小球类小游戏源码HTML5鼠标点击任意地方显示圆点动画特效HTML5+Canvas实现不规则的圆点连线动画特效源码
- HTML页面中添加Canvas标签示例HTML与XHTML、以及HTML4与HTML5标签之间的区别简介HTML5安全攻防之新标签攻击详解简单介绍HTML5中audio标签的使用详解HTML5中ol标签的用法详解HTML的style标签以及相关的CSS引用详解HTML的<input> 标签及其禁用方法HTML中Li标签的使用示例HTML5 video标签(播放器)学习笔记(二):播放控制常用HTML meta 标签属性(网站兼容与优化需要)HTML常用标签大全及html标签的特点
- HTML5 Canvas中绘制矩形实例html5实现点击弹出图片功能html5 录制mp3音频支持采样率和比特率设置html5表单的required属性使用html5调用摄像头实例代码HTML5页面音频自动播放的实现方式Html5大屏数据可视化开发的实现html实现弹窗的实例HTML5来实现本地文件读取和写入的实现方法HTML 罗盘式时钟的实现HTML5简单实现添加背景音乐的几种方法
- HTML5 Canvas中使用用路径描画圆弧详解canvas在圆弧周围绘制文本的两种写法
- HTML5 Canvas中使用路径描画二阶、三阶贝塞尔曲线使用canvas绘制贝塞尔曲线用html5的canvas画布绘制贝塞尔曲线完整代码canvas仿写贝塞尔曲线的示例代码
- HTML5制作酷炫音频播放器插件图文教程html5中audio支持音频格式的解决方法HTML5实现音频和视频嵌入的方法详解移动端HTML5音频与视频问题及解决方案HTML5中视频音频的使用详解HTML5自定义mp3播放器源码
- html5实现完美兼容各大浏览器的播放器HTML5 video标签(播放器)学习笔记(二):播放控制HTML5 video标签(播放器)学习笔记(一):使用入门HTML5制作酷炫音频播放器插件图文教程html5中 media(播放器)的api使用指南html5 自定义播放器核心代码html5 音乐播放器 audio 标签使用概述HTML5 MiranaVideo播放器 (代码开源) 从零实现一个自定义html5播放器的示例代码
- html5中 media(播放器)的api使用指南HTML5 video标签(播放器)学习笔记(二):播放控制HTML5 video标签(播放器)学习笔记(一):使用入门HTML5制作酷炫音频播放器插件图文教程html5实现完美兼容各大浏览器的播放器html5 自定义播放器核心代码html5 音乐播放器 audio 标签使用概述HTML5 MiranaVideo播放器 (代码开源) 从零实现一个自定义html5播放器的示例代码
- 用HTML5制作一个简单的弹力球游戏HTML5 Canvas的事件处理介绍HTML5 audio标签使用js进行播放控制实例HTML5全屏(Fullscreen)API详细介绍
- 用HTML5制作一个简单的桌球游戏的教程HTML5 audio标签使用js进行播放控制实例HTML5全屏(Fullscreen)API详细介绍HTML5 video播放器全屏(fullScreen)方法实例
