项目架构

项目目录

├── build
├── config
├── dist
│   └── static
│       ├── css
│       ├── fonts
│       ├── images
│       ├── js
│       └── lib
├── src
│   ├── api
│   ├── assets
│   │   ├── global
│   │   └── images
│   │       └── footer
│   ├── components
│   │   ├── common
│   │   ├── news
│   │   └── profile
│   │       └── charge
│   ├── config
│   ├── mixin
│   ├── router
│   ├── service
│   ├── store
│   └── util
└── static
    ├── images
    └── lib 

项目目录是采用 vue-cli 自动生成,其它按需自己新建就好了。

开发实践

动态修改 document title

在不同的路由页面,我们需要动态的修改文档标题,可以将每个页面的标题配置在路由元信息 meta 里面带上,然后在 router.afterEach 钩子函数中修改:

import Vue from 'vue';
import Router from 'vue-router';

Vue.use(Router);
const router = new Router({
  mode: 'history',
  routes: [
    { path: '/', component: Index, meta: { title: '推荐产品得丰厚奖金' } },
    {
      path: '/news',
      component: News,
      meta: { title: '公告列表' },
      children: [
        { path: '', redirect: 'list' },
        { path: 'list', component: NewsList },
        { path: 'detail/:newsId', component: NewsDetail, meta: { title: '公告详情' } }
      ]
    },
    {
      path: '/guide',
      component: GuideProtocol,
      meta: {
        title: '新手指南'
      }
    }
  ]
});

// 使用 afterEach 钩子函数,保证路由已经跳转成功之后修改 title
router.afterEach((route) => {
  let documentTitle = 'xxx商城会员平台';
  route.matched.forEach((path) => {
    if (path.meta.title) {
      documentTitle += ` - ${path.meta.title}`;
    }
  });

  document.title = documentTitle;
});

根据 URL 的变化,动态更新数据

通常在一个列表集合页,我们需要做分页操作,同时分页数据需要体现在 URL 中,那么如何动态的根据 URL 的变动来动态的获取数据呢,我们可以使用 watch API,在 watch 里面监听 $route,同时使用 this.$router.replace API 来改变 URL 的值。下面是示例代码 common.js


import qs from 'qs';

export default {
  data() {
    return {
      queryParams: {
        currentPage: 1,
        pageSize: 10
      }
    };
  },
  methods: {
    handlePageNoChange(e) {
      this.queryParams.currentPage = e;
      this.replaceRouter();
    },

    replaceRouter() {
      const query = qs.stringify(this.queryParams);
      this.$router.replace(`${location.pathname}?${query}`);
    },

    routeChange() {
      this.assignParams();
      this.fetchData();
    },

    assignParams() {
      this.queryParams = Object.assign({}, this.queryParams, this.$route.query);
    }
  },
  mounted() {
    this.assignParams();
    this.fetchData();
  },
  watch: {
    $route: 'routeChange'
  }
};

我们将这部分代码抽取到一个公共的 mixin 中,在需要的组件那里引入它,同时实现自定义的同名 fetchData() 方法
mixin API 文档:https://cn.vuejs.org/v2/guide...

export default DemoComponent {
  mixins: [common],
  data() {
    return {
      // 组件内部自定义同名查询参数,将会和 mixin 中的默认参数合并
      queryParams: {
        categoryId: '',
        pageSize: 12
      },
    }
  },
  methods: {
    fetchData() {
       // 发送请求
    }
  }
}

Event Bus 使用场景

我们在项目中引入了 vuex ,通常情况下是不需要使用 event bus 的,但是有一种情况下我们需要使用它,那就是在路由钩子函数内部的时,在项目中,我们需要在 beforeEnter 路由钩子里面对外抛出事件,在这个钩子函数中我们无法去到 this 对象。

beforeEnter: (to, from, next) => {
    const userInfo = localStorage.getItem(userFlag);
    if (isPrivateMode()) {
        EventBus.$emit('get-localdata-error');
        next(false);
        return;
    }
})

App.vuemouted 方法中监听这个事件

EventBus.$on('get-localdata-error', () => {
    this.$alert('请勿使用无痕模式浏览');
});

自定义指令实现埋点数据统计

在项目中通常需要做数据埋点,这个时候,使用自定义指令将会变非常简单

在项目入口文件 main.js 中配置我们的自定义指令

