Vue动态修改页面Title(浏览器页签名称)的三种方法

 更新时间:2025年03月28日 11:10:59   作者:阿达C  
在开发 Vue 项目时,我们经常需要根据不同的页面动态修改浏览器的页签标题(title),那么,如何在 Vue 项目中实现动态修改 document.title 呢?本文将介绍三种实用方法,并结合代码示例,助你轻松实现,需要的朋友可以参考下

前言

在开发 Vue 项目时,我们经常需要根据不同的页面动态修改浏览器的页签标题(title),比如:

  • 在电商网站中,展示商品详情时,标题应该是商品名称 - 商城名称
  • 在后台管理系统中,切换不同的页面时,页签名称应随之变化。
  • 在聊天应用中,当有新消息时,页签标题可以变成**(1)新消息 - ChatApp**,吸引用户注意。

那么,如何在 Vue 项目中实现动态修改 document.title 呢?本文将介绍三种实用方法,并结合代码示例,助你轻松实现!

方法一:在组件的 mounted 钩子中修改 title

最简单的方法是在 Vue 组件的 mounted 钩子中直接修改 document.title

示例代码

<template>
  <div>
    <h1>商品详情页</h1>
  </div>
</template>

<script>
export default {
  data() {
    return {
      productName: "Vue 3 官方指南"
    };
  },
  mounted() {
    document.title = `${this.productName} - 我的商城`;
  }
};
</script>

缺点

  • 适用于单个组件,但不适合全局管理标题。
  • 如果页面复杂,需要在多个组件中重复写 document.title,代码难以维护。

方法二:使用 Vue Router 监听路由变化,动态修改 title

如果你的项目是多页面应用(SPA),通常会使用 Vue Router 来管理页面切换。在这种情况下,我们可以在全局导航守卫中监听路由变化,并根据 meta 字段动态修改 title

步骤 1:在路由中定义 meta.title

// router/index.js
import { createRouter, createWebHistory } from "vue-router";
import Home from "@/views/Home.vue";
import Product from "@/views/Product.vue";

const routes = [
  {
    path: "/",
    name: "Home",
    component: Home,
    meta: { title: "首页 - 我的商城" }
  },
  {
    path: "/product/:id",
    name: "Product",
    component: Product,
    meta: { title: "商品详情 - 我的商城" }
  }
];

const router = createRouter({
  history: createWebHistory(),
  routes
});

export default router;

步骤 2:在 router.beforeEach 中监听并修改 document.title

// main.js
import { createApp } from "vue";
import App from "./App.vue";
import router from "./router";

const app = createApp(App);

router.beforeEach((to, from, next) => {
  if (to.meta.title) {
    document.title = to.meta.title;
  }
  next();
});

app.use(router).mount("#app");

效果

  • 当用户切换到 Home.vue 时,页面 title 自动变为 “首页 - 我的商城”
  • 当用户进入 Product.vue 时,title 变为 “商品详情 - 我的商城”

优点

  • 适用于多页面应用(SPA),全局管理 title,无需在每个组件手动修改。
  • 遵循 Vue Router 逻辑,代码更清晰、易维护。

缺点

  • 只能基于 meta.title 修改 title,如果 title 需要动态数据(如商品名称),仍需手动处理。

方法三:封装全局 useTitle 组合式 API(Vue 3 推荐)

在 Vue 3 组合式 API 中,我们可以封装一个 useTitle 函数,使 title 绑定到一个 ref 变量,从而在任何组件中轻松修改。

步骤 1:创建 useTitle 组合式 API

// composables/useTitle.js
import { watchEffect } from "vue";

export function useTitle(newTitle) {
  watchEffect(() => {
    document.title = newTitle.value;
  });
}

步骤 2:在组件中使用 useTitle

<template>
  <div>
    <h1>{{ productName }}</h1>
    <button @click="changeTitle">修改标题</button>
  </div>
</template>

<script>
import { ref } from "vue";
import { useTitle } from "@/composables/useTitle";

export default {
  setup() {
    const productName = ref("Vue 3 官方指南");
    const title = ref(`${productName.value} - 我的商城`);

    useTitle(title); // 绑定 title 到页面

    const changeTitle = () => {
      productName.value = "Vue 3 深入解析";
      title.value = `${productName.value} - 我的商城`;
    };

    return { productName, changeTitle };
  }
};
</script>

