Vue预渲染prerender-spa-plugin+vue-meta-info
前言:
公司现有一个新需求需要在原有的vue2项目上面进行预渲染,进行SEO的优化,在网上进行了一系列的搜索,发现两种简单易上手的方案(1.使用prerender-spa-plugin+vue-meta-info进行打包构建;2.使用nuxt.js在开发过程中就渲染呈现出来)
因是在原有项目基础上进行,所以采用第一种方案进行构建渲染,话不多说,直接上代码!!!
一、prerender-spa-plugin插件使用
1.安装
//npm npm install prerender-spa-plugin --save //yarn yarn add prerender-spa-plugin --dev
2.找到build文件下webpack.prod.conf.js 在页面中添加代码
// 预渲染 const PrerenderSPAPlugin = require('prerender-spa-plugin') const Renderer = PrerenderSPAPlugin.PuppeteerRenderer plugins: [ // 预渲染 new PrerenderSPAPlugin({ // 生成文件的路径,也可以与webpakc打包的一致。 // 下面这句话非常重要!!! // 这个目录只能有一级,如果目录层次大于一级,在生成的时候不会有任何错误提示,在预渲染的时候只会卡着不动。 staticDir: path.join(__dirname, '../dist'), // 对应自己的路由文件,比如a有参数,就需要写成 /a/param1。 routes: ['/', '/index'], // 这个很重要,如果没有配置这段,也不会进行预编译 renderer: new Renderer({ inject: { foo: 'bar' }, // headless: false, // renderAfterDocumentEvent: 'render-event', // 在 main.js 中 document.dispatchEvent(new Event('render-event')),两者的事件名称要对应上。 // args: ['--no-sandbox', '--disable-setuid-sandbox'] navigateOptions:{ timeout: 0, } }) ]
3.在main.js里面添加mounted newEvent('document') document名字必须与第二步中的名字对呀
// 添加mounted,不然不会执行预编译 mounted () { document.dispatchEvent(new Event('render-event')) }
4.router.js中一定要设置history模式
5.npm run build
打包之后可以看到配置好的路由生成了相应的html页面
二、vue-meta-info使用
1.插件安装
npm install vue-meta-info --save
2.main.js引用
import MetaInfo from 'vue-meta-info' // 注册 Vue.use(MetaInfo)
3.页面上使用
3.1-直接在页面上使用
//单个页面配置 <template> <div>首页</div> </template> export default { name:'首页' metaInfo:{ title:'首页', meta:[ { name: 'keyWords', content:'关键字' }, { name:'description', content:'描述' } ] } } //多页面配置 <template> <div>首页</div> </template> export default { name:'index' metaInfo():{ return{ meta:this.metaData } }, data(){ return{ metaData:'' } }, watch:{ $route(to,form){ //通过跳转页面配置每个页面的关键字和描述,这只是个例子 //注意如果通过to.path去判断 需要进行兼容判断 因为渲染后的访问路径会在末尾自动添加/ 例如 loclhost:3000/index/,这个时候就需要 to.path === '/index' || to.path==='/index/' if(to.name === 'index'){ this.metaData=[ { name: 'keyWords', content:'关键字' }, { name:'description', content:'描述' } ] } //当然也可以封装一个方法去返回每个页面的文案 //this.metaData = metaSetFuc(to.name) } } }
3.2-新建一个js文件里面
export default { index: { title: 'title', meta: [ { name: 'keywords', content: '' }, { name: 'description', content: '' } ] }, }
然后再页面上面去引用
//导入存放的文件路径 import VueMetaInfo from '../assets/vue-meta-info.js' export default { metaInfo: VueMetaInfo.index, }
三、在使用中遇到的问题
1.[prerender-spa-plugin] Unable to prerender all routes! 错误
在node_modules -> @prerender -> renderer-puppeteer -> es6 -> renderer.js(113行)
await page.goto(`${baseURL}${route}`, navigationOptions); //修改为 await page.goto(`${baseURL}${route}`, {...navigationOptions, timeout: 0});