Vue.js教程: 构建一个预渲染SEO友好的应用示例 [译]

作者：Maxime Laboissonniere

原文地址: Vue.js Tutorial: An Example to Build and Prerender an SEO-Friendly Site

译者：jeneser

快速了解？直接前往教程步骤或Github仓库&在线演示

“我受不了了！我们的内部报告面板太烂了”

产品经理很生气。他从这个即将崩溃的应用程序中拉取数据的操作是灾难性的。

“Max，我们需要更好的报告。你能修吗？”

“老实说，我更愿意建立一个全新的应用”，我笑着回答说。

“好，请便。全权委托，老铁”

我笑着，搓了搓手。最后，在一个需要使用JS框架的场景中，大家一致选择了Vue.js。

---

最近，我完成该应用的代码，我对它简直爱不释手。
我花了一些时间为社区写了一个vue.js教程，这些教程的灵感全部来自于我最近对vue的实践。在这里，我主要讨论以下两点：

1. 如何使用Vue.js构建精简的Web应用程序

2. 如何使用prerender-spa-plugin来处理Vue.js应用的预渲染与SEO

更具体地说，我将带您创建一个小商店，它将具备SEO友好的产品页面。我会提供在线演示以及相关代码。
在我们开发的最新版Headless CMS中我接触过一些vue，这一次我们会更加的深入，我很兴奋！

更新：我们正在将Snipcart的前端从Backbone迁移到Vue.js，了解更多

我们先来为那些不熟悉渐进式框架(Vue.js)的同学做一下简单的介绍。

Vue.js到底是什么？

Vue.js是一套帮助你构建用户界面的轻量级，渐进式的JavaScript框架

不要被“JS框架”这一定义所愚弄。Vue与目前流行的React.js & Angular.js是截然不同的。对于初学者来说，它不是Google＆Facebook等商业技术巨头的开源副产品。

Evan You(尤雨溪)在2014年首次发布了它，旨在创建一个“增量开发”的现代JS库。Vue最强大的功能之一是：创建可复用的组件，你可以在其他项目中重用这些组件而不用再次编写。所有开发人员都可以在项目中尝试Vue，而不用担心这会对现有的代码库产生危害或是增加额外的负担。

抛开模式和术语，我觉得Vue有以下提论：

1. 一开始你不知道整个应用的架构状态
2. 应用数据一定会在运行时发生改变

正是围绕这些提论，vue塑造了自身：它是渐进式，基于组件和响应式的。组件的粒度划分可以让你轻松地分离应用逻辑，同时又保持它们的可重用性。更重要的是，它将您的数据原生绑定到视图，以便在需要时“神奇”地更新(通过watcher)。虽然许多响应式前端框架拥有同样的功能，但是我发现Vue更优雅的实现了它，并且，对于我的大多数用例，它往往表现的更好。

Vue还具有更加平滑的学习曲线，对于React来说，我们需要掌握JSX模板等的相关知识。甚至可以说Vue是React减去了比较复杂的部分。

Vue官方文档提供了与其他JS框架(React, Angular, Ember, Knockout, Polymer, Riot)更加深入的对比。查看官方文档

最后但同样重要的是：得益于高性能&强大的开发工具，Vue为我们提供了最佳的编码体验。它能如此流行也就不足为奇了!

从开源项目Laravel＆PageKit，到企业，如Gitlab＆Codeship（更不用说阿里巴巴和百度这些巨头了），许多组织正在使用Vue。

OK，现在是时候来看看我们将如何使用它了。

Vue.js例子：一个快速的，搜索引擎友好的电子商务应用

在本节中，我会告诉你如何使用Vue 2.0 & Snipcart建立一个小型的电子商务应用程序。我们还将看到如何确保产品页面被搜索引擎正确“抓取”。

准备

• 了解一些Vue.js相关知识，还不了解？

• 基本了解vuex & vue-router

• 一个Snipcart帐户（测试模式永久免费）

如果你想深入了解 Vue 2.0 相关知识，可以查看Laracasts上的这个系列。

1. 环境配置

