nuxt.js 是什么?
如果你正在准备开发一个SEO友好的新项目,而且准备用 vue 开发,那么恭喜你,用 nuxt 是一个成本和效率都比较优秀的方案。
知识中心案例
简单介绍下背景,这是一个专门为氚云低代码平台引流的知识分享平台,页面非常简单,首页,详情页,搜索页,同时适配PC端和移动端,移动端适配方案在下面。
项目地址:知识中心-氚云
nuxt2 + vue2 + element UI + axios
1.项目搭建
// 确保安装了 npx(npx 在 NPM 版本 5.2.0 默认安装了)
npx create-nuxt-app <项目名>
yarn create nuxt-app <项目名>
回车
继续回车,一般建议用 ts
自己用啥就选啥
选择UI框架,这里也可以不选,如果已经确定好了UI框架,建议直接选择,非常好用。
我用的 element
选择模板引擎 HTML
接着选择 axios 发送请求
选择代码规范工具,我选 ESLint
选择测试框架,建议养成单元测试的习惯,提成代码质量。
选择渲染 mod,选第一个
选择 node.js
选 jsconfig.json
选 None
选 git
等待生成项目。
2.项目结构
2.1 运行项目
// 运行项目
npm run dev
// 部署 第一步
npm run build
// 部署 第二部
npm run start
浏览器出现下面,就ok了。
2.2 目录解析
- components: 项目组件;
- pages: 项目页面 + vue 路由。nuxt会根据pages的目录结构生成 router。页面目录
pages
用于组织应用的路由及视图。Nuxt.js 框架读取该目录下所有的.vue
文件并自动生成对应的路由配置; - plugins:该配置项用于配置那些需要在
根vue.js应用
实例化之前需要运行的 Javascript 插件,如初始化选择的 Element UI,swiper 等; - static: 静态资源,如image,css,less等;
- middleware:中间件,后面会介绍。我是用它来做移动端和pc端适配,非常好用;
- nuxt.config.js 配置文件,一些重要的配置后面会说,官网;
3.新手开发常见问题
这里是个人开发过程中遇到的一些问题,以及踩过的坑,分享一下,希望对客官有用
3.1 页面数据问题
- 只能在 pages 目录下的.vue文件才能使用 asyncData,用axios 请求数据。注意刚进入页面的第一次请求是服务端去请求数据,浏览器是看不到的,看控制台,还要这里赋值的时候最好跟后台确定下是否有空值,有空值得自己判空,不然很容易出bug。还有这里不要用window 对象!!
数据请求成功后,赋值到 vue 的data中。这样数据这块基本就没啥问题了。
- 在 asyncData 中获取路由数据 ,这里是文章详情页
asyncData 会传出当前上下文对象给我们,需要啥去取就行了,参数可以看文档或者自己打印出来研究。
3.2 在 nuxt 中使用 swiper
- 这里搞了我不少时间。首先swiper就有点坑,版本对应关系有点乱,网站搜了好多信息把才把版本弄好,接下来结合nuxt 还有坑。先看下版本吧:中文api - Swiper3|Swiper中文网
{
"swiper": "4.5.0",
"vue": "2.7.14",
"vue-awesome-swiper": "3.1.3"
}
接下来配置插件,nuxt.config.js,ssr设为false是让让该组件服务端不渲染。
再看下plugins/swiper.js
import Vue from 'vue'
import css from 'swiper/dist/css/swiper.css' // 注意css路径
import VueAwesomeSwiper from 'vue-awesome-swiper'
export default () => {
Vue.use(VueAwesomeSwiper,{css})
}
现在你就可以在项目里面用了,无需引用。这里注意的是用 <client-only></client-only>标签包裹,不然在客户端会多一层 <swiper> </swiper>。
- 动态路由,_id j就是动态路由,按照官网给的规则配置就行了。
3.3 移动端适配
- 移动端和pc端页面是分开的。这里采用路由中间件来做。我们知道 nuxt 分为服务端和客户端,那么在服务端收到请求的时候肯定能多获取请求的客户端信息,那么根据这个信息跳转到对应的 page页就行了。
- 配置中间件,在根目录新建文件夹 middleware,创建自定义中间件 isMobile.ts
/**
* 该中间件用来判断是移动端还是PC端,根据请求信息来判断,同时重定向到对应的页面
* @param context
*/
export default function(context:any) {
context.userAgent = process.server ? context.req.headers["user-agent"] : navigator.userAgent;
context.isMobile = isMobile(context.userAgent);
// 如果是移动端客户,且路由不存在 mobile 标识,进行重定向,
if (context.isMobile && context.route.path.indexOf('mobile') === -1) {
// 首页重定向
if (context.route.path === '/knowledge/home') {
context.redirect(302,'/site'+ context.route.path +'-mobile')
}
// 详情页重定向
if (context.route.path.indexOf('/knowledge/detail') !== -1) {
context.redirect(302,'/site/knowledge/detail-mobile/' + context.route.params.id)
}
}
}
function isMobile(UA:string) {
return /(Android|webOS|iPhone|iPod|tablet|BlackBerry|Mobile)/i.test(UA);
}
在 nuxt.config.js 进行配置
3.4 网关层级导致 swiper 无法正常展示
现象:项目部署后直接访问 ip 一切正常,用域名访问 swiper 就是无法显示,组件没有被解析。目前猜测原因是网关层发生跳转,导致nuxt 服务端和客户端信息传递异常,没能正确解析 swiper。所以使用 nuxt 部署后,最好是能直接访问到该项目,或者有独立域名。