前言
分别讨论调用API及使用RouterLink组件两种场景下如何在新的标签页中打开链接/路由
调用 API
vue-router 的路由实例除了常见的 push, replace, go 等接口,还提供了一个很好用的接口 resolve,可用于解析路由,第一个参数类型与 push/replace 一致。
import { useRouter } from 'vue-router'const router = useRouter()function handleGoEditReport({ no }) {const target = router.resolve({name: 'ReportDetail',params: { rid: no },})window.open(target.href, '_blank')
}
与 push 的使用差别不大
RouterLink 组件
vue-router 的 RouterLink 组件是在当前页面内跳转路由,有些场景下会要求在新标签页中打开。
RouterLink 组件实际上还是渲染成 <a>
标签,参考源码
RouterLink renderer 源码片段:
// ...
setup(props, { slots }) {// ...return () => {const children = slots.default && slots.default(link)return props.custom? children: h('a',{'aria-current': link.isExactActive? props.ariaCurrentValue: null,href: link.href,// this would override user added attrs but Vue will still add// the listener, so we end up triggering bothonClick: link.navigate,class: elClass.value,},children)}
},
// ...
未设置 target,该组件属性中也没有关于 target 的属性(源码)。
下面提供几个方案
1. 直接设置 target 属性
由于 RouterLink 默认只有一个 <a>
标签作为根元素,直接在 RouterLink 上设置 target 属性,vue 的特性使它被绑定到 <a>
标签上。
<template><router-link :to="{ name: 'ReportDetail', params: { rid: 'A00000001' } }" target="_blank">GO</router-link>
</template>
这是最简单直接的解决方案,一开始略过了它,因为印象中很早就试过此方案但未生效。既然此方案有效,后面几种方案看看就行了。。。
2. 自定义链接组件
组合式 API - useLink
参照官网示例,承接 RouterLink 所有属性,使用组合式 API 解析得到所需的链接信息,再按具体需求渲染组件。
3. 插槽 + custom 属性
在 RouterLink 的 v-slot 中可以访问与 useLink 组合式函数相同的属性。
基于插槽与 custom 属性,可以如下创建一个简单链接满足需求,这一方案同上一方案比较类似,都需要自行处理 isActive, isExactActive 等状态。原因参阅上面的源码片段 👆
<template><router-link :to="{ name: 'ReportDetail', params: { rid: 'A00000001' } }" :custom="true"><template #default="{ href }"><a :href="href" target="_blank">GO</a></template></router-link>
</template>
vue__target_100">4. 添加 vue 自定义指令-绑定路由 target
由于 RouterLink 组件最终会渲染成 <a>
标签,添加一个指令用于绑定链接的 target 属性即可
main.js 定义并注册自定义指令:
import { createApp } from 'vue'
import App from './App.vue'const app = createApp(App)app.directive('target', {mounted(el, binding) {// 将元素的 target 属性设置为绑定值const { value: target = '_blank' } = bindingel.setAttribute('target', target)},
})app.mount('#app')
使用:
<template><router-link v-target :to="{ name: 'ReportDetail', params: { rid: 'A00000001' } }">GO</router-link>
</template>