React Router 中文文档 2.基本组件

基本组件 (Basic Components)

React Router 提供三种类型组件,分别是路由组件(router components),路由匹配组件(route matching components),以及导航组件(navigation components).

你使用以上的任何一个组件都必须要引入一个名为 react-router-dom 的文件

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

2.1 路由 (Routers)

任何一个核心路由APP(REACT ROUTER APPLICATION)都必须为一个路由组件。对于web工程,react-router-dom 文件提供了 <BroswerRouter> 和 <HashRouter> 路由组件。 他们两个都会为你创建一个专门的 history 对象。一般来讲,你的服务器只是一个回应请求的服务器,那么更多使用的是<BroswerRouter>,但如果你的服务器是静态文件服务器,那么你可以使用<HashRouter>

import { BrowserRouter } from 'react-router-dom'
ReactDOM.render((
  <BrowserRouter>
    <App/>
  </BrowserRouter>
), holder)

2.2 路由匹配(Route Matching)

我们提供了两种路由匹配组件,它们分别是:<Route> 和 <Switch>.

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

路由匹配通过比较<Route>组件的PATH属性和本地路径的pathname 来完成工作。当一个 <Route> 匹配到对应路径,他会渲染(render) 对应路径的内容,然而当它没有匹配到对应路径是,会渲染null。 一个没有提供path属性的<Route> 将始终被渲染

// when location = { pathname: '/about' }
<Route path='/about' component={About}/> // renders <About/>
<Route path='/contact' component={Contact}/> // renders null
<Route component={Always}/> // renders <Always/>

你可以在任何你想要根据位置渲染的内容中去包含<Route> 组件。列出并排列多个可能的<Route>组件通常会很有用。 <Switch>组件用于组合一系列<Route>组件。

<Switch>
  <Route exact path='/' component={Home}/>
  <Route path='/about' component={About}/>
  <Route path='/contact' component={Contact}/>
</Switch>

当然 <Switch> 对于组合<Route> 并不是必须的,也就是说我们并不一定需要组合<Route>,但是这是一个非常有用的组件。<Switch> 组件会遍历所有<Route>元素,并且只渲染最先与本地路径相匹配的<Route>元素。这对于多个route组件路径匹配同一个路径,或者当动画在两个组件中过度,或者识别到对于本地路径没有路由路径与之匹配的时候(这时你可以渲染一个 404 组件)会非常有帮助

<Switch>
  <Route exact path='/' component={Home}/>
  <Route path='/about' component={About}/>
  <Route path='/contact' component={Contact}/>
  {/* when none of the above match, <NoMatch> will be rendered */}
  <Route component={NoMatch}/>
</Switch>

2.3 路由渲染参数

你可以有三个参数来选择你该如何渲染给出的<Route>组件,分别是:component, render, 和 children。 你可以查看 <Route>documentation来了解以上三个参数的更多信息,但是在这里, 我们将主要讲 component 和 render 方法,因为他们是两个最主要的方法,也是最常用的。

component 作用于你想要渲染的已经存在的组件(可以是 react.component ,也可以是无状态组件(pure function))。render 方法提供一个内部函数,当你想要对将被渲染的组件
传入内部变量的时候,你需要使用这个方法。 你不应该对component方法传入内部变量,因为component会有两个多余的方法 unmounts / remounts。

const Home = () => <div>Home</div>

const App = () => {
  const someVariable = true;
  
  return (
    <Switch>
      {/* these are good */}
      <Route exact path='/' component={Home} />
      <Route
        path='/about'
        render={(props) => <About {...props} extra={someVariable} />}
      />
      {/* do not do this */}
      <Route
        path='/contact'
        component={(props) => <Contact {...props} extra={someVariable} />}
      />  
    </Switch>
  )
}

2.4 导航

REACT ROUTER 提供<Link>组件,它在你的app内部创建一个链接(link),无论你在哪里渲染了<Linke>,它都会被渲染成html的锚点元素<a>

<Link to='/'>Home</Link>
// <a href='/'>Home</a>

<NavLink> 是一个特殊类型的<Link>,当该元素被点击的时候会激活"active"样式(提供了activeClassName属性)。

// location = { pathname: '/react' }
<NavLink to='/react' activeClassName='hurray'>React</NavLink>
// <a href='/react' className='hurray'>React</a>

在任何时候,如果你想要强制导航,那么你可以渲染一个<Redirect>。当一个<Redirect>元素被渲染时,它会根据该元素下的"to"属性,导航到指定路径。

Redirect to='/login'/>
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 212,294评论 6 493
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 90,493评论 3 385
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 157,790评论 0 348
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 56,595评论 1 284
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 65,718评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,906评论 1 290
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,053评论 3 410
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,797评论 0 268
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,250评论 1 303
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,570评论 2 327
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,711评论 1 341
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,388评论 4 332
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,018评论 3 316
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,796评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,023评论 1 266
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,461评论 2 360
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,595评论 2 350

推荐阅读更多精彩内容