在 Vue SPA 应用中,如果想要修改HTML的头部标签,或许,你会在代码里,直接这么做



// 改下title
document.title = 'what?'
// 引入一段script
let s = document.createElement('script')
s.setAttribute('src', './vconsole.js')
document.head.appendChild(s)
// 修改meta信息,或者给html标签添加属性...
// 此处省略一大坨代码...


  今天给大家介绍一种更优雅的方式,去管理头部标签: vue-meta。借用​​vue-meta github ​​上的介绍,基于Vue 2.0 的 vue-meta 插件,主要用于管理HMTL头部标签,同时也支持SSR。

  vue-meta有以下特点:

  1、在组件内设置 metaInfo,便可轻松实现头部标签的管理

  2、metaInfo 的数据都是响应的,如果数据变化,头部信息会自动更新

  3、支持 SSR

一、使用方法

  安装:npm install vue-meta --save

  引入:在main.js里引入



import VueMeta from 'vue-meta'
Vue.use(VueMeta)


  然后就可以开始使用metaInfo了。在任何一个component中都可以定义 metaInfo 属性



<script>
export default {
name: 'App',
metaInfo: {
// 如果子component中没有定义 metaInfo.title ,会默认使用这个title
title: '首页',
titleTemplate: '%s | 我的Vuejs网站'
}
}
</script>



<script>
export default {
name: 'Home',
metaInfo: {
// 这里的 title 会替换 titleTemplate 中的字符占位
title: '这是一个首页',
// 这里定义titleTemplate会覆盖App.vue中的定义
titleTemplate: null
}
}
</script>


  如果想定义其他meta信息,可以使用vue-meta的API。例如meta



{
metaInfo: {
meta: [
{ charset: 'utf-8' },
{ name: 'viewport', content: 'width=device-width, initial-scale=1' }
]
}
}


  异步请求数据定义:如果component中使用了异步请求数据,可以使用 metaInfo() 方法



metaInfo () {
return {
title: this.title,
meta: [
{ vmid: 'description', name: 'description', content: this.description }
]
}
},


  其中,title,description都可以是异步获取的数据。

二、源码分析

1、怎么区分 client 和 server渲染?

  vue-meta 会在 beforeCreate() 钩子函数中,将组件中设置的 metaInfo ,放在 this.$metaInfo 中。我们可以在其他生命周期中,访问 this.$metaInfo 下的属性。



if (typeof this.$options[options.keyName] === 'function') {
if (typeof this.$options.computed === 'undefined') {
this.$options.computed = {}
}
this.$options.computed.$metaInfo = this.$options[options.keyName]
}


  vue-meta 会在created等生命周期的钩子函数中,监听 $metaInfo 的变化,如果发生改变,就调用 $meta 下的 refresh 方法。这也是 metaInfo 做到响应的原因。



created () {
if (!this.$isServer && this.$metaInfo) {
this.$watch('$metaInfo', () => {
batchID = batchUpdate(batchID, () => this.$meta().refresh())
})
}
},


  Server端,主要是暴露 $meta 下的 inject 方法,调用 inject 方法,会返回对应的信息。

2、client 和 server端 是如何修改标签的?

  client端 修改标签,就是本文开头提到的 通过原生js,直接修改



return function updateTitle (title = document.title) {
  document.title = title
}


  server端,就是通过 text方法,返回string格式的标签



return function titleGenerator (type, data) {
return {
text () {
return `<${type} ${attribute}="true">${data}</${type}>`
}
}
}


3、__dangerouslyDisableSanitizers 做了什么?

  vue-meta 默认会对特殊字符串进行转义,如果设置了 __dangerouslyDisableSanitizers,就不会对再做转义处理。



const escapeHTML = (str) => typeof window === 'undefined'
// server-side escape sequence
? String(str)
.replace(/&/g, '&')
.replace(/</g, '<')
.replace(/>/g, '>')
.replace(/"/g, '"')
.replace(/'/g, ''')
// client-side escape sequence
: String(str)
.replace(/&/g, '\u0026')
.replace(/</g, '\u003c')
.replace(/>/g, '\u003e')
.replace(/"/g, '\u0022')
.replace(/'/g, '\u0027')