useSeoMeta
useSeoMeta 可组合函数允许你将站点的 SEO 元标签定义为一个扁平对象,并提供完整的 TypeScript 支持。
这有助于你避免常见的错误,例如使用 name
而不是 property
,以及拼写错误——提供超过 100 种完全类型化的元标签。
这是向你的站点添加元标签的推荐方式,因为它具备 XSS 安全性并支持完整的 TypeScript。
使用
app/app.vue
<script setup lang="ts">
useSeoMeta({
title: 'My Amazing Site',
ogTitle: 'My Amazing Site',
description: 'This is my amazing site, let me tell you all about it.',
ogDescription: 'This is my amazing site, let me tell you all about it.',
ogImage: 'https://example.com/image.png',
twitterCard: 'summary_large_image',
})
</script>
插入响应式标签时,应使用计算属性的 getter 语法 (() => value
)
app/app.vue
<script setup lang="ts">
const title = ref('My title')
useSeoMeta({
title,
description: () => `This is a description for the ${title.value} page`,
})
</script>
参数
共有超过 100 个参数。请参阅源代码中完整的参数列表.
性能
在大多数情况下,SEO 元标签不需要是响应式的,因为搜索引擎机器人主要扫描初始页面加载。
为了获得更好的性能,当元标签不需要是响应式时,你可以将 useSeoMeta
调用包装在仅限服务器的条件中。
app/app.vue
<script setup lang="ts">
if (import.meta.server) {
// These meta tags will only be added during server-side rendering
useSeoMeta({
robots: 'index, follow',
description: 'Static description that does not need reactivity',
ogImage: 'https://example.com/image.png',
// other static meta tags...
})
}
const dynamicTitle = ref('My title')
// Only use reactive meta tags outside the condition when necessary
useSeoMeta({
title: () => dynamicTitle.value,
ogTitle: () => dynamicTitle.value,
})
</script>
这以前使用 useServerSeoMeta
可组合函数,但它已被弃用,转而采用此方法。