webchang

React路由

文章目录

react路由
- react路由的基本使用
- 常用组件说明
- - BrowserRouter和HashRouter组件
  - Link组件
  - Route组件
  - NavLink组件
  - Switch组件
  - Routes组件
  - Redirect组件
  - - from属性和to属性
    - exact
    - strict
- 路由组件和一般组件
- 路由的执行过程
- 编程式导航
- - withRouter
- 默认路由
- 匹配模式
- - 模糊匹配模式
  - 精确匹配
- push和replace模式
- 嵌套路由
- 向路由组件传递参数
- - params参数
  - search参数
  - state参数
  - 编程式导航传递参数

react路由

现代的前端应用大多都是SPA(单页应用程序)，也就是只有一个HTML页面的应用程序。因为它的用户体验更好、对服务器的压力更小，所以更受欢迎。为了有效的使用单个页面来管理原来多页面的功能，前端路由应运而生

前端路由的功能：让用户从一个视图(页面)导航到另一个视图(页面)，前端路由是一套映射规则，在Reat中是URL路径与组件的对应关系，使用 React路由简单来说，就是配置路径和组件(配对)。

文档：https://react-router.docschina.org/web/guides/philosophy

react路由的基本使用

安装：npm i react-router-dom
导入路由的三个核心组件，它们是组件

import { BrowserRouter as Router, Route, Link } from "react-router-dom";

使用Router组件包裹整个应用
使用Link组件作为导航菜单（路由入口）
使用Route组件配置路由规则和要展示的组件（路由出口）

import React from 'react'
import ReactDom from 'react-dom'

// 导入路由组件
import { BrowserRouter as Router, Route, Link } from "react-router-dom";

const App = () => (
  // 使用Router组件包裹整个应用
  <Router>
    <div>
      <h1>react</h1>

      {/* 指定路由入口 */}
      <Link to="/first">页面1</Link>
      <Link to="/second">页面2</Link>

      {/* 指定路由出口，path设置为Link中的to属性，component设置为要渲染的组件 */}
      <Route path="/first" component={First}></Route>
      <Route path="/second" component={Second}></Route>
    </div>
  </Router>
)

class First extends React.Component {
  render() {
    return (
      <div>
        <h2>我是页面1的标题</h2>
      </div>
    )
  }
}

const Second = () => (
  <div>
    <h2>我是页面2</h2>
  </div>
)


ReactDom.render(<App />, document.getElementById('root'));

常用组件说明

BrowserRouter和HashRouter组件