// 坑位埋点指令
Vue.directive('stat', {
  bind(el, binding) {
    el.addEventListener('click', () => {
      const data = binding.value;
      let prefix = 'store';
      if (OS.isAndroid || OS.isPhone) {
        prefix = 'mall';
      }
      analytics.request({
        ty: `${prefix}_${data.type}`,
        dc: data.desc || ''
      }, 'n');
    }, false);
  }
});

使用路由拦截统计页面级别的 PV

由于第一次在单页应用中尝试数据埋点,在项目上线一个星期之后,数据统计后台发现,首页的 PV 远远高于其它页面,数据很不正常。后来跟数据后台的人沟通询问他们的埋点统计原理之后,才发现其中的问题所在。

传统应用,一般都在页面加载的时候,会有一个异步的 js 加载,就像百度的统计代码类似,所以我们每个页面的加载的时候,都会统计到数据;然而在单页应用,页面加载初始化只有一次,所以其它页面的统计数据需要我们自己手动上报

解决方案

使用 vue-routerbeforeEach 或者 afterEach 钩子上报数据,具体使用哪个最好是根据业务逻辑来选择。

const analyticsRequest = (to, from) => {
  // 只统计页面跳转数据,不统计当前页 query 不同的数据
  // 所以这里只使用了 path, 如果需要统计 query 的,可以使用 to.fullPath
  if (to.path !== from.path) {
    analytics.request({
      url: `${location.protocol}//${location.host}${to.path}`
    });
  }
};

router.beforeEach((to, from, next) => {
  if (to.matched.some(record => record.meta.requiresAuth)) {
    // 这里做登录等前置逻辑判断
    // 判断通过之后,再上报数据
    ...
    analyticsRequest(to, from);
  } else {
    // 不需要判断的,直接上报数据
    analyticsRequest(to, from);
    next();
  }
});

在组件中使用我们的自定义指令

使用过滤器实现展示信息格式化

如下图中奖金数据信息,我们需要将后台返回的奖金格式化为带两位小数点的格式,同时,如果返回的金额是区间类型,需要额外加上 <span style="color:red;font-weight: bold;">起</span> 字和 <span style="color:red;font-weight: bold;">¥</span> 金额符号

在入口文件 main.js 中配置我们自定义的过滤器

Vue.filter('money', (value, config = { unit: '¥', fixed: 2 }) => {
  const moneyStr = `${value}`;
  if (moneyStr.indexOf('-') > -1) {
    const scope = moneyStr.split('-');
    return `${config.unit}${parseFloat(scope[0]).toFixed(config.fixed).toString()} 起`;
  } else if (value === 0) {
    return value;
  }

  return `${config.unit}${parseFloat(moneyStr).toFixed(config.fixed).toString()}`;
});

在组件中使用:

<p class="price">{{detail.priceScope | money}}</p>
<div :class="{singleWrapper: isMobile}">
    <p class="rate">比率:{{detail.commissionRateScope}}%</p>
    <p class="income">奖金:{{detail.expectedIncome | money}}</p>
</div>

axios 使用配置

在项目中,我们使用了 axios 做接口请求

在项目中全局配置 /api/common.js

import axios from 'axios';
import qs from 'qs';
import store from '../store';

// 全局默认配置
// 设置 POST 请求头
axios.defaults.headers.post['Content-Type'] = 'application/x-www-form-urlencoded';
// 配置 CORS 跨域
axios.defaults.withCredentials = true;
axios.defaults.crossDomain = true;

// 请求发起前拦截器
axios.interceptors.request.use((config) => {
  // 全局 loading 状态,触发 loading 效果
  store.dispatch('updateLoadingStatus', {
    isLoading: true
  });
  
  // POST 请求参数处理成 axios post 方法所需的格式
  if (config.method === 'post') {
    config.data = qs.stringify(config.data);
  }
  
  // 这句不能省,不然后面的请求就无法成功发起,因为读不到配置参数
  return config;
}, () => {
  // 异常处理
  store.dispatch('updateLoadingStatus', {
    isLoading: false
  });
});

