React Router 中文文檔 2.基本組件

基本組件 (Basic Components)

React Router 提供三種類型組件眷细,分別是路由組件(router components),路由匹配組件(route matching components)外遇,以及導(dǎo)航組件(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> 路由組件。 他們兩個都會為你創(chuàng)建一個專門的 history 對象智哀。一般來講次询,你的服務(wù)器只是一個回應(yīng)請求的服務(wù)器,那么更多使用的是<BroswerRouter>盏触,但如果你的服務(wù)器是靜態(tài)文件服務(wù)器渗蟹,那么你可以使用<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 來完成工作赞辩。當(dāng)一個 <Route> 匹配到對應(yīng)路徑雌芽,他會渲染(render) 對應(yīng)路徑的內(nèi)容,然而當(dāng)它沒有匹配到對應(yīng)路徑是辨嗽,會渲染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/>

你可以在任何你想要根據(jù)位置渲染的內(nèi)容中去包含<Route> 組件。列出并排列多個可能的<Route>組件通常會很有用糟需。 <Switch>組件用于組合一系列<Route>組件屉佳。

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

當(dāng)然 <Switch> 對于組合<Route> 并不是必須的,也就是說我們并不一定需要組合<Route>洲押,但是這是一個非常有用的組件武花。<Switch> 組件會遍歷所有<Route>元素,并且只渲染最先與本地路徑相匹配的<Route>元素杈帐。這對于多個route組件路徑匹配同一個路徑体箕,或者當(dāng)動畫在兩個組件中過度专钉,或者識別到對于本地路徑?jīng)]有路由路徑與之匹配的時候(這時你可以渲染一個 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 路由渲染參數(shù)

你可以有三個參數(shù)來選擇你該如何渲染給出的<Route>組件,分別是:component累铅, render跃须, 和 children。 你可以查看 <Route>documentation來了解以上三個參數(shù)的更多信息娃兽,但是在這里菇民, 我們將主要講 component 和 render 方法,因為他們是兩個最主要的方法投储,也是最常用的第练。

component 作用于你想要渲染的已經(jīng)存在的組件(可以是 react.component ,也可以是無狀態(tài)組件(pure function))玛荞。render 方法提供一個內(nèi)部函數(shù)复旬,當(dāng)你想要對將被渲染的組件
傳入內(nèi)部變量的時候,你需要使用這個方法冲泥。 你不應(yīng)該對component方法傳入內(nèi)部變量,因為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 導(dǎo)航

REACT ROUTER 提供<Link>組件凡恍,它在你的app內(nèi)部創(chuàng)建一個鏈接(link),無論你在哪里渲染了<Linke>怔球,它都會被渲染成html的錨點元素<a>

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

<NavLink> 是一個特殊類型的<Link>嚼酝,當(dāng)該元素被點擊的時候會激活"active"樣式(提供了activeClassName屬性)。

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

在任何時候竟坛,如果你想要強制導(dǎo)航闽巩,那么你可以渲染一個<Redirect>。當(dāng)一個<Redirect>元素被渲染時担汤,它會根據(jù)該元素下的"to"屬性涎跨,導(dǎo)航到指定路徑。

Redirect to='/login'/>
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末崭歧,一起剝皮案震驚了整個濱河市隅很,隨后出現(xiàn)的幾起案子,更是在濱河造成了極大的恐慌率碾,老刑警劉巖叔营,帶你破解...
    沈念sama閱讀 217,084評論 6 503
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件,死亡現(xiàn)場離奇詭異所宰,居然都是意外死亡绒尊,警方通過查閱死者的電腦和手機,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 92,623評論 3 392
  • 文/潘曉璐 我一進店門仔粥,熙熙樓的掌柜王于貴愁眉苦臉地迎上來婴谱,“玉大人,你說我怎么就攤上這事】本浚” “怎么了矮湘?”我有些...
    開封第一講書人閱讀 163,450評論 0 353
  • 文/不壞的土叔 我叫張陵,是天一觀的道長口糕。 經(jīng)常有香客問我缅阳,道長,這世上最難降的妖魔是什么景描? 我笑而不...
    開封第一講書人閱讀 58,322評論 1 293
  • 正文 為了忘掉前任十办,我火速辦了婚禮,結(jié)果婚禮上超棺,老公的妹妹穿的比我還像新娘向族。我一直安慰自己,他們只是感情好棠绘,可當(dāng)我...
    茶點故事閱讀 67,370評論 6 390
  • 文/花漫 我一把揭開白布件相。 她就那樣靜靜地躺著,像睡著了一般氧苍。 火紅的嫁衣襯著肌膚如雪夜矗。 梳的紋絲不亂的頭發(fā)上,一...
    開封第一講書人閱讀 51,274評論 1 300
  • 那天让虐,我揣著相機與錄音紊撕,去河邊找鬼。 笑死赡突,一個胖子當(dāng)著我的面吹牛对扶,可吹牛的內(nèi)容都是我干的。 我是一名探鬼主播惭缰,決...
    沈念sama閱讀 40,126評論 3 418
  • 文/蒼蘭香墨 我猛地睜開眼浪南,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了漱受?” 一聲冷哼從身側(cè)響起逞泄,我...
    開封第一講書人閱讀 38,980評論 0 275
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎拜效,沒想到半個月后喷众,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體,經(jīng)...
    沈念sama閱讀 45,414評論 1 313
  • 正文 獨居荒郊野嶺守林人離奇死亡紧憾,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點故事閱讀 37,599評論 3 334
  • 正文 我和宋清朗相戀三年到千,在試婚紗的時候發(fā)現(xiàn)自己被綠了。 大學(xué)時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片赴穗。...
    茶點故事閱讀 39,773評論 1 348
  • 序言:一個原本活蹦亂跳的男人離奇死亡憔四,死狀恐怖膀息,靈堂內(nèi)的尸體忽然破棺而出,到底是詐尸還是另有隱情了赵,我是刑警寧澤潜支,帶...
    沈念sama閱讀 35,470評論 5 344
  • 正文 年R本政府宣布,位于F島的核電站柿汛,受9級特大地震影響冗酿,放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜络断,卻給世界環(huán)境...
    茶點故事閱讀 41,080評論 3 327
  • 文/蒙蒙 一裁替、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧貌笨,春花似錦弱判、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 31,713評論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至膀跌,卻和暖如春剥哑,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背淹父。 一陣腳步聲響...
    開封第一講書人閱讀 32,852評論 1 269
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留怎虫,地道東北人暑认。 一個月前我還...
    沈念sama閱讀 47,865評論 2 370
  • 正文 我出身青樓,卻偏偏與公主長得像大审,于是被迫代替她去往敵國和親蘸际。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當(dāng)晚...
    茶點故事閱讀 44,689評論 2 354

推薦閱讀更多精彩內(nèi)容