单页应用后退不刷新方案（vue & react）

Z时代
2024-01-10
分类：综合

react

引言

前进刷新，后退不刷新，是一个类似app页面的特点，要在单页web应用中做后退不刷新，却并非一件易事。

为什么麻烦

spa的渲染原理（以vue为例）：url的更改触发onHashChange/pushState/popState/replaceState，通过url中的pathName去匹配路由中定义的组件，加载进来并实例化渲染在项目的出口router-view中。

换言之，一个实例的解析渲染意味着另外一个实例的销毁，因为渲染出口只有一个。

keep-alive为什么不行？因为keep-alive的原理是将实例化后的组件存储起来，当下次url匹配到了改组件时，优先从存储里面取。

但是vue只提供了入存储的方式，没提供删存储的方式，所以没法实现“前进刷新”。

有一种方案是手动根据to和from去做前进后退判断，这种判断不能应对复杂的跳转逻辑，可维护性也很差。

有坑的社区方案（以vue为例）

vue-page-stack，vue-navigation。

这两个方案都有明显缺点：前者不支持嵌套路由，在一些场景下会出现url变化，页面完全无反应的情况，后者存在类似的bug。并且这两种方案侵入性都很强，因为他们都是基于vue-router的魔改。并且会在url中增加无意义的多余字段（stackID）

目前不错的方案

现在有一个可行且简单的方案：嵌套子路由 + 叠页面。

叠页面的灵感：原生应用中的webview in webview，多页应用中的window in window。

要在spa中实现后退不刷新，本质是要实现多实例共存。

这个方案的核心在于：通过嵌套子路由实现多实例共存，通过css的absolute实现视觉上的页面堆叠。

vue中的实现

在routes配置文件中：

import Home from "../views/Home.vue";

const routes = [
  {
    path: "/home",
    name: "Home",
    component: Home,
    children: [
      {
        path: "sub",
        component: () =>
          import(/* webpackChunkName: "sub" */ "../views/Sub.vue"),
      },
    ],
  },
];

export default routes;

主页：

<template>
  <div class="home">
    <input v-model="inputValue" />
    <h3>{{ inputValue }}</h3>
    <button @click="handleToSub">to sub</button>
    <router-view @reload="handleReload" />
  </div>
</template>

<script>
export default {
  name: "Home",
  data() {
    return {
      inputValue: "",
    };
  },
  methods: {
    handleToSub() {
      // 注意路由格式，是基于上一个路由/home下面的sub，不是独立的/sub
      this.$router.push("/home/sub");
    },

    handleReload(val) {
      // 这里可以做一些重新获取数据的操作，比如在详情页修改数据，返回后重新拉取列表
      console.log("reload", val);
    },
  },
  mounted() {
    // 子页面返回，不会重新跑生命周期
    console.log("mounted");
  },
};
</script>

<style scoped>
.home {
  position: relative;
}
</style>

子页面：

<template>
  <div class="sub">
    <h1>This is Sub page</h1>
  </div>
</template>

<script>
export default {
  beforeDestroy() {
    // 可以传自定义参数，如果没需要，也可以不做
    this.$emit("reload", 123);
  },
};
</script>

<style scoped>
.sub {
  position: absolute;
  left: 0;
  top: 0;
  width: 100%;
  height: 100%;
  background-color: #fff;
}
</style>

react" style="line-height: inherit; margin: 1.5em 5px 2em 0; font-weight: bold; font-size: 1.3em; padding: 8px 15px; letter-spacing: 2px; background-image: linear-gradient(135deg, rgba(0, 188, 212, 1), rgba(63, 81, 181, 1)); background-color: rgba(63, 81, 181, 1); color: rgba(255, 255, 255, 1); border-left: 10px solid rgba(51, 51, 51, 1); border-radius: 5px; text-shadow: 1px 1px 1px rgba(102, 102, 102, 1); box-shadow: 1px 1px 2px rgba(102, 102, 102, 1)">react中的实现

在routes中：

import { Route } from "react-router-dom";

const Routes = () => {
  return (
    <>
      {/* 这里不能加exact，因为要先匹配父页面再匹配子页面 */}
      <Route path="/home" component={lazy(() => import("../views/Home"))} />
    </>
  );
};

export default Routes;

主页：

import React, { useEffect, useState } from "react";
import { Route, useHistory } from "react-router-dom";
import styled from "styled-components";
import Sub from "./Sub";

const HomeContainer = styled.div`
  position: relative;
`;

const Home: React.FC = () => {
  const [inputValue, setInputValue] = useState("");
  const history = useHistory();

  const handleToSub = () => {
    history.push("/home/sub");
  };

  const handleReload = (val: number) => {
    console.log("reload", val);
  };

  useEffect(() => {
    console.log("mounted");
  }, []);

  return (
    <HomeContainer>
      <input
        value={inputValue}
        onChange={(e) => setInputValue(e.target.value)}
      />
      <h3>{inputValue}</h3>
      <button onClick={handleToSub}>to sub</button>
      <Route
        path="/home/sub"
        component={() => <Sub handleReload={handleReload} />}
      />
    </HomeContainer>
  );
};

export default Home;

子页面：

import React from "react";
import styled from "styled-components";

const SubContainer = styled.div`
  position: absolute;
  left: 0;
  top: 0;
  width: 100%;
  height: 100%;
  background-color: #fff;
`;

type SubProps = {
  handleReload: (val: number) => void;
};

const Sub: React.FC<SubProps> = ({ handleReload }) => {
  useEffect(() => {
      return () => handleReload(123);
  }, []);

  return (
    <SubContainer>
      <h1>This is Sub page</h1>
    </SubContainer>
  );
};

export default Sub;