React Router 进阶技巧

本文介绍在工程中经常用到的 react-router 的技巧:

  • 🤔️ 如何在 TypeScript 中使用?
  • 🤔️exactstrict的区别?
  • 🤔️ 如何封装路由配置组件?
  • 🤔️ 如何响应路由变化?

专注前端与算法的系列干货分享,转载请声明出处:原文链接: xxoo521.com

# 如何在 TypeScript 中使用?

有时候会需要使用编程式导航,比如上方导航栏里面选项,响应按钮事件,进行路由跳转。react 的做法是通过高阶函数,函数体内部向组件的 props 注册一些路由的方法,最后返回一个新的组件。

下面是一个结合 TypeScript 使用 withRouter 的例子:

interface NavigationState {
  routes: Array<{
    path: string;
    name: string;
    key: string;
  }>;
  selectedKey: string;
}

interface NavigationProps {
  name: string;
}

class Navigation extends Component<
  RouteComponentProps & NavigationProps, // 使用「交叉类型」来处理Props的关系
  NavigationState
> {
  state = {
    routes: [],
    selectedKey: "1"
  };

  toggleRoute = (event: ClickParam) => {
    this.props.history.push(path); // route的方法已经被注册到了Props上
  };

  render() {
      // ...
    );
  }
}

export default withRouter(Navigation);

# exactstrict的区别?

为了方便说明,假设路由为/a

  • 若将exact设置为 true,路由相同(包括有斜杠)即可匹配。路由/a可以和/a//a匹配。
  • 若将strict设置为 true,路由相同(不包括斜杠)可匹配。路由/a可以和/a匹配,不能和/a/匹配。

两者相比,strict匹配更严格。但一般常将exact设置为 true。

# 如何封装路由配置组件?

可以直接使用 react-router-config 组件。也可以根据原理,简单封装,代码如下:

import { Route, Switch, SwitchProps, RouteProps } from "react-router-dom";

function renderRoutes(params: {
  routes: RouteProps[];
  switchProps?: SwitchProps;
}) {
  const { switchProps, routes } = params;
  return (
    <Switch {...switchProps}>
      {routes.map((route, index) => (
        <Route
          key={index}
          path={route.path}
          component={route.component}
          exact={route.exact || true}
          strict={route.strict || false}
        ></Route>
      ))}
    </Switch>
  );
}

假设我们的路由配置声明如下:

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

const config: RouteProps[] = [
  {
    path: "/",
    component: HomePage,
  },
  {
    path: "/user",
    component: UserPage,
  },
];

直接将路由声明传给renderRoutes()即可,使用如下:

import React, { Component } from "react";
import { BrowserRouter } from "react-router-dom";

const routes = renderRoutes({
  routes: config,
});

class App extends Component {
  render() {
    return <BrowserRouter>{routes}</BrowserRouter>;
  }
}

export default App;

如此一来,再增加新的页面,仅需要修改路由配置即可。改造成本低,拆卸方便。

# 如何响应路由变化?

在 VueJS 技术栈中,vue-router 是提供路由响应的钩子函数,例如:beforeEachafterEach等等。

但是在 React 中,react-router 并不提供相关的钩子函数。那么如果有顶部导航栏,不同页面切换时,高亮不同的标签,那么应该怎么实现响应路由变化呢

首先即使是路由,在 React 中,它也是一个组件对象。因此,如果要更新试图,必须触发组件的 render。而触发组件的关键在于,props 发生改变。

第一步:需要使用withRouter来包装对应的组件,将路由的信息作为 props 注入组件,比如顶部导航栏。

第二步:下面是 React17 前后的简单例子。

React17 之前:

import { withRouter, RouteComponentProps } from "react-router-dom";

class Navigation extends Component<RouteComponentProps, any> {
  state = {
    selectedPath: "/",
  };

  // 在componentWillReceiveProps中接受新的props
  // 决定是否更新state
  componentWillReceiveProps(nextProps: RouteComponentProps) {
    if (nextProps.location.pathname === this.props.location.pathname) {
      this.setState({ selectedPath: nextProps.location.pathname });
    }
  }

  render() {
    // 这里的render渲染,取决于state是否更新
    const { selectedPath } = this.state;
    return <div>导航栏选中信息:{selectedPath}</div>;
  }
}

export default withRouter(Navigation);

在 React17 之后,不推荐使用componentWillReceiveProps等不确定的生命周期。处理的思路是:render()返回的视图中,变量的变化依赖 props 属性的值。

import { withRouter, RouteComponentProps } from "react-router-dom";

class Navigation extends Component<RouteComponentProps, any> {
  state = {
    paths: ["/", "/a"],
  };

  render() {
    const { pathname } = this.props.location;
    const { paths } = this.state;

    // 切换路由, this.props 上的属性会变化
    let selectedPath = "";
    paths.some((path) => {
      if (path === pathname) {
        selectedPath = path;
        return true;
      }
      return false;
    });

    return <div>导航栏选中信息:{selectedPath}</div>;
  }
}

export default withRouter(Navigation);