使用vue制作FullPage页面

前言

已经有好久没有更新博客了，大三下了要准备找实习了，才发现自己很多东西都不会，所以赶紧找了个现在流行的 MVVM 框架学习一下。我学习的是 Vue，所以拿 Vue 写了一个 FullPage 的模板，可以供自己和其他人使用。

项目的地址是：https://github.com/kainstar/vue-fullpage

演示效果在这里

项目讲解

为了加深理解，我把我制作这个 FullPage 页面的思路和流程记录下来，也可以给其他和我一样的初学者一个参考。

分解思路

首先，我根据 Vue 的组件开发思想，把这个 FullPage 页面分为两个主要的组件模块：页面组件（Page）和页面控制组件（PageController）。除了这两个组件模块之外，还有一个整合的 App.vue 文件。

其中，Page 组件主要负责每个 FullPage 页面的样式和位置控制，而 PageController 组件则用来发起页面的切换请求。

因为 Vue 是单向数据流形式的，因此将所有需要的数据都定义在 App.vue 文件中，由 App 组件向下传递数据。

数据需求分析

要制作一个 FullPage 页面，每个 Page 页面需要的是页面自身的内容（页面的内容和样式配置），而控制器所需要的数据有当前正在显示的页面以及总的页面数，用这两个属性计算出其他需要的属性。

其中，总页面数即是 Page 总数，有多少个 Page，就有多少个 Page 的配置，因此可以通过计算 Page 配置信息对象的数量来获得总页面数。

我在 App.vue 的组件 data 中定义了两个属性：

  • currentPage 表示的是当前页面的序号（从 1 开始计算）；
  • options 是一个数组，其中的每一个对象表示的是对应序号的页面的配置信息，可以通过修改里面的对象属性从而改变对应 Page 的样式。

Page 组件只需要知道当前页面是第几个页面和自身的配置，因此只含有两个属性：

  • currentPage
  • option 表示自身的配置

PageController 需要对页面进行切换控制，因此需要两个属性：

  • currentPage
  • pageNum 表示总的页面数量

编写页面样式

App 组件的结构为：

1
2
3
4
5
6
7
8
9
10
11
<div id="app" class="app">
  <!-- page为单独的页面组件，page内可以编写任意的页面内容 -->
  <page :currentPage="currentPage"></page>
  <!-- page-controller为控制器组件 -->
  <page-controller
    :pageNum="pageNum"
    :currentPage="currentPage"
    @changePage="changePage"
    :arrowsType="arrowsType"
  ></page-controller>
</div>

App 组件主要样式：

1
2
3
4
5
6
7
8
9
10
11
12
13
/* 页面宽高为100%，overflow为hidden隐藏溢出部分 */
html,
body {
  margin: 0;
  padding: 0;
  height: 100%;
  width: 100%;
  overflow: hidden;
}
.app {
  height: 100%;
  width: 100%;
}

Page 组件结构为：

1
2
3
4
5
6
7
8
9
10
11
<section
  class="page"
  v-if="options"
  :style="{background:options.background,color:options.color||'#fff'}"
  :class="{'page-before': options.index < currentPage,'page-after': options.index > currentPage}"
>
  <div :class="{'page-center': options.isCenter}">
    <slot></slot>
  </div>
</section>
<section class="page" v-else>页面正在渲染中。。。</section>

其中 slot 内为在 App.vue 的 page 标签内编写的 html 内容，并且根据 Page 组件内的 option 属性，为 Page 页面添加不同的样式（包括背景颜色、字体颜色、居中等，而且可以自由扩展）

Page 组件的主要样式为：

1
2
3
4
5
6
7
8
9
10
11
12
.page {
  position: absolute;
  width: 100%;
  height: 100%;
  transition: all 0.5s ease 0s;
}
.page-before {
  transform: translate3d(0, -100%, 0);
}
.page-after {
  transform: translate3d(0, 100%, 0);
}

通过比较当前页面的 index 与 currentPage 的大小，可以判断 Page 组件处于之前的页面，当前的页面和之后的页面三个状态中的哪一种。

将所有页面都用 absolute 定位在同一个位置上，对于处于之前的页面的 Page，添加 page-before 类标签，使其在 Y 轴上向上偏移自身高度距离，同理，对之后的页面做 Y 轴上向下的自身高度偏移。

在 page 标签上添加 transition 样式，使其在切换时可以产生动画效果。

PageController 组件的结构为：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
<nav class="controller">
  <button
    v-if="arrowsType != 'no'"
    class="prev-btn"
    :class="{moving:arrowsType === 'animate'}"
    @click="changePage(prevIndex)"
  ></button>
  <ul>
    <li
      @click="changePage(index)"
      v-for="index in pageNum"
      :key="'controller-'+index"
      class="controller-item"
    ></li>
  </ul>
  <button
    v-if="arrowsType != 'no'"
    class="next-btn"
    :class="{moving:arrowsType === 'animate'}"
    @click="changePage(nextIndex)"
  ></button>