// 响应拦截
axios.interceptors.response.use((response) => {
  // 关闭 loading 效果
  store.dispatch('updateLoadingStatus', {
    isLoading: false
  });

  // 全局登录过滤,如果没有登录,直接跳转到登录 URL
  if (response.data.code === 300) {
    // 未登录
    window.location.href = getLoginUrl();
    return false;
  }

  // 这里返回的 response.data 是被 axios 包装过的一成,所以在这里抽取出来
  return response.data;
}, (error) => {
  store.dispatch('updateLoadingStatus', {
    isLoading: false
  });
  return Promise.reject(error);
});

// 导出
export default axios;

然后我们在接口中使用就方便很多了 /api/xxx.js

import axios from './common';

const baseURL = '/api/profile';
const USER_BASE_INFO = `${baseURL}/getUserBaseInfo.json`;
const UPDATE_USER_INFO = `${baseURL}/saveUserInfo.json`;

// 更新用户实名认证信息
const updateUserInfo = userinfo => axios.post(UPDATE_USER_INFO, userinfo);

// 获取用户基础信息
const getUserBaseInfo = () => axios.get(USER_BASE_INFO);

vuex 状态在响应式页面中的妙用

由于项目是响应式页面,PC 端和移动端在表现成有很多不一致的地方,有时候单单通过 CSS 无法实现交互,这个时候,我们的 vuex 状态就派上用场了,

我们一开始在 App.vue 里面监听了页面的 resize 事件,动态的更新 vuex 里面 isMobile 的状态值

window.onresize = throttle(() => {
 this.updatePlatformStatus({
   isMobile: isMobile()
 });
}, 500);

然后,我们在组件层,就能响应式的渲染不同的 dom 结构了。其中最常见的是 PC 端和移动端加载的图片需要不同的规格的,这个时候我们可以这个做

methods: {
  loadImgAssets(name, suffix = '.jpg') {
    return require(`../assets/images/${name}${this.isMobile ? '-mobile' : ''}${suffix}`);
  },
}

<img class="feed-back" :src="loadImgAssets('feed-back')"

<img v-lazy="{src: isMobile ? detail.imgUrlMobile : detail.imgUrlPc, loading: placeholder}">

// 动态渲染不同规格的 dislog
<el-dialog :visible.sync="dialogVisible" :size="isMobile ? 'full' : 'tiny'" top="30%" custom-class="unCertification-dialog">
</el-dialog>

下图分别是 PC 端和移动短的表现形式,然后配合 CSS 媒体查询实现各种布局

开发相关配置

反向代理

在项目目录的 config 文件下面的 index.js 配置我们的本地反向代理和端口信息

