nodeVue

vue 2.0服务端渲染从零开始(一)

2017-08-04  本文已影响1745人  回调的幸福时光

前言

本文章重点在于代码实践,从零开始完整的展示如何构建项目。
下午看了很多相关资料,但是讲解的着重于理论,或者直接给出github仓库链接,也有的只列出几条重点,看完还是不知道如何实践。

前后端项目结构区别

搭建一个最简单的服务器项目

在此使用express框架。

## 以desktop为根目录
## 创建项目文件夹
mkdir simple-demo
## 进入项目根目录
cd simple-demo
## 项目初始化
npm init 
## 根据命令提示完成相关配置即可
## 安装express依赖
npm install express -save
## 或者使用yarn安装(两种方式任选其一)
yarn add express
## 创建server.js
touch server.js

server.js

const express = require('express');
const server = express();

server.get('/', (req, res) => {
  res.send('<h1>hello world</h1>')
})

server.listen(8080);

结果

 ##  执行以下命令
 node server.js

浏览器输入localhost:8080

express.png

服务器端渲染基本用法

/**************************************************************************
以下所有源码戳我
**************************************************************************/

以上述simple-demo为基础

## 安装依赖(NPM、Yarn)
npm install vue vue-server-renderer --save

增加app.js文件

// 第 1 步:创建一个 Vue 实例
const Vue = require('vue')
const app = new Vue({
  template: `<div>Hello World</div>`
})
// 第 2 步:创建一个 renderer
const renderer = require('vue-server-renderer').createRenderer()
// 第 3 步:将 Vue 实例渲染为 HTML
renderer.renderToString(app, (err, html) => {
  if (err) throw err
  console.log(html)
  // => <div data-server-rendered="true">Hello World</div>
})

在项目根目录执行node app.js

render-1.png

render原理
在node项目中,使用vue-server-renderer插件将vue实例渲染为HTML。

与服务器集成

将上述项目simple-demo中的server.js内容清空,并更改为以下内容。

const Vue = require('vue');
const server = require('express')();
const renderer = require('vue-server-renderer').createRenderer();

server.get('*', (req, res) => {
  const app = new Vue({
    data: {
      url: req.url
    },
    template: '<div>访问的url是{{url}}</div>'
  });
  renderer.renderToString(app, (err, html) => {
    if (err) {
      res.status(500).end('Internal Server Error')
      return
    }
    res.setHeader('Content-Type','text/html;charset=UTF-8'); // 避免乱码
    res.end(`
      <!DOCTYPE html>
      <html lang="en">
        <head>
          <title>Hello</title>
        </head>
        <body>
          ${html}
        </body>
      </html>
    `);
  });
})

server.listen(8080);

执行命令node server.js

注: /index是我随意输入的url,从/开始之后都是req.url的值。

render-2.png

到此为止,已经使用node服务器将vue实例渲染为HTML,并在浏览器中展示出来了。

使用页面模板

上一个环节,我们在res.end中将vue渲染成的HTML标记和HTML页面包裹容器拼接在了一起。为了简化这些操作,我们可以直接创建一个页面模板。

index.template.html

注: ``注释是必须的,否则在终端启动服务器的时候,会提示Content placeholder not found in template

<!DOCTYPE html>
<html lang="en">
  <head><title>Hello</title></head>
  <body>
    <!--vue-ssr-outlet-->
  </body>
</html>

新建server-2.js

通过fs模块读取并应用模板文件。详细源码请参考dev_1分支的server-2.js文件

const renderer = require('vue-server-renderer').createRenderer({
  template: require('fs').readFileSync('./index.template.html', 'utf-8')
});

执行node server-2.js,得到以下结果(和上一步相同):

render-3.png

模板插值

上一个环节,模板是固定的,在这一步我们将通过模板插值,来配置模板。

增加模板文件mustache.template.html

<!DOCTYPE html>
<html>
  <head>
    <!-- 使用双花括号(double-mustache)进行 HTML 转义插值(HTML-escaped interpolation) -->
    <title>{{ title }}</title>
    <!-- 使用三花括号(triple-mustache)进行 HTML 不转义插值(non-HTML-escaped interpolation) -->
    {{{ meta }}}
  </head>
  <body>
    <!--vue-ssr-outlet-->
  </body>
</html>

新建server-3.js,详细源码请参考dev_1分支的server-3.js文件

 const context = {
  title: 'hello',
  meta: `
    <meta charset='utf-8'>
  `
}
renderer.renderToString(app, context, (err, html) => {
  // page title will be "Hello"
  // with meta tags injected
})

执行node server-3.js,得到以下结果,插值已生效:

renderer-3.png

服务端渲染和浏览器端渲染

仔细观察网页源码,可以看到服务端渲染的页面,body中是有html标记的。

而通过vue-cli编写的项目,在浏览器端渲染后,body中是空的,html标记是通过js插入的。

搜索引擎爬虫抓取工具是通过抓取页面内容来进行信息收集的,而在浏览器端渲染的SPA项目,页面内容是空的,这就是为什么SPA项目SEO很糟糕的原因。

参考

Vue.js 服务器端渲染指南

上一篇下一篇

猜你喜欢

热点阅读