快速构建H5单页面切换应用

在Web App和Hybrid App横行的时代，为了拥有更好的用户体验，单页面应用顺势而生，单页面应用简称`SPA`，即Single Page Application，就是只有一个HTML页面的应用程序，应用中所有的视图都包含在这个HTML页面中，并通过JavaScript控制相关视图的显示和隐藏，这种模式可以让用户在Web App感受Native App的速度和流畅。本篇文章的目的就是教你如何来快速的构建一个H5单页面切换骨架。

页面设计

在构建SPA应用时，首先要确定你的应用需要包含哪些视图，在这里，为了能够说明问题，我们只需要构建三个视图，即 首页、列表页面和列表详情页面。 这三个页面的逻辑关系是：

• 程序启动，默认进入首页
• 点击首页的按钮切换到列表页面
• 点击列表页面的按钮切换到列表详情页面
• 点击返回按钮或物理返回键能够回到上一页。

首先我们来看一下核心的HTML代码：

    

        
首页
        

    
    

        
列表页面
        

        

    
    

        
列表详情页面
        

    

class=`pageview`的div容器所包含的就是一个独立的视图页面，在body中共有3个这样的div，需要注意的是，第2、3个div都设置了style=`display:none`,唯独第1个视图没有设置，这样做的目的就是让程序启动时默认显示首页。

在这段代码中，用一个通用的CSS类来描述每一个视图的样式以及切换效果，这个类就是`pageview`, 我们先看看pageview是如何定义的：

.pageview{
   position: absolute;
   left: 0;
   top:0;
   width: 100%;
   height: 100%;
   overflow: hidden;
   -webkit-transition: 0.4s ease-out -webkit-transform;
}

在这里，视图页面需要设置成绝对定位，并且和父容器等宽等高，这样视图才能够平滑的进行切换，另外还需要设置页面切换的过渡效果，我们使用CSS3的transition属性, 具体的参数就不在这里做过多的讲解了，大家应该都明白的。这个样式类所产生的效果是：当改变-webkit-transform的值时，页面会以样式中定义的过渡效果进行平移，持续时间是0.4s. 到此为止，主要的页面设计已经完成了。

逻辑控制

要实现页面切换，就要控制两个页面同时平移，即当前页面不断的离开屏幕，新的页面不断的进入屏幕。为了方便描述，我们把原来的页面叫做`currentView`，把新的页面叫做`applyView`,即申请进入的视图。如果用transform来描述的话，currentView 需要从原来的0% 平移到-100%，即页面向左平移了一个页面宽度的距离，与此同时，appyView需要从原来的100% 平移到0%，刚好占领currentView原来的位置，当然在平移之前，我们需要设置好currentView和applyView的初始位置，分别需要设置成0%和100%。

// 页面向左平移
var currentViewStart = "translateX(0%)", // currentView初始位置
   applyViewStart = "translateX(100%)", // applyView初始位置
   currentViewEnd = "translateX(-100%)",// currentView的最终位置
   applyViewEnd = "translateX(0%)";     // applyView最终位置

// 页面向右平移
if (direction == "right") {
   currentViewStart = "translateX(0%)";
   applyViewStart = "translateX(-100%)";
   currentViewEnd = "translateX(100%)";
   applyViewEnd = "translateX(0%)"
}

我们知道，通过JS操作就需要获取页面的DOM对象，为了减少DOM的查询，在页面加载时，我们将所有需要用到的页面对象一次性查询出来，并以键值对的形式存储到Map对象中，当需要使用时，只需要根据key来获取即可。

//初始化执行
initViewPool:function(){
   var views = document.querySelectorAll(".pageview");
   // 通过call使用数组的forEach来遍历NodeList
   Array.prototype.forEach.call(views,function(item){
       // viewPool是一个全局对象
       viewPool[item.id] = item; // 将DOM的id作为键
   });
}

下面我们将通过JS来控制页面的切换效果：

// 获取当前页面的DOM对象
var currentView = viewPool[currentViewId];
// 获取新页面的DOM对象
var applyView = viewPool[pageId];

// 设置新页面的初始位置
applyView.style.webkitTransform = applyViewStart;
// 设置当前页面的初始位置
currentView.style.webkitTransform = currentViewStart;

// 设置新页面显示
applyView.style.display = "";

var t1 = setTimeout(function() {
   // 当设置最终位置时，页面就会以过渡效果平移到最终位置
   applyView.style.webkitTransform = applyViewEnd;
   currentView.style.webkitTransform = currentViewEnd;
},200);

var t2 = setTimeout(function() {

   // 400ms后，页面平移结束，设置currentView为隐藏
   currentView.style.display = "none";
   // 将新页面设置为当前页面
   currentViewId = pageId;

   if (direction === 'left') {
       window.location.hash = currentViewId.substring(1);
   }
   
   window.clearTimeout(t1);
   window.clearTimeout(t2);
},600);

在这里有一个重要的操作就是：一定要将设置最终位置的操作放到定时器中，即t1, 这是因为当页面被设置了初始位置后，需要一定的时间来`渲染`这个样式，第2个定时器是为了等待动画执行完毕后进行相关的操作，比如设置当前页面,设置hash,清除定时器等。当这段代码被执行时，页面就会以设定的效果进行平滑的移动，最终，当前页面被隐藏，新页面被设置为当前页面显示到屏幕中央，这样就完成了一次单页面切换效果。

支持物理键返回

既然是单页面切换，就不得不提另外一个问题，那就是物理返回键操作。其实，单页面切换只是页面的显示和隐藏操作，仅此而已，并不是真正意义上的hash跳转，而物理键返回实际上是监听浏览器的hash变化，因此为了让单页面能够支持物理键返回操作，我们需要模拟浏览器的hash变化，即当一个新页面进入时，给当前地址加上一个#hash 的标识，当点击物理返回键的时候，这个hash值会发生变化(回退到上一个hash)，与此同时也会触发一个hashchange事件，当监听到hash变化时，我们就通过JS切换到上一个hash对应的页面，这样就实现了物理返回键的效果。

if (direction === 'left'){
   //当进入到新页面时，设置当前hash的值为当前页面的id
   window.location.hash = currentViewId.substring(1);
}

监听hash变化的处理：

var that = this;
window.addEventListener("hashchange", function () {

   //当点击返回键时，hash会回退到上一页的hash值
   //获取上一页的hash值，并转化为对应view的id
   var id = window.location.hash.replace("#", "-");

   // 判断当前页面不是首页，
   // 并且触发的浏览器的`back`操作，即点击返回键，因为页面前进的时候也会发生hash变化
   if (currentViewId != "-main-view" && id != currentViewId) {
       id = id || "-main-view"; //如果上一页是首页，则hash为空，这时需要补上对应的id
       //调用forward方法从当前页面切换到上一页
       that.forward(id, "right");
   }
}, false);

以上便是单页面切换的基本思路，对应的完整示例代码已上传至 Github: https://github.com/git-onepixel/h5spa, 你可以下载完整代码进行调试和学习，如果需要查看效果演示，请点击或使用微信扫一扫下面的二维码进行访问：

 

 

原创发布 @一像素  2016.01