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

前言

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

前后端项目结构区别

  • front-end

    平时大家编写vue项目,一般都是使用vue-cli初始化项目,生成的项目配置齐全,大家只要在src目录进行开发即可,开发完成后执行npm run build完成生产环境的打包,丢到服务器上即可,简直不要太省心。

    我估计以上的开发模式在当前是占据相当一部分比重的,vue-cli方便大家的同时,也造成很多开发者(一般是初入门者)对内部原理缺乏认知,对webpack配置不甚了解。在此建议大家对vue-cli生成的项目结构进行分析,网上也有很多分析文章,然后试着自己搭建脚手架,加深理解。

  • back-end

    提到服务器端渲染,涉及node服务,可能有一部分前端会觉得偏离了自己的方向,然而,作为一名程序员,真的建议大家不要把自己局限在一个方向。js现在异常活跃,pc端、移动端、桌面端、后端、硬件端(嵌入式)都可以看到它的身影,前端也逐渐发展为大前端。

    在此以node项目为例子,做简单说明。(node水平不高,若有错误,欢迎指正)
    node项目的初始化和自己搭建一个前端脚手架并没有太多区别,区分点主要有以下几点:

  • node项目的入口文件是js,前端项目是html

  • node项目中可以引用node的相关依赖,而前端项目不可以

  • 原形毕露,后续补充...

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

在此使用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 服务器端渲染指南

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 204,793评论 6 478
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 87,567评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 151,342评论 0 338
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,825评论 1 277
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,814评论 5 368
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,680评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,033评论 3 399
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,687评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 42,175评论 1 300
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,668评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,775评论 1 332
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,419评论 4 321
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,020评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,978评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,206评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,092评论 2 351
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,510评论 2 343

推荐阅读更多精彩内容

  • 在实现 egg + vue 服务端渲染工程化实现之前,我们先来看看前面两篇关于Webpack构建和Egg的文章: ...
    hubcarl阅读 6,002评论 0 19
  • 转载 :OpenDiggawesome-github-vue 是由OpenDigg整理并维护的Vue相关开源项目库...
    果汁密码阅读 23,090评论 8 124
  • 全身发抖嘴里哈气棉袄包裹你却呼呼在笑
    玥萱儿阅读 133评论 0 1
  • 在28号这一天,在我居住的县城四川江安县。过的无比激动,感动涟漪的一天。白天看酷炫刺激的摩托越野赛,晚上看...
    香秋美朵阅读 538评论 1 2
  • 曲歌是我兄弟,我们曾有过生死之交。 那一年,在一辆长途大巴上我俩携手勇斗一伙持刀歹徒,结果他的左脸被永久性的保留了...
    十月城池阅读 592评论 3 0