BrowserRouter或HashRouter组件：包裹整个应用，一个 React应用只需要使用一次
- HashRouter：使用URL的哈希值实现( localhost:3000/#/first)
- BrowserRouter：使用H5的 history Api实现( localhost:3000/first）

import { BrowserRouter, Route, Link } from "react-router-dom";

import { HashRouter, Route, Link } from "react-router-dom";

hash模式下#后边的路径不会发给服务器，不会被包括在 HTTP 请求中，对后端完全没有影响，因此改变 hash 不会重新加载页面，在处理相对路径方面的一些问题时，使用HashRouter可以解决。

Link组件

Link组件：用于指定导航链接，默认会被渲染为一个a标签，Link组件的to属性会作为href值

<Link to="/first">页面1</Link>

<a href="/first">页面1</a>

Route组件

Route组件：指定路由展示的组件（注册路由）

path属性：路由规则
component属性：指定当路由匹配时要展示的组件
Route组件写在哪，渲染出来的组件就展示在哪

<Route path="/first" component={First}></Route>

如果没有path属性，将匹配所有的路径。

NavLink组件

NavLink可以实现路由链接的高亮，通过activeClassName指定样式名。当点击哪个导航链接，哪个导航菜单就会应用activeClassName指定的样式。

对NavLink再做一层封装

import React, { Component } from 'react'
import { NavLink } from 'react-router-dom'

export default class MyNavLink extends Component {
  render() {
    console.log(this.props)
    return <NavLink activeClassName="active" {...this.props}></NavLink>
  }
}

使用

<MyNavLink to="/home" children="home" />
<MyNavLink to="/about" children="about" />

Switch组件

默认情况下，在匹配到一个路由后会继续往下匹配。比如下方代码，在/home路径匹配到Home组件的情况下，依然会继续往下匹配到Test组件

但是一个路由一般只对应一个组件，在已经匹配到的情况下就没有必要继续往下匹配了。此时可以使用Switch组件，Switch可以提高路由匹配效率(单一匹配)。

import { Route, Switch } from 'react-router-dom'

Routes组件

注意！！！在 react-router-dom的6.x版本中，“Switch”被替换为了“Routes”，需要更新导入语句

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

// 更新为
import { Routes ,Route } from 'react-router-dom';

同时需要更新Route的声明语句

<Route path="/" component={Home} />

// 更新为
<Route path='/welcome' element={>} />

Redirect组件

一般写在所有路由注册的最下方，当所有路由都无法匹配时，跳转到Redirect指定的路由

<Route path="/about" component={About} />
<Route path="/home" component={Home} />
<Redirect to="/home">Redirect>

from属性和to属性

Switch中是Route 从上到下匹配，如果有一个匹配，后面的就不会再继续匹配了
Redirect的from属性是当地址与from匹配（可以用正则）时，才会重定向到to属性指定的路径
Redirect的from属性如果没有，则默认是匹配所有的路径

exact

完全匹配 from；相当于 Route.exact。

strict

严格匹配 from；相当于 Route.strict。

路由组件和一般组件

写法不同

一般组件:
路由组件:

存放位置不同

一般组件：components
路由组件：pages

接收到的props不同

一般组件：写组件标签时传递了什么，就能收到什么
路由组件：接收到三个固定的属性

路由的执行过程

点击Link组件(a标签）会修改浏览器地址栏中的url
React路由监听到地址栏url的变化。
Reat路由内部遍历所有 Route组件，使用路由规则(path)与 pathname进行匹配。
当路由规则(path)能够匹配地址栏中的pathname时，就展示渲染该 Route组件的内容

编程式导航

编程式导航：通过JS代码来实现页面跳转
history是 React路由提供的，用于获取浏览器历史记录的相关信息。借助props.history对象上的API进行跳转。**只有路由组件的props上才有history对象，**普通组件的props上的history是undefined。
push(path)：跳转到某个页面，参数path表示要跳转的路径
go(n)：前进或后退到某个页面，参数n表示前进或后退页面数量(比如:-1表示后退到上一页)

为什么是从props上拿到history对象呢？我们创建的组件是没有history对象的，在Route组件中渲染了自己创建的组件，然后通过prop传了history进去。组件就可以通过props拿到history

import React from 'react'
import ReactDom from 'react-dom'

// 导入路由组件
import { BrowserRouter as Router, Route, Link } from "react-router-dom";
// import { HashRouter as Router, Route, Link } from "react-router-dom";

class App extends React.Component {
  render() {
    return (
      <Router>
        <div>
          <p>编程式导航</p>
          <Link to="/login">去登录页面</Link>

          <Route path="/login" component={Login}></Route>
          <Route path="/home" component={Home}></Route>
        </div>
      </Router>
    )
  }
}

class Login extends React.Component {

  handleLogin = () => {
    this.props.history.push("/home");
  }

  render() {
    return (
      <div>
        <h1>登录界面</h1>
        <button onClick={this.handleLogin}>首页</button>
      </div>
    )
  }
}


const Home = (props) => {
  const goBack = () => {
    props.history.go(-1);
  }

  return (
    <div>
      <h2>首页</h2>
      <button onClick={goBack}>返回</button>
    </div>
  )
}

ReactDom.render(<App />, document.getElementById('root'));

withRouter

一般组件的props上的history是undefined，无法使用编程式导航的api。此时可以用withRouter函数。

withRouter是一个函数，可以加工一般组件，让一般组件具备路由组件所特有的API，通过props传递三个属性：history/location/match
withRouter的返回值是一个新组件

import React, { Component } from 'react'
import { withRouter } from 'react-router-dom'

// Header是一般组件
class Header extends Component {
  back = () => {
    this.props.history.goBack()
  }

  forward = () => {
    this.props.history.goForward()
  }

  go = () => {
    this.props.history.go(2)
  }

  render() {
    console.log('Header组件中的props：', this.props)
    return (
      <div className="head">
        <h1>React-router-dom</h1>
        <button onClick={this.back}>回退</button>
        <button onClick={this.forward}>前进</button>
        <button onClick={this.go}>go</button>
      </div>
    )
  }
}

// withRouter是一个函数，可以加工一般组件，让一般组件具备路由组件所特有的API
// withRouter的返回值是一个新组件
export default withRouter(Header)

默认路由

默认路由表示进入到页面后就能匹配到的路由，并展示对应的组件

<Route path="/" component={Login}></Route>

匹配模式

模糊匹配模式

默认情况下, React路由是模糊匹配模式
模糊匹配规则：只要pathname以path开头就会匹配成功，对应的组件就会被渲染出来
- path代表Route组件的path属性
- pathname代表Link组件的to属性(也就是location.pathname)

精确匹配

给 Route组件添加exact属性，让其变为精确匹配模式
精确匹配：只有当path和 pathname完全匹配时才会展示该路由

严格匹配不要随便开启，需要再开，有些时候开启会导致无法继续匹配二级路由

class App extends React.Component {
  render() {
    return (
      <Router>
        <div>
          <Link to="/">首页</Link>
          

          <Link to="/login">登录页面</Link>

          {/* 此时该组件只会匹配"/"这一种情况  */}
          <Route path="/" exact component={Home}></Route>
          <Route path="/login" component={Login}></Route>
        </div>
      </Router>
    )
  }
}

push和replace模式

默认情况下，路由的切换是push模式，点击后退按钮时还可以回到上一个路由。如果想要开启replace模式，需要在Link组件上添加replace属性

<Link to="/home" replace></Link>

嵌套路由

注册子路由时要写上父路由的path值
路由的匹配是按照注册路由的顺序进行的

向路由组件传递参数

params参数

import React, { Component } from 'react'
import { Link, Route } from 'react-router-dom'
import Detail from './Detail'

export default class Message extends Component {
  state = {
    messageArr: [
      {
        id: 1,
        title: '消息1',
      },
      {
        id: 2,
        title: '消息2',
      },
      {
        id: 3,
        title: '消息3',
      },
    ],
  }

  render() {
    return (
      <div>
        <ul>
          {this.state.messageArr.map((msgObj) => {
            return (
              <li key={msgObj.id}>
                {/* 1、向路由组件传递params参数 */}
                <Link to={`/home/message/detail/${msgObj.id}/${msgObj.title}`}>
                  {msgObj.title}
                </Link>
              </li>
            )
          })}
        </ul>
        
        {/* 2、声明接受params参数 */}
        <Route path="/home/message/detail/:id/:title" component={Detail} />
      </div>
    )
  }
}

接收params参数

import React, { Component } from 'react'

const detailData = [
  { id: 1, content: '内容1' },
  { id: 2, content: '内容2' },
  { id: 3, content: '内容3' },
]
export default class Detail extends Component {
  render() {
    console.log('detail:', this.props)
    // 接收params参数
    const { id, title } = this.props.match.params
    let index = parseInt(id) - 1
    return (
      <ul>
        <li>id:{id}</li>
        <li>title:{title}</li>
        <li>content:{detailData[index].content}</li>
      </ul>
    )
  }
}

search参数

import React, { Component } from 'react'
import { Link, Route } from 'react-router-dom'
import Detail from './Detail'

export default class Message extends Component {
  state = {
    messageArr: [
      {
        id: 1,
        title: '消息1',
      },
      {
        id: 2,
        title: '消息2',
      },
      {
        id: 3,
        title: '消息3',
      },
    ],
  }
  render() {
    return (
      <div>
        <ul>
          {this.state.messageArr.map((msgObj) => {
            return (
              <li key={msgObj.id}>
                {/* 1、向路由组件传递search参数 */}
                <Link to={`/home/message/detail?id=${msgObj.id}&title=${msgObj.title}`}>
                  {msgObj.title}
                </Link>
              </li>
            )
          })}
        </ul>
        
        {/* 2、search参数无须声明接收，正常注册路由即可 */}
        <Route path="/home/message/detail" component={Detail} />
      </div>
    )
  }
}

接收参数

import React, { Component } from 'react'
import qs from 'querystring'

let obj = { id: 1, name: 'mingming' }
console.log(qs.stringify(obj)) // id=1&name=mingming 这是urlencoded格式
let query = 'id=1&name=mingming'
console.log(qs.parse(query)) // {id: "1", name: "mingming"}

const detailData = [
  { id: 1, content: '内容1' },
  { id: 2, content: '内容2' },
  { id: 3, content: '内容3' },
]
export default class Detail extends Component {
  render() {
    console.log('detail:', this.props)

    // 3、接收search参数
    const { id, title } = qs.parse(this.props.location.search.slice(1))
    let index = parseInt(id) - 1
    return (
      <ul>
        <li>id:{id}</li>
        <li>title:{title}</li>
        <li>content:{detailData[index].content}</li>
      </ul>
    )
  }
}

state参数

import React, { Component } from 'react'
import { Link, Route } from 'react-router-dom'
import Detail from './Detail'

export default class Message extends Component {
  state = {
    messageArr: [
      {
        id: 1,
        title: '消息1',
      },
      {
        id: 2,
        title: '消息2',
      },
      {
        id: 3,
        title: '消息3',
      },
    ],
  }
  render() {
    return (
      <div>
        <ul>
          {this.state.messageArr.map((msgObj) => {
            return (
              <li key={msgObj.id}>
                {/* 1、向路由组件传递state参数 */}
                <Link
                  to={{
                    pathname: '/home/message/detail',
                    state: { id: msgObj.id, title: msgObj.title },
                  }}>
                  {msgObj.title}
                </Link>
              </li>
            )
          })}
        </ul>
        
        {/* 2、state参数无须声明接收，正常注册路由即可 */}
        <Route path="/home/message/detail" component={Detail} />
      </div>
    )
  }
}