Vue / 系统课时

页面缓存与滚动行为

页面缓存与滚动行为

页面缓存的目标不是“让页面永远不销毁”,而是让用户返回列表、表单或详情页时,保留合适的组件实例、滚动位置和数据状态,同时确保刷新后仍能从路由与接口恢复页面。这里给出一套可控的 KeepAlive、缓存键、滚动恢复与刷新策略。

学习目标

  • 用路由元信息控制哪些页面进入 KeepAlive,并选择稳定的缓存键
  • 配置 Vue Router 的滚动恢复,区分返回导航与普通跳转
  • 设计软刷新、重新激活与浏览器硬刷新的数据恢复策略

先确定缓存边界

KeepAlive 缓存的是组件实例,不是整个浏览器页面。适合缓存列表筛选结果、分页位置、未提交的轻量 UI 状态;登录态、关键业务数据或必须实时刷新的服务端状态,不应只依赖组件缓存。

页面缓存、滚动与刷新关系

下面是 App.vue 的片段示例,依赖已经安装并注册 Vue Router,且需要缓存的路由都具有唯一 name。

vue
<template>
  <RouterView v-slot="{ Component, route }">
    <KeepAlive :max="10">
      <component
        v-if="route.meta.keepAlive"
        :is="Component"
        :key="route.name"
      />
    </KeepAlive>

    <component
      v-if="!route.meta.keepAlive"
      :is="Component"
      :key="route.name"
    />
  </RouterView>
</template>

预期结果:标记 keepAlive: true 的页面离开后进入最多 10 个实例的缓存池,再次返回时优先复用原实例;未标记的页面按普通路由组件处理。

不要默认用 route.fullPath 做缓存键。查询参数频繁变化时,它会为同一业务页面创建大量缓存实例。通常使用 route.name;只有确实要按某个业务标识拆分缓存时,才把必要的 params 拼入键中。

配置滚动恢复

Vue Router 的 scrollBehavior 能可靠处理“普通跳转回顶部”和“浏览器前进后退恢复位置”两个主场景。下面是 router/index.ts 的片段示例,路由数组可替换为项目自己的配置。

ts
import { createRouter, createWebHistory } from 'vue-router'

declare module 'vue-router' {
  interface RouteMeta {
    keepAlive?: boolean
  }
}

export const router = createRouter({
  history: createWebHistory(),
  routes: [
    {
      path: '/orders',
      name: 'orders',
      component: () => import('../views/OrdersPage.vue'),
      meta: { keepAlive: true },
    },
    {
      path: '/orders/:id',
      name: 'order-detail',
      component: () => import('../views/OrderDetailPage.vue'),
    },
  ],
  scrollBehavior(to, _from, savedPosition) {
    if (savedPosition) return savedPosition
    if (to.hash) return { el: to.hash, top: 64 }
    return { top: 0 }
  },
})

预期结果:浏览器后退或前进时优先恢复历史滚动位置;新进入页面时滚到顶部;带锚点的地址滚到目标元素,并为固定头部保留 64 像素偏移。实际滚动距离会随页面高度而不同。

页面重新激活时刷新数据

缓存页再次出现会触发 onActivated。它适合做“数据过期才刷新”,而不是每次激活都无条件请求。下面是 OrdersPage.vue 的片段示例,假设 fetchOrders 返回订单数组。

vue
<script setup lang="ts">
import { onActivated, onMounted, ref } from 'vue'

type Order = { id: string; status: string }

const orders = ref<Order[]>([])
const loading = ref(false)
const loadedAt = ref(0)

async function fetchOrders(): Promise<Order[]> {
  const response = await fetch('/api/orders')
  if (!response.ok) throw new Error(`HTTP ${response.status}`)
  return response.json() as Promise<Order[]>
}

async function load(): Promise<void> {
  if (loading.value) return

  loading.value = true
  try {
    orders.value = await fetchOrders()
    loadedAt.value = Date.now()
  } finally {
    loading.value = false
  }
}

async function refreshIfStale(): Promise<void> {
  if (Date.now() - loadedAt.value > 30_000) {
    await load()
  }
}

onMounted(load)
onActivated(refreshIfStale)
</script>

预期结果:首次进入页面加载数据;30 秒内从缓存返回时直接复用现有状态,超过 30 秒再请求接口。真实请求地址、响应字段与过期时间应按项目约定调整。

区分软刷新与硬刷新

软刷新应优先重新请求当前页面数据,而不是粗暴重建整个应用。硬刷新会清空 KeepAlive 与其他内存状态,因此页面必须能仅凭 URL、持久化会话和后端接口重新构造。

对于表单草稿或筛选条件,要先判断它们是否应该跨刷新存在:应该共享或可收藏的筛选条件放入 query;只在当前访问周期有效的状态留在组件;需要跨页面长期复用的业务状态交给 Pinia,并独立设计持久化与失效规则。

当缓存键稳定、滚动恢复与导航类型匹配,并且缓存页有明确的重新取数条件时,页面体验才会同时具备“返回快”和“数据可信”两个特征。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

页面缓存与滚动行为

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通