Fork me on GitHub

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

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

页面设计

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

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

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

<body>
    <div class="pageview" style="background: #3b76c0" id="-main-view">
        <h3>首页</h3>
        <div title="-list-view" class="right-arrow"></div>
    </div>
    <div class="pageview" style="background: #58c03b;display: none" id="-list-view">
        <h3>列表页面</h3>
        <div class="left-arrow"></div>
        <div title="-detail-view" class="right-arrow"></div>
    </div>
    <div class="pageview" style="background: #c03b25;display: none" id="-detail-view">
        <h3>列表详情页面</h3>
        <div class="left-arrow"></div>
    </div>
</body>

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

 

posted @ 2016-01-26 01:36  一像素  阅读(10103)  评论(5编辑  收藏  举报