首先，我们将使用vue-cli来构建基本的Vue应用程序。在你喜欢的终端里，输入：

npm install -g vue-cli
vue init webpack-simple vue-snipcart

这将创建一个新的vue-snipcart文件夹，其中包含使用vue-loader的基本配置，它将能使我们编写单文件组件(template/js/css在同一个.vue文件中)。

我们希望这个示例尽可能真实，因此，我们将在本应用中增加两个广泛应用于大型项目的模块：vuex和vue-router。

• vuex是类Flux架构的状态管理器 - 轻量级，非常强大。它受到了Redux的影响，你可以在这里了解更多。

• vue-router允许您定义路由以动态处理应用程序的组件。

要安装这些，请先进入vue-snipcart项目文件夹，然后运行以下命令：

npm install --save vue-router
npm intsall --save vuex

接下来要安装的是prerender-spa-plugin，这将使我们能够预渲染“蜘蛛”将要爬行的路径：

npm install --save prerender-spa-plugin

快要完成了，最后四个包：

• pug - 模板引擎，相对于HTML我更喜欢它。

• vuex-router-sync-to - 轻松保持vue-router和vuex存储同步。

• copy-webpack-plugin-to - 轻松包含我们在dist文件夹中的静态文件。

• babel-polyfill - 在PhantomJS中运行Vue（通过我们的预渲染插件使用）。

运行这些：

npm install --save pug
npm install --save vuex-router-sync
npm install --save copy-webpack-plugin
npm install --save babel-polyfill

2. 架构

安装完成后请检查是否安装正确。之后，便可以处理我们的商店数据了。

先从vuex的store开始，我们将使用它来存储/访问我们的产品信息。

在本演示中，我们将使用静态数据，如果我们要取而代之，它仍然可以工作。

注：关于Snipcart，我们使用基本的JS代码段注入购物车，并使用简单的HTML属性定义产品。

2.1 构建store

在src中创建一个store文件夹，包含以下3个文件：

• state.js - 定义我们的静态产品数据

• getters.js - 定义get函数，通过ID检索产品

• index.js - 组合前两个文件

//state.js
export const state = {
    products: [
        {
            id: 1,
            name: 'The Square Pair',
            price: 100.00,
            description: 'Bold & solid.',
            image: 'https://snipcart.com/media/10171/glasses1.jpeg'
        },
        {
            id: 2,
            name: 'The Hip Pair',
            price: 110.00,
            description: 'Stylish & fancy.',
            image: 'https://snipcart.com/media/10172/glasses2.jpeg'
        },
        {
            id: 3,
            name: 'The Science Pair',
            price: 30,
            description: 'Discreet & lightweight.',
            image: 'https://snipcart.com/media/10173/glasses3.jpeg'
        }
    ]
}

//getters.js
    export const getters = {
        getProductById: (state, getters) => (id) => {
            return state.products.find(product => product.id == id)
        }
    }

//index.js
import Vue from 'vue'
import Vuex from 'vuex'
import { state } from './state.js'
import { getters } from './getters.js'

Vue.use(Vuex)

export default new Vuex.Store({
  state,
  getters
})

2.2 构建路由器

我们将保持商店尽可能简单：展示产品列表的首页以及每个产品的详细信息页面。我们需要在路由器中注册两条路由来处理这些路由：

import VueRouter from 'vue-router'
import Vue from 'vue'
import ProductDetails from './../components/productdetails.vue'
import Home from './../components/home.vue'

Vue.use(VueRouter)

export default new VueRouter({
  mode: 'history',
  routes: [
    { path: '/products/:id', component: ProductDetails },
    { path: '/', component: Home },
  ]
})

我们还没有创建这些组件，不用担心，马上就来，;）

请注意，我们在VueRouter声明中使用了mode：'history'。这一点很重要，否则我们的prerender插件将不会工作。其区别在于路由器将使用history API而不是hashbang来导航。

2.3 把所有东西组合在一起

现在，我们有了数据(store)和路由器，我们需要把他们注册到应用中。更新你的src/main.js文件：

import Vue from 'vue'
import App from './App.vue'
import router from './router'
import { sync } from 'vuex-router-sync'
import store from './store'

