import { defineComponent, h, ref, resolveComponent, PropType, computed, DefineComponent, ComputedRef, onMounted, onBeforeUnmount } from 'vue' import { RouteLocationRaw, Router } from 'vue-router' import { hasProtocol } from 'ufo' import { navigateTo, useRouter } from '../composables/router' import { useNuxtApp } from '../nuxt' const firstNonUndefined = (...args: (T | undefined)[]) => args.find(arg => arg !== undefined) const DEFAULT_EXTERNAL_REL_ATTRIBUTE = 'noopener noreferrer' export type NuxtLinkOptions = { componentName?: string externalRelAttribute?: string | null activeClass?: string exactActiveClass?: string prefetchedClass?: string } export type NuxtLinkProps = { // Routing to?: string | RouteLocationRaw href?: string | RouteLocationRaw external?: boolean replace?: boolean custom?: boolean // Attributes target?: string | null rel?: string | null noRel?: boolean prefetch?: boolean noPrefetch?: boolean // Styling activeClass?: string exactActiveClass?: string // Vue Router's `` additional props ariaCurrentValue?: string } // Polyfills for Safari support // https://caniuse.com/requestidlecallback const requestIdleCallback: Window['requestIdleCallback'] = process.server ? undefined as any : (globalThis.requestIdleCallback || ((cb) => { const start = Date.now() const idleDeadline = { didTimeout: false, timeRemaining: () => Math.max(0, 50 - (Date.now() - start)) } return setTimeout(() => { cb(idleDeadline) }, 1) })) const cancelIdleCallback: Window['cancelIdleCallback'] = process.server ? null as any : (globalThis.cancelIdleCallback || ((id) => { clearTimeout(id) })) export function defineNuxtLink (options: NuxtLinkOptions) { const componentName = options.componentName || 'NuxtLink' const checkPropConflicts = (props: NuxtLinkProps, main: keyof NuxtLinkProps, sub: keyof NuxtLinkProps): void => { if (process.dev && props[main] !== undefined && props[sub] !== undefined) { console.warn(`[${componentName}] \`${main}\` and \`${sub}\` cannot be used together. \`${sub}\` will be ignored.`) } } return defineComponent({ name: componentName, props: { // Routing to: { type: [String, Object] as PropType, default: undefined, required: false }, href: { type: [String, Object] as PropType, default: undefined, required: false }, // Attributes target: { type: String as PropType, default: undefined, required: false }, rel: { type: String as PropType, default: undefined, required: false }, noRel: { type: Boolean as PropType, default: undefined, required: false }, // Prefetching prefetch: { type: Boolean as PropType, default: undefined, required: false }, noPrefetch: { type: Boolean as PropType, default: undefined, required: false }, // Styling activeClass: { type: String as PropType, default: undefined, required: false }, exactActiveClass: { type: String as PropType, default: undefined, required: false }, prefetchedClass: { type: String as PropType, default: undefined, required: false }, // Vue Router's `` additional props replace: { type: Boolean as PropType, default: undefined, required: false }, ariaCurrentValue: { type: String as PropType, default: undefined, required: false }, // Edge cases handling external: { type: Boolean as PropType, default: undefined, required: false }, // Slot API custom: { type: Boolean as PropType, default: undefined, required: false } }, setup (props, { slots }) { const router = useRouter() // Resolving `to` value from `to` and `href` props const to: ComputedRef = computed(() => { checkPropConflicts(props, 'to', 'href') return props.to || props.href || '' // Defaults to empty string (won't render any `href` attribute) }) // Resolving link type const isExternal = computed(() => { // External prop is explicitly set if (props.external) { return true } // When `target` prop is set, link is external if (props.target && props.target !== '_self') { return true } // When `to` is a route object then it's an internal link if (typeof to.value === 'object') { return false } return to.value === '' || hasProtocol(to.value, true) }) // Prefetching const prefetched = ref(false) const el = process.server ? undefined : ref(null) if (process.client) { checkPropConflicts(props, 'prefetch', 'noPrefetch') const shouldPrefetch = props.prefetch !== false && props.noPrefetch !== true && typeof to.value === 'string' && !isSlowConnection() if (shouldPrefetch) { const nuxtApp = useNuxtApp() const observer = useObserver() let idleId: number let unobserve: Function | null = null onMounted(() => { idleId = requestIdleCallback(() => { if (el?.value) { unobserve = observer!.observe(el.value, async () => { unobserve?.() unobserve = null await Promise.all([ nuxtApp.hooks.callHook('link:prefetch', to.value as string).catch(() => {}), preloadRouteComponents(to.value as string, router).catch(() => {}) ]) prefetched.value = true }) } }) }) onBeforeUnmount(() => { if (idleId) { cancelIdleCallback(idleId) } unobserve?.() unobserve = null }) } } return () => { if (!isExternal.value) { // Internal link return h( resolveComponent('RouterLink'), { ref: process.server ? undefined : (ref: any) => { el!.value = ref?.$el }, to: to.value, ...((prefetched.value && !props.custom) ? { class: props.prefetchedClass || options.prefetchedClass } : {}), activeClass: props.activeClass || options.activeClass, exactActiveClass: props.exactActiveClass || options.exactActiveClass, replace: props.replace, ariaCurrentValue: props.ariaCurrentValue, custom: props.custom }, slots.default ) } // Resolves `to` value if it's a route location object // converts `'''` to `null` to prevent the attribute from being added as empty (`href=""`) const href = typeof to.value === 'object' ? router.resolve(to.value)?.href ?? null : to.value || null // Resolves `target` value const target = props.target || null // Resolves `rel` checkPropConflicts(props, 'noRel', 'rel') const rel = (props.noRel) ? null // converts `""` to `null` to prevent the attribute from being added as empty (`rel=""`) : firstNonUndefined(props.rel, options.externalRelAttribute, href ? DEFAULT_EXTERNAL_REL_ATTRIBUTE : '') || null const navigate = () => navigateTo(href, { replace: props.replace }) // https://router.vuejs.org/api/#custom if (props.custom) { if (!slots.default) { return null } return slots.default({ href, navigate, route: router.resolve(href!), rel, target, isActive: false, isExactActive: false }) } return h('a', { href, rel, target }, slots.default?.()) } } }) as unknown as DefineComponent } export default defineNuxtLink({ componentName: 'NuxtLink' }) // --- Prefetching utils --- function useObserver () { if (process.server) { return } const nuxtApp = useNuxtApp() if (nuxtApp._observer) { return nuxtApp._observer } let observer: IntersectionObserver | null = null type CallbackFn = () => void const callbacks = new Map() const observe = (element: Element, callback: CallbackFn) => { if (!observer) { observer = new IntersectionObserver((entries) => { for (const entry of entries) { const callback = callbacks.get(entry.target) const isVisible = entry.isIntersecting || entry.intersectionRatio > 0 if (isVisible && callback) { callback() } } }) } callbacks.set(element, callback) observer.observe(element) return () => { callbacks.delete(element) observer!.unobserve(element) if (callbacks.size === 0) { observer!.disconnect() observer = null } } } const _observer = nuxtApp._observer = { observe } return _observer } function isSlowConnection () { if (process.server) { return } // https://developer.mozilla.org/en-US/docs/Web/API/Navigator/connection const cn = (navigator as any).connection as { saveData: boolean, effectiveType: string } | null if (cn && (cn.saveData || /2g/.test(cn.effectiveType))) { return true } return false } async function preloadRouteComponents (to: string, router: Router & { _nuxtLinkPreloaded?: Set } = useRouter()) { if (process.server) { return } if (!router._nuxtLinkPreloaded) { router._nuxtLinkPreloaded = new Set() } if (router._nuxtLinkPreloaded.has(to)) { return } router._nuxtLinkPreloaded.add(to) const components = router.resolve(to).matched .map(component => component.components?.default) .filter(component => typeof component === 'function') const promises: Promise[] = [] for (const component of components) { const promise = Promise.resolve((component as Function)()).catch(() => {}) promises.push(promise) } await Promise.all(promises) }