Vue.js 是一个渐进式的 JavaScript 框架,它可以用来构建用户界面,也可以用来实现服务端渲染。服务端渲染是一种将完整的 HTML 页面发送到浏览器的方法,而不是将 HTML 标记和 JavaScript 发送到浏览器,然后在浏览器中执行 JavaScript 代码来生成 HTML 页面。
Vue.js 的服务端渲染可以帮助开发者快速地将应用程序部署到服务器上,并且能够在客户端上快速呈现出内容。这样就能够使得应用程序的性能得到大幅度的提升,因为服务端已经处理了大部分工作,而不是将所有工作都交给客户端去处理。
要使用 Vue.js 实现服务端渲染,首先要使用 Node.js 和 Express 来创建一个 Web 服务器。然后使用 Vue.js 的 server-side rendering API 来生成 HTML 页面。具体步骤如下:
// 1. 安装依赖包 npm install express vue vue-server-renderer --save // 2. 创建 Express 服务 const express = require('express') const app = express() // 3. 设置 Vue 渲染引擎 app.engine('html', require('vue-server-renderer').createRenderer()) // 4. 设置静态文件目录 app.use(express.static('public')) // 5. 处理请求 app.get('/', (req, res) => { // 6. 返回 HTML res.render('index', { title: 'Vue SSR Demo' }) }) // 7. 监听端口 app.listen(3000)
上述代码中,我们使用了 Express 来创建了一个 Web 服务器,并使用 Vue 的 server-side rendering API 来生成 HTML 页面。当请求 / 路径时,Express 服务会返回 index 页面的 HTML 内容。
在开始服务端渲染前,我们先看看它能给我们带来什么,以及什么时候需要用它。
谷歌和Bing可以很好地索引同步的JavaScript应用。同步在这里是个关键词。如果应用启动时有一个加载动画,然后内容通过ajax获取,那爬虫不会等待他们加载完成。
这意味着在异步获取内容的页面上很需要进行搜索引擎优化的时候,服务端渲染就很重要。
用户可能在网络比较慢的情况下从远处访问网站 - 或者通过比较差的带宽。这些情况下,尽量减少页面请求数量,来保证用户尽快看到基本的内容。
可以用Webpack的代码拆分避免强制用户下载整个单页面应用,但是,这样也远没有下载个单独的预先渲染过的HTML文件性能高。
对于世界上的一些地区人,可能只能用1998年产的电脑访问互联网的方式使用计算机。而Vue只能运行在IE9以上的浏览器,你可以也想为那些老式浏览器提供基础内容 - 或者是在命令行中使用 Lynx的时髦的黑客。
如果你只是用服务端渲染来改善一个少数的营销页面(如 首页,关于,联系 等等)的SEO,那你可以用预渲染替换。预渲染不像服务器渲染那样即时编译HTML,预渲染只是在构建时为了特定的路由生成特定的几个静态页面。其优势是预渲染的设置更加简单,可以保持前端是一个完整的静态站。
你用webpack可以很简单地通过prerender-spa-plugin来添加预渲染,它被广泛地用在Vue应用上 - 事实上,创建者也是Vue核心团队成员之一。
准备在行动中体验服务端渲染吧。服务端渲染(即SSR)听起来很复杂,不过一个简单的Node脚本只需要3步就可以实现这个功能:
// 步骤 1:创建一个Vue实例
var Vue = require("vue")
var app = new Vue({
render: function (h) {
return h("p", "hello world")
}
})
// 步骤 2: 创建一个渲染器
var renderer = require("vue-server-renderer").createRenderer()
// 步骤 3: 将 Vue实例 渲染成 HTML
renderer.renderToString(app, function (error, html) {
if (error) throw error
console.log(html)
// => <p server-rendered="true">hello world</p>
})
这并不困难。当然这个示例比大部分应用都简单。我们不必担心:
这个指南的其余部分,我们将探讨这些功能怎样运作。一旦你理解了基础,我们会提供更多细节和进一步的示例来帮助你解决意外情况。
如果没有一个Web服务器,很难说是服务端渲染,所以我们来补充它。我们将构建一个非常简单的服务端渲染应用,只用ES5,也不带其他构建步骤或Vue插件。
启动一个应用告诉用户他们在一个页面上花了多少时间。
new Vue({
template: "<div>你已经在这花了 {{ counter }} 秒。</div>",
data: {
counter: 0
},
created: function () {
var vm = this
setInterval(function () {
vm.counter += 1
}, 1000)
}
})
为了适应服务端渲染,我们需要进行一些修改,让它可以在浏览器和Node中渲染:
实现这个需要一点模板:
// assets/app.js
(function () { "use strict"
var createApp = function () {
// ---------------------
// 开始常用的应用代码
// ---------------------
// 主要的Vue实例必须返回,并且有一个根节点在id "app"上,这样客户端可以加载它。
return new Vue({
template: "<div id="app">你已经在这花了 {{ counter }} 秒。</div>",
data: {
counter: 0
},
created: function () {
var vm = this
setInterval(function () {
vm.counter += 1
}, 1000)
}
})
// -------------------
// 结束常用的应用代码
// -------------------
}
if (typeof module !== "undefined" && module.exports) {
module.exports = createApp
} else {
this.app = createApp()
}
}).call(this)
现在有了应用代码,接着加一个 html文件。
<!-- index.html -->
<!DOCTYPE html>
<html>
<head>
<title>My Vue App</title>
<script src="/assets/vue.js"></script>
</head>
<body>
<div id="app"></div>
<script src="/assets/app.js"></script>
<script>app.$mount("#app")</script>
</body>
</html>
主要引用assets文件夹中我们先前创建的app.js,以及vue.js文件,我们就有了一个可以运行的单页面应用
然后为了实现服务端渲染,在服务端需要加一个步骤。
// server.js
"use strict"
var fs = require("fs")
var path = require("path")
// 定义全局的Vue为了服务端的app.js
global.Vue = require("vue")
// 获取HTML布局
var layout = fs.readFileSync("./index.html", "utf8")
// 创建一个渲染器
var renderer = require("vue-server-renderer").createRenderer()
// 创建一个Express服务器
var express = require("express")
var server = express()
// 部署静态文件夹为 "assets"文件夹
server.use("/assets", express.static(
path.resolve(__dirname, "assets")
))
// 处理所有的Get请求
server.get("*", function (request, response) {
// 渲染我们的Vue应用为一个字符串
renderer.renderToString(
// 创建一个应用实例
require("./assets/app")(),
// 处理渲染结果
function (error, html) {
// 如果渲染时发生了错误
if (error) {
// 打印错误到控制台
console.error(error)
// 告诉客户端错误
return response
.status(500)
.send("Server Error")
}
// 发送布局和HTML文件
response.send(layout.replace("<div id="app"></div>", html))
}
)
})
// 监听5000端口
server.listen(5000, function (error) {
if (error) throw error
console.log("Server is running at localhost:5000")
})
这样就完成了。整个示例,克隆下来深度实验。一旦它在本地运行时,你可以通过在页面右击选择页面资源(或类似操作)确认服务选渲染真的运行了。可以在body中看到:
<div id="app" server-rendered="true">You have been here for 0 seconds.</div>
代替:
<div id="app"></div>
Vue还支持流式渲染,优先选择适用于支持流的Web服务器。允许HTML一边生成一般写入相应流,而不是在最后一次全部写入。其结果是请求服务速度更快,没有缺点!
为了使上一节应用代码适用流式渲染,可以简单的替换 server.get("*",...)为下面的代码:
// 拆分布局成两段HTML
var layoutSections = layout.split("<div id="app"></div>")
var preAppHTML = layoutSections[0]
var postAppHTML = layoutSections[1]
// 处理所有的Get请求
server.get("*", function (request, response) {
// 渲染我们的Vue实例作为流
var stream = renderer.renderToStream(require("./assets/app")())
// 将预先的HTML写入响应
response.write(preAppHTML)
// 每当新的块被渲染
stream.on("data", function (chunk) {
// 将块写入响应
response.write(chunk)
})
// 当所有的块被渲染完成
stream.on("end", function () {
// 将post-app HTML写入响应
response.end(postAppHTML)
})
// 当渲染时发生错误
stream.on("error", function (error) {
// 打印错误到控制台
console.error(error)
// 告诉客服端发生了错误
return response
.status(500)
.send("Server Error")
})
})
这不比之前的版本复杂,甚至这对你来说都不是个新概念。我们做了:
Vue的服务端渲染默认非常快,但是你可以通过缓存渲染好的组件进一步提高性能。这被认为是一种先进的功能,但是,如果缓存了错误的组件(或者正确的组件带有错误的内容)将导致应用渲染出错。特别注意:
不应该缓存组件包含子组件依赖全局状态(例如来自vuex的状态)。如果这么做,子组件(事实上是整个子树)也会被缓存。所以要特别注意带有slots片段或者子组件的情况。
在警告情况之外的,我们可以用下面的方法缓存组件。
首先,你需要提供给渲染器一个 缓存对象。这有个简单的示例使用 lru-cache
var createRenderer = require("vue-server-renderer").createRenderer
var lru = require("lru-cache")
var renderer = createRenderer({
cache: lru(1000)
})
这将缓存高达1000个独立的渲染。对于更进一步缓存到内容中的配置,看lru-cache设置
然后对于你想缓存的组件,你可以为他们提供:
例如:
Vue.component({
name: "list-item",
template: "<li>{{ item.name }}</li>",
props: ["item"],
serverCacheKey: function (props) {
return props.item.type + "::" + props.item.id
}
})
任何纯组件可以被安全缓存 - 这是保证给任何组件传递一样的数据产生相同的HTML。这些场景的例子包括:
现在,应该理解服务端渲染背后的基本概念了。但是,构建过程、路由、Vuex每一个都有自己的注意事项。
要真正掌握复杂应用下的服务端渲染,我们推荐深度熟悉以下资源:
ReactReact 和 Vue 有许多相似之处,它们都有:使用 Virtual DOM提供了响应式(Reactive)和组件化(Composable)的视图组件。将...
基础用法你可以用v-model指令在表单input、textarea及select元素上创建双向数据绑定。它会根据控件类型自动选取...
v-for我们用v-for指令根据一组数组的选项列表进行渲染。v-for指令需要以item in items形式的特殊语法,items是源数据数组并且ite...
兼容性Vue.js 不支持 IE8 及其以下版本,因为 Vue.js 使用了 IE8 不能模拟的 ECMAScript 5 特性。但它支持所有兼容 ECMAScript 5...