sync(store, router)

new Vue({
  store,
  router,
  render: h => h(App)
}).$mount('#app')

很简单吧！正如前面提到的，vuex-router-sync中的sync方法从我们的store中注入状态到当前的路由中。我们稍后再用。

3. 书写Vue组件

有数据感觉真棒，但将它显示出来将会更好。我们即将用到的三个组件：

• Home - 展示产品列表

• Product - 单个产品信息，将被用在Home组件中

• ProductDetails - 产品详情页

他们将被包含在src/components文件夹中。

//Home.vue

<template lang="pug">
    div(class="products")
        div(v-for="product in products", class="product")
            product(:product="product")
</template>

<script>
import Product from './../components/Product.vue'

export default {
  name: 'home',
  components: { Product },
  computed: {
    products(){
      return this.$store.state.products
    }
  }
}
</script>

以上，我们使用store中的状态来获取我们的产品，并对它们进行迭代，来渲染每一个产品。

//Product.vue
<template lang="pug">
  div(class="product")
   router-link(v-bind:to="url").product
      img(v-bind:src="product.image" v-bind:alt="product.name" class="thumbnail" height="200")
      p {{ product.name }}
    
    button(class="snipcart-add-item"
      v-bind:data-item-name="product.name"
      v-bind:data-item-id="product.id"
      v-bind:data-item-image="product.image"
      data-item-url="/"
      v-bind:data-item-price="product.price")
        | Buy it for {{ product.price }}$
 
</template>

<script>
export default {
  name: 'Product',
  props: ['product'],
  computed: {
    url(){
      return `/products/${this.product.id}`
    }
  }
}
</script>

通过路由器，我们链接到其他页面(ProductDetails)，来看看我们的最后一个组件：

//ProductDetails.vue
<template lang="pug">
  div(class="product-details")
    
    img(v-bind:src="product.image" v-bind:alt="product.name" class="thumbnail" height="200")
     
    div(class="product-description" v-bind:href="url")
      p {{ product.name }}
      p {{ product. description}}

      button(class="snipcart-add-item"
        v-bind:data-item-name="product.name"
        v-bind:data-item-id="product.id"
        v-bind:data-item-image="product.image"
        data-item-url="/"
        v-bind:data-item-price="product.price")
          | Buy it for {{ product.price }}$

</template>

<script>
export default {
  name: 'ProductDetails',
  computed: {
    id(){
      return this.$store.state.route.params.id
    },
    product(){
      return this.$store.getters.getProductById(this.id)
    }
  }
}
</script>

这一节的逻辑要稍微复杂些：我们从路由中获取当前的ID，然后通过之前创建的getter获取相关的产品信息。

4. 创建App

我们开始使用刚才创建的组件。

打开App.vue文件，其内容是脚手架(vue init webpack-simple)生成的默认内容。我们来修改它：

<template lang="pug">
  div(id="app")
    TopContext
    router-view

</template>

<script>
import TopContext from './components/TopContext.vue'

export default {
  name: 'app',
  components: { TopContext }
}
</script>

TopContext组件不是很重要，它仅仅是一个header。关键部分是router-view：它将通过VueRouter动态加载组件，而之前与之关联的组件将被替换。

最后我们来更新一下index.html。对于我们的用例来说，我们在src中创建新的目录static，移动index.html文件至static并将其更新为如下内容：

<!DOCTYPE html><html lang="en">
  <head>
    <meta charset="utf-8">
    <title>vue-snipcart</title>
  </head>

  <body>
  
    <div id="app">    
    </div>
  
    <script src="/build.js"></script>
    <script src="https://ajax.googleapis.com/ajax/libs/jquery/2.2.2/jquery.min.js"></script>
    <script src="https://cdn.snipcart.com/scripts/2.0/snipcart.js" data-api-key="YjdiNWIyOTUtZTIyMy00MWMwLTkwNDUtMzI1M2M2NTgxYjE0" id="snipcart"></script>
    <link href="https://cdn.snipcart.com/themes/2.0/base/snipcart.min.css" rel="stylesheet" type="text/css" />
  </body>
