Nuxt.js中如何将异步加载的WordPress文章标题配置为og:title元标签
实现Nuxt中动态设置og:title的完整方案
问题根因
默认情况下Nuxt的head配置如果写为静态对象,会在组件实例初始化阶段就执行,这个时机早于created钩子里发起的$http异步请求的返回时间,此时data中的WordPress文章标题还是初始空值,自然没法正确赋值给og:title。
基础实现(适配客户端动态更新场景)
只要把head从静态对象改写为返回配置的函数形式,Nuxt内置的vue-meta就会自动建立响应式绑定:当异步请求拿到文章标题、更新组件data时,页面上的og:title元标签会自动同步更新。
代码示例
<script> export default { data() { return { // 初始化设置默认标题,避免空值 postTitle: '页面默认标题' } }, // head 改为函数形式,可通过this访问组件上的响应式数据 head() { return { title: this.postTitle, meta: [ { // 必须设置唯一hid,用于元标签的覆盖去重 hid: 'og:title', property: 'og:title', content: this.postTitle } ] } }, async created() { // 原有$http请求逻辑不变 const postRes = await this.$http.$get('WordPress文章接口地址') // 接口返回后赋值给响应式data this.postTitle = postRes.title.rendered } } </script>
实现注意点
- 每个动态渲染的元标签必须配置唯一的
hid标识,这是vue-meta定位同类型标签、执行覆盖更新的核心依据,缺失该属性会出现SSR和客户端生成的同类型标签重复渲染的问题 - data中必须为文章标题设置合理默认值,避免服务端初始输出的HTML出现空的og:title字段
优化方案(适配SEO/社交爬虫抓取场景)
如果需要让服务端渲染输出的初始HTML就携带正确的og:title(适配不执行JS的搜索引擎、社交平台爬虫),可以把原本放在created中的$http请求逻辑移到Nuxt的asyncData钩子里:asyncData的执行时机早于组件初始化、早于head配置执行,数据加载完成后才会开始渲染组件,此时head已经能读取到正确的文章标题,会直接把值注入到初始HTML的元标签中,不需要等待客户端水合后再做更新。
代码示例
<script> export default { // 在asyncData中提前拉取文章数据 async asyncData({ $http }) { const postRes = await $http.$get('WordPress文章接口地址') // 返回的对象会自动合并到组件data中 return { postTitle: postRes.title.rendered } }, head() { return { title: this.postTitle, meta: [ { hid: 'og:title', property: 'og:title', content: this.postTitle } ] } } } </script>
常见排查点
- 页面跳转后og:title不更新:检查head是函数形式还是静态对象,静态对象仅会在组件首次初始化时执行一次,路由切换后不会重新读取最新的data值
- 服务端输出的og:title为空:检查请求是否写在
mounted钩子里,该钩子仅在客户端运行,服务端渲染阶段不会触发,无法提前获取数据 - 元标签重复:检查动态meta标签是否配置了唯一的
hid属性
内容的提问来源于stack exchange,提问作者Nicolas Gruwe
相关产品推荐
相关产品推荐

