vue ssr 指南詳讀
本帖說(shuō)明
該貼是對(duì)vue SSR Guide解讀和補(bǔ)充,對(duì)于官網(wǎng)文檔已有內(nèi)容會(huì)以引用方式體現(xiàn)。由于官網(wǎng)demo在國(guó)內(nèi)無(wú)法運(yùn)行,該貼最后也提供了一個(gè)完整的可以運(yùn)行的demo,帖子中提到的代碼均是來(lái)自于該demo,供學(xué)習(xí)交流。
介紹
什么是服務(wù)器端渲染(SSR)?
Vue.js 是構(gòu)建客戶端應(yīng)用程序的框架。默認(rèn)情況下,可以在瀏覽器中輸出 Vue 組件,進(jìn)行生成 DOM 和操作 DOM。然而,也可以將同一個(gè)組件渲染為服務(wù)器端的 HTML 字符串,將它們直接發(fā)送到瀏覽器,最后將靜態(tài)標(biāo)記"混合"為客戶端上完全交互的應(yīng)用程序。
借助vue-server-renderer 將vue實(shí)例渲染為瀏覽器可以識(shí)別的html字符串。
為什么使用服務(wù)器端渲染(SSR)?
- 更好的 SEO
- 更快的內(nèi)容到達(dá)時(shí)間 (白屏)
左側(cè)為瀏覽器渲染,右側(cè)為服務(wù)器渲染,從圖中可以看出服務(wù)端渲染理論上明顯少于瀏覽器渲染。
基本用法
安裝
git clone https://github.com/s249359986/learnssr.git cd learnssr npm install npm run dev
代碼結(jié)構(gòu)
src ├── components │ ├── Foo.vue ├── views │ ├── Home.vue ├── App.vue ├── app.js ├── client-entry.js ├── server-entry.js
代碼詳解
server.js 是服務(wù)端啟動(dòng)入口文件,接收客戶端對(duì)頁(yè)面的所有請(qǐng)求。
if (isProd) { /** 生產(chǎn)環(huán)境,createRenderer將已經(jīng)通過(guò)webpack打包好的server-bundle.js轉(zhuǎn)化為一個(gè)可以操作的renderer對(duì)象。 **/ renderer = createRenderer(fs.readFileSync(resolve('./dist/server-bundle.js'), 'utf-8')) /** 入口模板文件 **/ indexHTML = parseIndex(fs.readFileSync(resolve('./dist/index.html'), 'utf-8')) } else { /** 開(kāi)發(fā)環(huán)境,createRenderer將已經(jīng)通過(guò)webpack打包好的server-bundle.js轉(zhuǎn)化為一個(gè)可以操作的renderer對(duì)象。 **/ require('./build/setup-dev-server')(app, { bundleUpdated: bundle => { renderer = createRenderer(bundle) }, indexUpdated: index => {//index為入口文件及index.html indexHTML = parseIndex(index) } }) } function createRenderer (bundle) { return require('vue-server-renderer').createBundleRenderer(bundle, { cache: require('lru-cache')({ max: 1,//1000, maxAge: 2000//1000 * 60 * 15 }), runInNewContext: false }) } /* 讀取入口文件 */ function parseIndex (template) { const contentMarker = '<!-- APP -->' const i = template.indexOf(contentMarker) return { head: template.slice(0, i), tail: template.slice(i + contentMarker.length) } } const serve = (path, cache) => express.static(resolve(path), { maxAge: cache && isProd ? 60 * 60 * 24 * 30 : 0 }) app.use('/dist', serve('./dist')) app.get('*', (req, res) => { if (!renderer) { return res.end('waiting for compilation... refresh in a moment.') } res.setHeader('Content-Type', 'text/html') res.setHeader('Server', serverInfo) var s = Date.now() const context = { url: req.url } /* 渲染vue實(shí)例,context對(duì)象上下文 */ const renderStream = renderer.renderToStream(context) renderStream.once('data', () => { res.write(indexHTML.head) }) renderStream.on('data', chunk => { res.write(chunk) }) renderStream.on('end', () => { if (context.initialState) { res.write( `<script>window.__INITIAL_STATE__=${ serialize(context.initialState, { isJSON: true }) }</script>` ) } res.end(indexHTML.tail) console.log(`whole request: ${Date.now() - s}ms`) }) renderStream.on('error', err => { if (err && err.code === '404') { res.status(404).end('404 | Page Not Found') return } res.status(500).end('Internal Error 500') console.error(`error during render : ${req.url}`) console.error(err) }) }) const port = process.env.PORT || 8080 app.listen(port, () => { console.log(`server started at localhost:${port}`) })
服務(wù)端vue實(shí)例入口文件,通過(guò)上下文對(duì)象獲取請(qǐng)求的url,映射給對(duì)應(yīng)的組件。
export default context => { const s = isDev && Date.now() router.push(context.url) const matchedComponents = router.getMatchedComponents() if (!matchedComponents.length) { return Promise.reject({ code: '404' }) } return Promise.all(matchedComponents.map(component => { /* 增加服務(wù)端數(shù)據(jù)預(yù)處理 start */ if (component.asyncData) { return component.asyncData({ store, route: router.currentRoute }) } /* 增加服務(wù)端數(shù)據(jù)預(yù)處理 end */ })).then(() => { isDev && console.log(`data pre-fetch: ${Date.now() - s}ms`) context.initialState = store.state return app }) }
客戶端vue實(shí)例入口文件.
/* 第一種方式 */ Vue.mixin({ beforeMount () { const { asyncData } = this.$options console.log('beforeMount',this.$store) if (asyncData) { // 將獲取數(shù)據(jù)操作分配給 promise // 以便在組件中,我們可以在數(shù)據(jù)準(zhǔn)備就緒后 // 通過(guò)運(yùn)行 `this.dataPromise.then(...)` 來(lái)執(zhí)行其他任務(wù) this.dataPromise = asyncData({ store: this.$store, route: this.$route }) } }, beforeRouteUpdate (to, from, next) { const { asyncData } = this.$options console.log('beforeRouteUpdate',this.$store) if (asyncData) { asyncData({ store: this.$store, route: to }).then(next).catch(next) } else { next() } } }) /** 更新客戶端store,與服務(wù)端store同步 **/ // store.replaceState(window.__INITIAL_STATE__) if (window.__INITIAL_STATE__) { store.replaceState(window.__INITIAL_STATE__) } // actually mount to DOM router.onReady(() => { /** 掛載實(shí)例,客戶端激活,所謂激活,指的是 Vue 在瀏覽器端接管由服務(wù)端發(fā)送的靜態(tài) HTML,使其變?yōu)橛?Vue 管理的動(dòng)態(tài) DOM 的過(guò)程。注釋掉app.$mount('#app') 可以清楚看到<div id="app" data-server-rendered="true"> 客戶端通過(guò)data-server-rendered="true"知道該html是vue在服務(wù)端渲染的,并且不會(huì)在做多余的渲染。由于在服務(wù)端無(wú)法綁定事件,只有通過(guò)客戶端vue處理。 **/ app.$mount('#app') })
以上就是本文的全部?jī)?nèi)容,希望對(duì)大家的學(xué)習(xí)有所幫助,也希望大家多多支持腳本之家。
相關(guān)文章
vue實(shí)現(xiàn)自定義H5視頻播放器的方法步驟
這篇文章主要介紹了vue實(shí)現(xiàn)自定義H5視頻播放器的方法步驟,文中通過(guò)示例代碼介紹的非常詳細(xì),對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值,需要的朋友們下面隨著小編來(lái)一起學(xué)習(xí)學(xué)習(xí)吧2019-07-07vite.config.ts配置之自動(dòng)導(dǎo)入element-puls方式
這篇文章主要介紹了vite.config.ts配置之自動(dòng)導(dǎo)入element-puls方式,具有很好的參考價(jià)值,希望對(duì)大家有所幫助,如有錯(cuò)誤或未考慮完全的地方,望不吝賜教2023-10-10html+vue.js 實(shí)現(xiàn)漂亮分頁(yè)功能可兼容IE
功能比較簡(jiǎn)單,在單一html中使用vue.js分頁(yè)展示數(shù)據(jù),并未安裝腳手架,或使用相關(guān)UI框架,此時(shí)需要手寫(xiě)一個(gè)分頁(yè)器,不失為最合理最便捷的解決方案,需要的朋友可以參考下2020-11-11Vue中用props給data賦初始值遇到的問(wèn)題解決
這篇文章主要介紹了Vue中用props給data賦初始值遇到的問(wèn)題解決,小編覺(jué)得挺不錯(cuò)的,現(xiàn)在分享給大家,也給大家做個(gè)參考。一起跟隨小編過(guò)來(lái)看看吧2018-11-11解決ant design vue中樹(shù)形控件defaultExpandAll設(shè)置無(wú)效的問(wèn)題
這篇文章主要介紹了解決ant design vue中樹(shù)形控件defaultExpandAll設(shè)置無(wú)效的問(wèn)題,具有很好的參考價(jià)值,希望對(duì)大家有所幫助。一起跟隨小編過(guò)來(lái)看看吧2020-10-10