</nav>

PageController 组件中分为两块，控制上下滚动的上下箭头按钮和控制所有页面的 ul 列表。

因为 PageController 中的样式较多，因此不在文章中详细说明，只做简单介绍。

button 和 ul 标签用 fixed 定位，使其处于整个页面的上方、下方和右侧。

button 使用 rotate 和 border 属性，制作出箭头的样式，并添加对应的动画效果（可以通过传递 props 选择关闭）。

编写页面逻辑

切换页面逻辑

因为所有的页面切换都是由 PageController 发起，而控制 currentPage 的组件并不是 PageController，所以需要有一个父子组件事件，由子组件 PageController 发起，传递一个参数表示要切换到第几个页面，因此在 PageController 中定义一个 method：

1
2
3
changePage (index) {
	this.$emit('changePage', index);
}

父组件接受该事件并调用自己定义的 changePage 方法，修改自身的 currentPage 属性

1
2
3
4
changePage (index) {
	// 改变page
	this.currentPage = index;
}

箭头按钮上下滚动

为了实现上下滚动，需要知道当前页面的前一个页面和后一个页面分别是第几个页面，因此可以使用计算属性，计算出前一个和后一个页面的 index 值：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
// PageController.vue
nextIndex () {
	if (this.currentPage === this.pageNum) {
		return 1;
	} else {
		return this.currentPage + 1;
	}
},
prevIndex () {
	if (this.currentPage === 1) {
		return this.pageNum;
	} else {
		return this.currentPage - 1;
	}
}

在点击箭头时，将对应的 nextIndex 或 prevIndex 值当做参数传给 changePage 方法。

滚轮滚动和移动端滚动

滚轮滚动和移动端滚动主要依靠 window 的监听事件，根据传入的 event 属性，计算出页面是应该向上还是向下滚动，将需要滚动的方向作为参数传递给处理函数 handler。

因为代码略长，因此不全部显示在文章中，只显示处理函数相关逻辑

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
let _this = this;
let timer = null;
function scrollHandler(direction) {
  // 防止重复触发滚动事件
  if (timer != null) {
    return;
  }
  if (direction === "down") {
    _this.changePage(_this.nextIndex);
  } else {
    _this.changePage(_this.prevIndex);
  }
  timer = setTimeout(function () {
    clearTimeout(timer);
    timer = null;
  }, 500);
}

需要注意的一点是，移动端做滚动判断时，要求 touches 和 changedTouches 之间需要一定的间隔，不然容易误触发滚动事件。

options 属性的分发

为了使使用者更加方便地编写页面内容而不在意具体的页面序号，我采用了自动对 page 内的 option 赋值的方法。其实现原理是在 App.vue 文件中，使用钩子函数 mounted，对 page 中的 option 属性进行设置。

1
2
3
4
5
6
7
8
9
10
mounted () {
	this.$children.forEach((child, index) => {
		// 动态设置各个page内的options
		if (child.option === null) {
			let childOption = this.options[index];
			this.$set(childOption,'index',index+1);
			child.option = childOption;
		}
	});
}

高级属性：新的钩子函数

为了满足部分使用者的需求，我在设置了两个钩子函数：beforeLeave 和 afterEnter。

这两个钩子函数可以设置在对应页面的 options 属性对象中，并且含有一个默认的参数，为对应页面的 page 组件实例对象。

其实现方式为在原先的 changePage 函数（App.vue）内添加新的逻辑：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
changePage (index) {
	// beforeLeave
	let beforeIndex = this.currentPage - 1;
	let leaveFunction = this.options[beforeIndex].beforeLeave;
	typeof leaveFunction === 'function' && leaveFunction.call(this,this.$children[beforeIndex]);
	// 改变page
	this.currentPage = index;
	// afterEnter
	let nextIndex = index-1;
	let enterFunction = this.options[nextIndex].afterEnter;
	this.$nextTick(function () {
		typeof enterFunction === 'function' && enterFunction.call(this,this.$children[nextIndex]);
	})
}

总结

这篇文章记录了我开发一个 FullPage 页面的总体流程，将主要的逻辑重新顺理了一遍，还有一些小的细节没有写在文章中，有兴趣的可以去具体的项目页面看源码，当然您要是觉得写得还可以，希望给个 star(^__^) ，如果您有什么想法，欢迎给我留言或加我的 QQ 私聊。

技思
#vue #fullpage
使用vue制作FullPage页面
https://kainstar.github.io/archives/2017/04/05/使用vue制作fullpage页面/
作者
KainStar
发布于
2017年4月5日
许可协议