從零開始擼Next.js(一):基于文件的路由

React的路由系統(tǒng)

有過(guò)React開發(fā)經(jīng)驗(yàn)的同學(xué)肯定都用過(guò)React Router越锈,這是用來(lái)告訴React在什么路由狀態(tài)下需要渲染什么組件舰绘,我們一起看下v5版本React Router的路由使用(當(dāng)前最新v6會(huì)有差異):

<Switch> <Route exact path="/"> <Home /> </Route> <Route path="/about"> <About /> </Route> <Route path="/dashboard"> <Dashboard /> </Route> <Route path="*"> <NoMatch /> </Route> </Switch>

根據(jù)上述配置就可以在三種不同的URL匹配下渲染不同組件叁征,并且最末尾的*可以用來(lái)匹配所有其余預(yù)期之外的URL因妇,即404頁(yè)面躺翻,看起來(lái)也還是蠻清晰易懂的等舔。

Next.js路由系統(tǒng)

不知道大家有沒有聽過(guò)約定優(yōu)于配置這個(gè)編程概念,很多設(shè)計(jì)不好的框架常需要非常多的配置翁巍,每個(gè)配置都有額外的學(xué)習(xí)成本和犯錯(cuò)的可能性驴一,配置越多的系統(tǒng)給人感覺就越是復(fù)雜難用。
Next.js的路由系統(tǒng)就是一個(gè)典型的約定優(yōu)于配置的例子曙咽,直接使用目錄和文件的名稱充當(dāng)路由中的匹配規(guī)則蛔趴,讓我們不需要學(xué)習(xí)React Router中一系列的路由相關(guān)的API,這是一個(gè)非常直覺化的設(shè)計(jì)思路例朱,只需要了解少量目錄和文件名與路由映射關(guān)系就可以完全不操心配置同步修改的麻煩孝情,我們一起了解下如下幾個(gè)典型的路由場(chǎng)景是怎么在Next.js中實(shí)現(xiàn)的:

1) www.demo.com