dev: {
  env: require('./dev.env'),
  port: 80,
  autoOpenBrowser: true,
  assetsSubDirectory: 'static',
  assetsPublicPath: '/',
  proxyTable: {
    '/api/profile': {
      target: '[真实接口地址]:[端口号]', // 例如: http://api.xxx.com
      changeOrigin: true,
      pathRewrite: {
        '^/api/profile': '/profile'
      }
    }
    ...
  },

然后我们调用接口的形式就会变成如下映射,当我们调用 /api/profile/xxxx 的时候,其实是调用了 [真实接口地址]/profile/xxxx

/api/profile/xxxx => [真实接口地址]/profile/xxxx

nginx 配置

upstream api.xxx.com
{
 #ip_hash;
  server [接口服务器 ip 地址]:[端口];
}

server {
  ...
  location ^~ /api/profile {
    index index.php index.html index.html;
    proxy_redirect off;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_pass http://api.xxx.com;
    
    rewrite ^/api/profile/(.*)$ /profile/$1 break;
  }
  ...
}

线上部署

如果路由使用的是 history 模式的话,需要在 nginx 里面配置将所有的请求到转发到 index.html

nginx.conf 或者对应的站点 vhost 文件下面配置

location / {
    try_files $uri $uri/ /index.html;
}

优化

开启静态资源长缓存

location ~ .*\.(gif|jpg|jpeg|png|bmp|swf|woff|ttf|eot|svg)$ {
    expires 1y;
}

location ~ .*\.(js|css)$ {
    expires 1y;
}

开启静态资源 gzip 压缩

// 找到 nginx.conf 配置文件
vim /data/nginx/conf/nginx.conf

gzip on;
gzip_min_length  1k;
gzip_buffers     4 8k;
gzip_http_version 1.1;
gzip_types text/plain application/javascript application/x-javascript text/javascript text/xml text/css;

开启了 gzip 压缩之后,页面资源请求大小将大大减小,如下图所示,表示已经开启了 gzip 压缩

Q&A

文章到这就结束了,如果有遗漏或者错误的地方,欢迎私信指出。
希望这篇文章能带给大家一丝丝收获。

如果觉得我的文章对你有用,请随意赞赏

你可能感兴趣的文章

24 条评论
零零落落 · 9月8日

有github项目地址吗?

+4 回复

1

没有哦,这个是公司内部项目,所以只能分享下开发过程中的一些问题

离尘不理人 作者 · 9月8日
0

再来点实用点库 嘻嘻

zygsf · 9月8日
蛋先生 · 9月8日

学习了 这是个很系统很全面的项目经验介绍 不管学会多少种新的框架 最终还是要落实到项目上 而一个项目的好坏 不在于框架的选择 只在于对细节的处理

+2 回复

1

扎心了,老铁

离尘不理人 作者 · 9月8日
xcy161106 · 9月9日

想问下。我有一个公告轮播没获取数据是好的。获取数据后就不起作用了。

+2 回复

1

@xcy161106 什么意思,没明白你的需求

离尘不理人 作者 · 9月9日
0

就是用swiper写的一个轮播图。轮播的内容是文本,是从后台获取的的。但是轮播不起作用。

xcy161106 · 9月9日
1

@离尘不理人 没获取数据前轮播是没问题的。

xcy161106 · 9月9日
陌上寒 · 9月11日

这是demo还是项目?

+2 回复

0

项目

离尘不理人 作者 · 9月11日
1

这项目能交付吗?ui是不是有点寒碜?

陌上寒 · 9月11日
0

@陌上寒 设计师拿着刀正在赶来的路上

离尘不理人 作者 · 9月11日
L_Chris · 9月12日

说实话,文中提到相当一部分都不是很好的做法

  1. title一般在afterEach钩子里面修改,因为beforeEach里通常作权限,登录等验证跳转

  2. axios的拦截器里不适合作跳转,因为会有未登录就进行跳转的情况(跳转前未完成请求), 是否登录通常在beforeEach里判断,就不会有上述问题

  3. 分页的做法也不太赞成,用户刷新页面的情况你有考虑?

  4. axios中使用了store.dispatch(action),而updateLoadingStatus看起来并不是一个异步方法,不合规范,应该用store.commit(mutation)

  5. 怎么会在resize事件中判断平台呢?直接新增一个getters不就行了吗?

+2 回复

0

谢谢指出,你上面提到的这几点,我会在我的项目中去优化,不过其中的 2,3 点你说的问题,我项目中都有考虑的,这里只是没有指出来,毕竟这篇文章只是总结下大概的实践,更多的是要结合项目实际考虑。

离尘不理人 作者 · 9月12日
songusepython · 9月11日

你好楼主,非常感谢! 我想请问一下,你实现响应式布局,css使用了scope吗?是在scope的style标签中使用@media查询还实现的吗?还是监听设备,然后动态切换路由,切换至写有不同样式组件?或者是不使用scope然后切换不同的css文件?求解答

回复

0

大部分是 media,在 CSS 不改变 DOM 结构的情况下才会使用 state 中的设备判断来切换显示不同的 dom,样式文件不使用 scope,都是在命名的时候约束好

离尘不理人 作者 · 9月11日
0

@离尘不理人 额,为什么不使用呢?有什么特别的理由吗?scope不是很完美的避免了命名冲突吗?即使自己命名空间失策了,也不会有bug出现

songusepython · 9月11日
1

因为需要全局把控,一些全局样式什么的,如果加了 scope ,作用优先级就不一样了

离尘不理人 作者 · 9月11日
xcy161106 · 9月11日

楼主埋点能稍微详细解释下吗。怎么埋。埋在什么地方。以前没做过现在项目需要。

回复

0

文章中给出的部分代码中,已经解释了怎么埋点,所谓的埋点,就是你你的页面上需要点击的地方,或者页面刚加载的时候,发送一个特殊的请求,而这个请求是通过将请求 URL 赋值给一个 js 动态生成的一个 image 对象里面,这方面的资料你可以具体搜索查看下就清楚了

离尘不理人 作者 · 9月11日
1

image 对象的 src 属性

离尘不理人 作者 · 9月11日
载入中...
离尘不理人 离尘不理人

1.2k 声望

发布于专栏

前沿开发团队

Make the world be a better place by coding!

547 人关注