</html>

你可以看到，我们在index.html中添加了Snipcart的必要脚本。如果将他们精细的划分到各个组件之中代码看起来会更加干净，但，由于我们所有的View都需要它们，我们便这样做了。

5. 使用Prerender插件处理Vue.js SEO

我们应用中的所有内容都是使用JS动态渲染的，这很不利于搜索引擎优化(SEO)：网页中的异步内容不能被“蜘蛛”(search engine bots)有效的识别并抓取，这样的话，我们的电子商务网站错过了所有有用的“网络爬虫”，这不是一个明智的选择！

让我们使用prerendering技术来为我们的Vue.js应用程序带来更多的SEO机会。

相对于Vue的SSR(服务器端渲染)，prerendering则更容易使用。坦率地说，前者有些矫枉过正了，除非你有大量的路由要处理。另外，这两种技术在实现SEO层面所达到的效果是相似的。

预渲染将使我们能够保持我们的前端作为一种快速，轻量级的静态网站，以便于“蜘蛛”进行爬取。

让我们来看看如何使用它：转到WebPack配置文件，在plugin配置项中添加以下配置：

plugins: [
  new CopyWebpackPlugin([{
    from: 'src/static'
  }]),
  new PrerenderSpaPlugin(
    path.join(__dirname, 'dist'),
    [ '/', '/products/1', '/products/2', '/products/3']
  )
]

好吧，它是如何工作的呢？

CopyWebpackPlugin将会复制static文件夹中的文件到dist文件夹中(只包含引用Vue App的应用程序的视图)。然后，PrerenderSpaPlugin使用PhantomJS加载网页的内容，并将结果作为我们的静态资源。

瞧！我们现在已经为我们的Vue应用程序提供了预渲染的，SEO友好的产品页面。

我们使用如下命令来进行测试：

npm run build

这将生成一个dist文件夹，其中包含生产环境所需的一切。

其他重要的SEO因素

1. 考虑为您的页面添加适当的meta标记和站点地图(sitemap)。您可以在“postProcessHtml”函数(prerender-spa-plugin插件的配置项)中了解有关meta标记的更多信息。

2. 恰当的内容在现代SEO中起了重要作用。建议您确保应用程序中的内容易于创建，编辑和优化。为了授权内容编辑者，请考虑将headless CMS放入组合中并用来构建真正的JAMstack。

3. 现在，HTTPS连接正式成为Google的排名因素。我们在Netlify上托管这个演示，Netlify为我们提供了免费的SSL证书。

4. Mobile-first indexing和 mobile-friendliness也是排名的重要因素。确保您的移动体验与桌面版一样快速完整！

GitHub库和在线演示

来吧，这里是在线演示及代码仓库的地址！

GitHub仓库

在线演示

总结

我之前使用过Vue，本教程的制作过程还是相当顺利的。我花了一个小时在Demo上，在使用CopyWebpackPlugin时遇到了困难，好在我在他们的文档中找到了答案。

我希望这篇文章能鼓励开发人员在一些项目中开始使用Vue。就像我说的，您可以通过开发一个现有项目的一小部分来逐步地开始，我认为这绝对值得一试。我们的开发主管正在使用Vue编写最新的商业仪表盘功能，他非常喜欢Vue。另外，如果配置正确，Vue完全可以驱动具有良好SEO结果的应用程序。

如果你受到了启发，可以看看Awesome-vue，它包含了Vue示例和相关项目。

如果你真的喜爱Vue，cop some swag 或 support the creator

---

如果你觉得这篇文章有价值，请花一点时间分享到Twitter上。有什么遗漏或错误的？有关于Vue的？或其他框架处理SEO的一些想法？现在评论区是你的了！

End

作者：Maxime Laboissonniere

原文地址: Vue.js Tutorial: An Example to Build and Prerender an SEO-Friendly Site

译者：jeneser

译者GitHub：https://github.com/jeneser

版权声明：自由转载-非商用-非衍生-保持署名（创意共享3.0许可证）

勘误&讨论： New issue