此處有兩個(gè)知識(shí)點(diǎn):

  • 首先,Next.js所有頁(yè)面渲染對(duì)應(yīng)組件通通都是放在/pages/文件夾下面
  • 其次洒嗤,對(duì)應(yīng)某目錄的默認(rèn)路徑都是由該文件夾下的index.tsx文件負(fù)責(zé)頁(yè)面渲染
    所以箫荡,渲染www.demo.com路由的就是/pages/index.tsx文件
  • 2) www.demo.com/users

    由上面所提到知識(shí)可知,渲染該路由的就是/pages/users/index.tsx文件

    3) www.demo.com/users/001

    上述路由中的001是用戶ID渔隶,也就是說(shuō)該參數(shù)是動(dòng)態(tài)的羔挡,也就不可能給每個(gè)用戶創(chuàng)建一個(gè)對(duì)應(yīng)文件,比如/pages/users/001.tsx间唉,這種動(dòng)態(tài)路由參數(shù)的場(chǎng)景在Next.js中使用一種特殊的文件名格式[xxx]绞灼,所以,我們使用/pages/users/[id].tsx這種文件名告訴Next.js呈野,我們此處需要接收一個(gè)動(dòng)態(tài)的參數(shù)id低矮,所以,凡是路由規(guī)則符合www.demo.com/users/xxx的格式都會(huì)被/pages/users/[id].tsx渲染被冒,同時(shí)军掂,在渲染過(guò)程我們肯定也需要拿到對(duì)應(yīng)的用戶ID進(jìn)行數(shù)據(jù)加載,獲取方式如下:

    import { useRouter } from "next/router";import { useEffect } from "react";export default function UsersPage() { const router = useRouter(); const id = router.query.id; // 此處拿到id就可以進(jìn)行數(shù)據(jù)獲取了 useEffect(() => { // 此處基于id獲取數(shù)據(jù)進(jìn)行渲染 }, [id]);}

    4) www.demo.com/orders/2023/01/01

    此處我們需要先獲取年月日三個(gè)數(shù)值昨悼,再對(duì)訂單進(jìn)行篩選后顯示蝗锥,很明顯這三個(gè)參數(shù)都是動(dòng)態(tài)參數(shù),首先想到的是使用/pages/orders/[year]/[month]/[day]/index.tsx這種文件結(jié)構(gòu)率触,然后在代碼中使用query對(duì)象的三個(gè)字段來(lái)分別獲取年月日:

    import { useRouter } from "next/router";export default function FilteredOrders() { const router = useRouter(); const { year, month, day } = router.query; return ( <div> {year}/{month}/{day} </div> );}

    當(dāng)然這種方法是OK的终议,也是可以正常渲染拿到結(jié)果,但如果說(shuō)我們的年月日的參數(shù)個(gè)數(shù)可變葱蝗,比如有時(shí)只會(huì)篩選年月痊剖,有時(shí)還會(huì)增加時(shí)分秒篩選,這種相對(duì)復(fù)雜的場(chǎng)景下垒玲,上面這種路由格式就不夠靈活處理不來(lái)。好在Next.js有給到一種文件名格式是[...xxx]用來(lái)接收長(zhǎng)度不定的動(dòng)態(tài)參數(shù)找颓,所以我們可以使用/pages/orders/[...dates].tsx來(lái)

    import { useRouter } from "next/router";export default function FilteredOrders() { const router = useRouter(); return ( <div> {router.query.dates ? `${router.query.dates[0]}/${router.query.dates[1]}/${router.query.dates[2]}` : ``} </div> );}

    5) 404頁(yè)面

    對(duì)于這種特殊狀態(tài)碼頁(yè)面合愈,直接在/pages根據(jù)狀態(tài)碼作為文件名創(chuàng)建對(duì)應(yīng)文件即可,比如/pages/404.tsx

    小結(jié)

    使用Next.js可以擺脫 React路由配置的一堆事情,直接使用文件夾和文件的名稱來(lái)映射配置關(guān)系佛析,這可以大為減少路由配置同步這一心智負(fù)擔(dān)益老,Next.js這一套文件名映射路由涉及到的知識(shí)點(diǎn)少、學(xué)習(xí)成本低寸莫,是非常優(yōu)秀的設(shè)計(jì)捺萌。當(dāng)然,對(duì)配置簡(jiǎn)化的同時(shí)也必然減少了靈活性膘茎,React Router學(xué)習(xí)成本高但也為用戶帶來(lái)高度可定制功能桃纯,有得有失。

    ?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
    • 序言:七十年代末披坏,一起剝皮案震驚了整個(gè)濱河市态坦,隨后出現(xiàn)的幾起案子,更是在濱河造成了極大的恐慌棒拂,老刑警劉巖伞梯,帶你破解...
      沈念sama閱讀 206,311評(píng)論 6 481
    • 序言:濱河連續(xù)發(fā)生了三起死亡事件,死亡現(xiàn)場(chǎng)離奇詭異帚屉,居然都是意外死亡谜诫,警方通過(guò)查閱死者的電腦和手機(jī),發(fā)現(xiàn)死者居然都...
      沈念sama閱讀 88,339評(píng)論 2 382
    • 文/潘曉璐 我一進(jìn)店門攻旦,熙熙樓的掌柜王于貴愁眉苦臉地迎上來(lái)喻旷,“玉大人,你說(shuō)我怎么就攤上這事敬特£希” “怎么了?”我有些...
      開封第一講書人閱讀 152,671評(píng)論 0 342
    • 文/不壞的土叔 我叫張陵伟阔,是天一觀的道長(zhǎng)辣之。 經(jīng)常有香客問我,道長(zhǎng)皱炉,這世上最難降的妖魔是什么怀估? 我笑而不...
      開封第一講書人閱讀 55,252評(píng)論 1 279
    • 正文 為了忘掉前任,我火速辦了婚禮合搅,結(jié)果婚禮上多搀,老公的妹妹穿的比我還像新娘。我一直安慰自己灾部,他們只是感情好康铭,可當(dāng)我...
      茶點(diǎn)故事閱讀 64,253評(píng)論 5 371
    • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著赌髓,像睡著了一般从藤。 火紅的嫁衣襯著肌膚如雪催跪。 梳的紋絲不亂的頭發(fā)上,一...
      開封第一講書人閱讀 49,031評(píng)論 1 285
    • 那天夷野,我揣著相機(jī)與錄音懊蒸,去河邊找鬼。 笑死悯搔,一個(gè)胖子當(dāng)著我的面吹牛骑丸,可吹牛的內(nèi)容都是我干的。 我是一名探鬼主播妒貌,決...
      沈念sama閱讀 38,340評(píng)論 3 399
    • 文/蒼蘭香墨 我猛地睜開眼通危,長(zhǎng)吁一口氣:“原來(lái)是場(chǎng)噩夢(mèng)啊……” “哼!你這毒婦竟也來(lái)了苏揣?” 一聲冷哼從身側(cè)響起黄鳍,我...
      開封第一講書人閱讀 36,973評(píng)論 0 259
    • 序言:老撾萬(wàn)榮一對(duì)情侶失蹤,失蹤者是張志新(化名)和其女友劉穎平匈,沒想到半個(gè)月后框沟,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體,經(jīng)...
      沈念sama閱讀 43,466評(píng)論 1 300
    • 正文 獨(dú)居荒郊野嶺守林人離奇死亡增炭,尸身上長(zhǎng)有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
      茶點(diǎn)故事閱讀 35,937評(píng)論 2 323
    • 正文 我和宋清朗相戀三年忍燥,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片隙姿。...
      茶點(diǎn)故事閱讀 38,039評(píng)論 1 333
    • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡梅垄,死狀恐怖,靈堂內(nèi)的尸體忽然破棺而出输玷,到底是詐尸還是另有隱情队丝,我是刑警寧澤,帶...
      沈念sama閱讀 33,701評(píng)論 4 323
    • 正文 年R本政府宣布欲鹏,位于F島的核電站机久,受9級(jí)特大地震影響,放射性物質(zhì)發(fā)生泄漏赔嚎。R本人自食惡果不足惜膘盖,卻給世界環(huán)境...
      茶點(diǎn)故事閱讀 39,254評(píng)論 3 307
    • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望尤误。 院中可真熱鬧侠畔,春花似錦、人聲如沸损晤。這莊子的主人今日做“春日...
      開封第一講書人閱讀 30,259評(píng)論 0 19
    • 文/蒼蘭香墨 我抬頭看了看天上的太陽(yáng)尤勋。三九已至喘落,卻和暖如春德崭,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背揖盘。 一陣腳步聲響...
      開封第一講書人閱讀 31,485評(píng)論 1 262
    • 我被黑心中介騙來(lái)泰國(guó)打工, 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留锌奴,地道東北人兽狭。 一個(gè)月前我還...
      沈念sama閱讀 45,497評(píng)論 2 354
    • 正文 我出身青樓,卻偏偏與公主長(zhǎng)得像鹿蜀,于是被迫代替她去往敵國(guó)和親箕慧。 傳聞我的和親對(duì)象是個(gè)殘疾皇子,可洞房花燭夜當(dāng)晚...
      茶點(diǎn)故事閱讀 42,786評(píng)論 2 345

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