阅读 1796

Vue全栈开发之百度贴吧

这个百度贴吧的项目是 vue + koa + sequelize 的项目。

由于没有百度贴吧API接口,所以自己写了后端

项目部分截图(GIF)

项目的依赖以及准备工作

前端:vue + vuex + axios + better-scroll +iview + stylus (还有零散的依赖,完成某些小模块的,如 moment 完成项目内时间的需求)

前端依赖项

"dependencies": {
    "axios": "^0.19.0",
    "better-scroll": "^1.15.2",
    "iview": "^3.4.2",
    "js-cookie": "^2.2.0",
    "jsonwebtoken": "^8.5.1",
    "moment": "^2.24.0",
    "vue": "^2.5.2",
    "vue-photo-preview": "^1.1.3",
    "vue-router": "^3.0.1",
    "vuex": "^3.1.1"
  },
复制代码

后端:koa + koa-router + mysql2 + sequelize (这些是主要的,还有很多的中间件)

后端依赖项

"dependencies": {
    "bcrypt": "^3.0.6",
    "env2": "^2.2.2",
    "jsonwebtoken": "^8.5.1",
    "koa": "^2.7.0",
    "koa-body": "^4.1.0",
    "koa-bodyparser": "^4.2.1",
    "koa-jwt": "^3.5.1",
    "koa-router": "^7.4.0",
    "koa-session": "^5.12.0",
    "koa-static": "^5.0.0",
    "koa2-cors": "^2.0.6",
    "mysql2": "^1.6.5",
    "sequelize": "^5.8.12"
  },
复制代码

前端代码初始化是用来vue-cli3的脚手架。

图标是来自阿里巴巴矢量图标库,找到的图标尽量和百度贴吧一致

前端的UI框架选择了iview(选择有些失误,因为百度贴吧的项目是移动端的,应该采用像vant这类优秀的移动端UI框架会更合适)

准备工作是添加一些路径项 在build目录下的webpakc.base.conf.js文件中的alias选项中添加一些接下来项目中常用的路径

有几点要前面说一下

  1. 该项目的权限控制只采用了一个token,比较简单,但不是很安全。有兴趣可以看看权限控制
  2. 由于前后端分离写的代码,所以导致登录认证时设置的cookie 不能在前端取到(应该是域名访问的问题,取出来是undefined),所以只能将token信息传给前端,让前端自己设置cookie(权益之计,不建议采用)
  3. 没有API,也没写爬虫,所以数据都是手写的,数据量很少,所以一些效果无法实现。
  4. 最近看过的帖子和最近访问的吧, 这两个模块的数据是采用localStorage存数据,其它的数据均来自后端
  5. 因为后端写的不是很好,就不讲后端的内容了

项目启动

Tabbar

这是成品效果

效果

采用了vue-router 中 router-link to属性配置的效果

点击的该项会多出两个class属性

  1. router-link-exact-active (精确匹配规则,路由路径完全一致时会有)
  2. router-link-active (全包含匹配规则,也就是父路由也会有)

linkActiveClass: 'active'添加至router 配置中会将router-link-active 替换成active

这时就也可自定义active的样式了

页面结构

大体分为5个部分,和零散的几个页面,5个部分中其中4个(除info)分别对应4个tabbar选项,将页面划分开来。

info中有三个page,分别是userInfo,baInfo,tieInfo

路由与权限控制

路由将5个部分分开定义,最后汇总

因为该项目的登录认证对页面变化很大,所以在路由的beforeEach钩子函数中进行登录状态的判断,对必须登录才能访问的页面进行强制的登录判断,不通过则跳转到登录页。