效果

  • 进入页面时,title 自动变为 “Vue 3 官方指南 - 我的商城”
  • 点击修改标题按钮后,title 动态变为 “Vue 3 深入解析 - 我的商城”

优点

  • 响应式 title:当 title 变化时,浏览器 title 自动更新。
  • 可复用性高useTitle 可以在任何组件中使用,无需手动 watch document.title
  • Vue 3 组合式 API 友好,符合现代开发习惯。

缺点

  • 仅适用于 Vue 3,Vue 2 需要使用 watch 或 computed 进行手动监听。

总结:哪种方法最适合你?

方法适用场景代码复杂度推荐指数
mounted 直接修改 title适用于简单单页应用⭐⭐
Vue Router meta.title适用于 Vue Router 多页面应用⭐⭐⭐⭐⭐⭐⭐
useTitle 组合式 API适用于 Vue 3 组件内动态修改 title⭐⭐⭐⭐⭐⭐⭐⭐

如果你只是需要在单个页面修改 title方法一(mounted足够。

如果你在Vue Router 项目中管理 title,建议使用方法二(meta.title

如果你想要响应式 title 绑定,并希望代码更清晰,**方法三(useTitle 组合式 API)**是最佳选择!

以上就是Vue动态修改页面Title(浏览器页签名称)的三种方法的详细内容,更多关于Vue动态修改页面Title的资料请关注脚本之家其它相关文章!

相关文章

  • mpvue微信小程序开发之实现一个弹幕评论

    mpvue微信小程序开发之实现一个弹幕评论

    这篇文章主要介绍了mpvue小程序开发之 实现一个弹幕评论功能,本文通过实例讲解的非常详细,具有一定的参考借鉴价值,需要的朋友可以参考下
    2019-11-11
  • vue如何批量引入组件、注册和使用详解

    vue如何批量引入组件、注册和使用详解

    这篇文章主要给大家介绍了关于vue如何批量引入组件、注册和使用的相关资料,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2021-05-05
  • vue学习笔记之作用域插槽实例分析

    vue学习笔记之作用域插槽实例分析

    这篇文章主要介绍了vue学习笔记之作用域插槽,结合实例形式分析了vue.js作用域插槽基本使用方法及操作注意事项,需要的朋友可以参考下
    2020-02-02
  • vue项目基于WebRTC实现一对一音视频通话

    vue项目基于WebRTC实现一对一音视频通话

    这篇文章主要介绍了vue项目基于WebRTC实现一对一音视频通话效果,实现代码分为前端和后端两部分代码,需要的朋友可以参考下
    2024-05-05
  • Vue环境搭建+VSCode+Win10的详细教程

    Vue环境搭建+VSCode+Win10的详细教程

    这篇文章主要介绍了Vue环境搭建+VSCode+Win10,本文给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2020-08-08
  • vue中this.$refs有值,但无法获取ref的值问题及解决

    vue中this.$refs有值,但无法获取ref的值问题及解决

    这篇文章主要介绍了vue中this.$refs有值,但无法获取ref的值问题及解决方案,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2023-01-01
  • 一文详解vue中侦听器的使用

    一文详解vue中侦听器的使用

    这篇文章主要为大家详细介绍了vue中侦听器使用的相关知识,文中的示例代码讲解详细,具有一定的借鉴价值,有需要的小伙伴可以跟随小编一起学习一下
    2007-02-02
  • el-tooltip根据条件控制显示的示例代码

    el-tooltip根据条件控制显示的示例代码

    这篇文章主要介绍了el-tooltip根据条件控制显示的示例代码,包括列表型和树状图型,本文通过示例代码给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友参考下吧
    2023-12-12
  • vue3如何定义全局组件

    vue3如何定义全局组件

    本文介绍了如何在Vue3中注册和使用全局组件,并解决了通过template定义组件时出现的警告问题,具体方法是在vite.config.js文件中配置Vue构建版本为vue.esm-bundler.js,以支持运行时编译,此操作确保全局组件可以正常工作并解决了编译警告
    2024-10-10
  • vue实现带小数点的星星评分

    vue实现带小数点的星星评分

    这篇文章主要为大家详细介绍了vue实现带小数点的星星评分,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2021-09-09

最新评论