router.beforeEach((to, from, next) => {
  // 一定需要登录的url 没有认证信息 进行登录
  if (routerLoginRole.some(route => to.path === route) && !Cookies.get('username')) {
    next('/login')
    return
  }
}
复制代码

必须登录的页面如下

export const routerLoginRole = [
  '/release',
  '/message',
  '/user',
  '/focuslist',
  '/fanslist',
  '/focusbalist',
  '/tielist',
  '/setting',
  '/userhome',
  '/useredit',
  '/browsehistory',
  '/collection',
  '/release',
  '/like'
]
复制代码

同时,不同的页面 tabbar显示和消失状态也不同,将tabbar的显示状态放入vuex 中,在beforeEach钩子函数中统一管理

if (TabbarRoutes.some(route => (to.path.indexOf(route) === 0))) {
    store.dispatch('hiddenTabbar')
  } else {
    store.dispatch('showTabbar')
  }
复制代码

需要隐藏tabbar的页面如下

export const TabbarRoutes = [
  '/login',
  '/register',
  '/search',
  '/focuslist',
  '/fanslist',
  '/focusbalist',
  '/tielist',
  '/setting',
  '/userhome',
  '/useredit',
  '/userinfo/',
  '/tieinfo/',
  '/bainfo/',
  '/browsehistory',
  '/release',
  '/collection',
  '/like'
]
复制代码

抽离基本配置以及插件

  • iview组件的引入方式采用按需引入,在utils目录下创建一个iview.js 将iview引入的代码进行统一管理。
import Vue from 'vue'
import {
  Button,
  Input,
  Switch,
  Progress,
  Form,
  FormItem,
  Icon,
  Upload,
  Dropdown,
  DropdownMenu,
  DropdownItem,
  Message,
  Spin
} from 'iview'
import 'iview/dist/styles/iview.css'

Vue.component('Button', Button)
Vue.component('i-input', Input)
Vue.component('i-switch', Switch)
Vue.component('Progress', Progress)
Vue.component('Form', Form)
Vue.component('FormItem', FormItem)
Vue.component('Icon', Icon)
Vue.component('Upload', Upload)
Vue.component('Dropdown', Dropdown)
Vue.component('DropdownMenu', DropdownMenu)
Vue.component('DropdownItem', DropdownItem)
Vue.component('Spin', Spin)

Vue.prototype.$Message = Message

export default Vue

复制代码
  • filter 全局过滤器,使用moment实现对时间的处理,数字的处理,统一进行管理

  • 对axios设置了拦截器,功能有三:

    1.设置axios请求的默认路径以及运行其携带cookie信息

    2.部分api接口需要登录验证 则需要传给服务器包括token的cookie凭证

    3.请求数据时的加载动画

axios.defaults.baseURL = 'http://192.168.1.4:3000/'
axios.defaults.withCredentials = true
axios.defaults.timeout = 5000

axios.interceptors.request.use(
  config => {
    // 给$http请求设置cookie请求头
    store.dispatch('showLoading')
    const token = Cookies.get('username')
    const isTokenRight = !!(token && JsonWebToken.decode(token))
    if (isTokenRight) {
      config.headers.common['Authorization'] = 'Bearer ' + token
    }
    return config
  },
  error => {
    Message.error('网络异常,请稍后再试')
    store.dispatch('hiddenLoading')
    return Promise.reject(error)
  }
)
axios.interceptors.response.use(
  response => {
    store.dispatch('hiddenLoading')
    if (response.data.statusCode !== 200) {
      Message.error(response.data.message)
      return Promise.reject(response)
    }
    return response
  },
  error => {
    Message.error('网络异常,请稍后再试')
    store.dispatch('hiddenLoading')
    return Promise.reject(error)
  }
)
复制代码

部分功能具体实现

首页刷新功能

效果图

分为两个阶段

  1. 首先是监听滚动的事件,滚动值超过某个值(个人设置500),触发事件将tabbar中的首页替换成刷新按钮。
  2. 点击刷新按钮,将vuex中的refreshData属性变为true。然后在首页中监听这个属性,重新加载数据并且触发better-scroll的滚动事件,让其滚动到最上方。

其中还是有些小问题的:

  1. tabbar是采用router-link, 会在其事件冒泡阶段阻止事件冒泡,进行其自身的路由跳转事件,从而无法触发自定义的事件,解决办法是在其内部处理掉点击事件(也就是点击事件冒泡到其渲染的元素之前处理掉点击事件,并阻止点击事件的冒泡)

tabbar页面中首页选项的html结构

<router-link tag="span"
             class="tabbar-item"
             to="/home">
  <div class="tabbar-item-icon icon-home"
       v-show="!this.$store.getters.isRefresh">
  </div>
  <div class="tabbar-item-icon icon-home refresh"
       v-show="this.$store.getters.isRefresh"
       @click.stop.prevent="refresh">
  </div>
  <span class="tabbar-item-label"
        v-show="!this.$store.getters.isRefresh">首页</span>
  <span class="tabbar-item-label refresh"
        v-show="this.$store.getters.isRefresh"
        @click.stop.prevent="refresh">刷新</span>
</router-link>
复制代码

其触发的刷新方法

refresh () {
  if (this.$store.getters.isRefresh) {
    this.$store.commit('updateRefreshData', true)
  }
},
复制代码
  1. 要避免多余的加载数据,所以采用了keep-alive标签,在触发better-scroll的scrollTo方法时,方法无效,具体原因不知,但后面发现自己的better-scroll的版本是基础型的,后面换成全能力滚动后,就可以正常使用了(有知道具体原因的朋友可以聊一下)

实现优质的左右滚动

效果图

html可分为两部分 顶部的三个tab 和 下面的三个页面

顶部的tab动画效果为css的transition: all 0.3s ease

页面采用了better-scroll,并在scrollEnd钩子函数中进行相关操作。

顶部的标记滑动事件

romve (index) {
      let name = 'message-title-' + index
      this.index = index
      this.oldX = -index * this.$refs['message-content'].offsetWidth
      this.$refs.unline.style.left = this.$refs[name].offsetLeft + 'px'
      this.contentScroll.scrollTo(-this.$refs['message-content'].offsetWidth * index, 0, 300)
    },
复制代码

左右滚动的初始化

    initScroll () {
      this.$nextTick(() => {
        if (!this.contentScroll) {
          this.contentScroll = new BScroll(this.$refs['message-content'], {
            startX: 0,
            click: true,
            tap: true,
            scrollX: true,
            scrollY: false,
            momentum: false // 不让其生成滚动的滑行动画 
          })
        } else {
          this.contentScroll.refresh()
        }
        this.contentScroll.on('scrollEnd', ({ x }) => {
          let width = this.$refs['message-content'].offsetWidth // 获取单个页面的宽度
          if (x !== -width && x !== -2 * width && x !== 0) { // 避免自动滚动后继续滚动
            if (Math.abs(x - this.oldX) < width / 4) { // 滚动量小于整个页面的1/4时 自动复原
              this.contentScroll.scrollTo(-this.index * width, 0, 300)
            } else if (this.oldX > x) { // 向左滑动时 自动滚到到右边页面
              this.contentScroll.scrollTo(-(++this.index) * width, 0, 300)
            } else { // 向右滑动时 自动滚到到左边页面
              this.contentScroll.scrollTo(-(--this.index) * width, 0, 300)
            }
            this.oldX = -this.index * width // 重新计算值
            this.romve(this.index) // 使顶部的标记滑动到对应的位置
          }
        })
        this.romve(0) // 顶部的标记初始化到第一个
      })
    }
复制代码

页面布局

  • html方面
    • 主要采用div,span,img,p 等标签
  • css方面
    • 选择器采用的class选择器
    • 布局主要采用 flex 布局
    • z-index的层级上是 1-9 ,文字层级低,动画蒙版等层级略高。
    • icon图标的定义是采用了background 的形式
background-size: 30px 30px
background-repeat: no-repeat
background-position: center center
background-image: url('../../assets/icon/left.png')
复制代码

要注意的问题:

  1. z-index的层级问题,子元素会继承父元素的层级。
  2. 设置了层级,还是会出现下层元素上浮的问题,有可能是上层元素是透明的,添加背景颜色就可以。
  3. 应减少使用js的setInterval形成的帧动画,而应该采用css形成的补间动画。

结语

各个页面的小功能写的不多,但很多模块难度问题不大,没有详细写的必要,具体可看源码。

整个项目写下来,也有不少的问题。主要还是整体性上有欠缺,组件化不够彻底。UI风格上还是没办法和百度贴吧一致(有一定的偏差)。

如果你喜欢这篇文章或者可以帮到你,给作者一点鼓励,点个赞在走吧!同时也非常希望看到这篇文章的你能发表一点见解!

前端源码 后端源码

关注下面的标签,发现更多相似文章
评论