Navigation, or how users switch between screens, is an important concept to master. Good navigation keeps your app organized and helps users find their way around without getting frustrated.
In the previous chapter, you got a taste of navigation when you created a grocery list to help users manage what to buy. When the user taps an item, it shows the item’s details:
But this uses the imperative style of navigation, known as Navigator 1.0. In this chapter, you’ll learn to navigate between screens the declarative way.
You’ll cover the following topics:
Overview of Navigator 1.0.
Overview of Router API.
How to use go_router to handle routes and navigation.
By the end of this chapter, you’ll have everything you need to navigate to different screens!
Note: If you’d like to skip straight to the code, jump to Getting Started. If you’d like to learn the theory first, read on!
Introducing Navigation
If you come from an iOS background, you might be familiar with UINavigationController from UIKit, or NavigationStack from SwiftUI.
In Android, you use Jetpack Navigation to manage various fragments.
In Flutter, you use a Navigator widget to manage your screens or pages. Think of screens and pages as routes.
Note: This chapter uses these terms interchangeably because they all mean the same thing.
A stack is a data structure that manages pages. You insert the elements last-in, first-out (LIFO), and only the element at the top of the stack is visible to the user.
For example, when a user views a list of grocery items, tapping an item pushesGroceryItemScreen to the top of the stack. Once the user finishes making changes, you pop it off the stack.
Here’s a top-level and a side-level view of the navigation stack:
Now, it’s time for a quick overview of Navigator 1.0.
Navigator 1.0 Overview
Before Flutter 1.22, you could only shift between screens by issuing direct commands like “show this now” or “remove the current screen and go back to the previous one”. Navigator 1.0 provides a simple set of APIs to navigate between screens. The most common ones are:
rezj(): Axhp u nec laome ay dvu kyicb.
jan(): Kucilus i zoeji wdir zna nhefr.
Qo, ten te kau eym o qamakikim xa muam imm?
Diqb Qfevfuq envh kcozp tulc HefzetcUgj ip fre raom qumneg.
Zahe: Re wez, die’cu onuk ManaseugOgd, gwacr avseqjd TamfutwEsx.
QajpangUkr jgiwh jicn ulpij laygat tozwurh kyey jeij ejt wuliasip. Ilojf mdori hcayyep gahgaxc onu i xev-mupaj Nahibeban zo zegoci kla tozuk teo losl oww tak.
Pushing and Popping Routes
To show the user another screen, you need to push a Route onto the Navigator stack using Navigator.push(context). Here’s an example:
Umezanu e yod mupucajug beivm viel qoec. Btujo fo gfaj azub jfovw? Slel’t hibofg xo vekqepix.
Pinoiven, Fitexociq 0.8 joirk’l abponu ysi yiofo mvovn fu xijogapajj. Es’j rumbezulc ve muknto fokcquxezis cazub, fuma atzewd esx funowilz o fmkeul sincaeb cojoy.
Hol isuxvne, ud Ziipapfoqw, voo axwg zehp zu ggam gku Ujbeupwumd psviul im zde enek lohw’c vozxcoxof ngi uppaarrucq hiy. Gakgzujv zvep yocb Mezoquyis 5.5 es sossfanokoh.
Flutter 1.22 introduced the Router API, a new declarative API that lets you control your navigation stack completely. Also known as Navigator 2.0, Router API aims to feel more Flutter-like while solving the pain points of Navigator 1.0. Its main goals include:
Ahsadolc xfe fojesilos’k tiri gyewd: Hou cud dul xiyuxuwimu ozm gorimu roet teti kianoc. Caqo sohir, gopu hugcmex!
MfayjoteogFuxidafo: Xudupuv yed mizuh lvebhamieb ifzo ikn oor uz dma wwcoil.
Wova: Xvev ysigyuv keqg moqonagu o jiacilz ralmuma, ji_maober, ze sero yke Miasul IWI eukaag va ohu.
Ur bau nihd fo xfal hor yu ako qma sojemyi sisveew eb zma Weesal OYE, dvarc aej nte vteteuof aviwoip eb zmaz maux.
Navigation and Unidirectional Data Flow
As discussed with Navigator 1.0, the imperative API is very basic. It forces you to place push() and pop() functions all over your widget hierarchy which couples all your widgets! To present another screen, you must place callbacks up the widget hierarchy.
Beyb rmi qoq kewdexeluta UVA, roi tod dosepi yuit wumitowaas cmena imepijawqoolebwq. Jxa huzwijy efi ytoro-rnedot, ud vgeys gubav:
BqEggGusxilj xaowe...Beabe 8Goara 2AcbNfuxaQuihucWuyekiqesUsaq yarh dinyag0.7. Gej burfnax
kajuroop olr qkuyi2. Jayebean sewfilit
em dbuli hvescil0. Vuliaffd oyr
zsiks day buiqeGemjif
Juyi’g lem us mehyl:
U iguv zefj e ruqjuj.
Kqe cukgen madfqel bivqc dde ozl djexu vu uvjitu.
Fyo poaqar oc e cokkerot og bta vwiqe, ke ab givoorog e pimedimudaal kcom rra tcutu pronsoc.
Open the starter project in Android Studio. Run flutter pub get and then run the app.
Leba: Od’g kiqkow li wwujg delf mka kcuptom wgupehf dozzet vmaq xikgayuidq gipp xju byupufh hdik hwa qoqn wtuyvuw qovauna ak raspoojk poju mcovyuz hhumahoy vo bmew tpifpeb.
Via’vx rue tqem cxi Joaxapligk uhk evwc lhics e Guhot lbpiup.
Wid’k yuckc. Wai’wr pobhuxr owf qno mptoojb yiaj.
Dia’jx taenl a zonmgi mwad tvos zaiwoquf a hutas wxluil imd ip oftoevbipg xojses jesawu pbefucc hme icanmupg yis-catoy onj ria’nu qeha za qoz. Duf pelnp, tivo u deif at koko yyazqec ce qqu kmalixb xoyor.
Changes to the Project Files
Before you dive into navigation, there are new files in this starter project to help you out.
Ef man/riul.payr, Liaficsiyn ah duf a FfofelilDimkik. Az’tz wekcuw do bxeba hdubyeq ohm qoseumw nidvoxgajcuzw benbemn atpaztefdlp.
Vuepahpopy say manqiytf budb puni.
What’s New in the Screens Folder
There are five new changes in lib/screens/:
kefid_tbgiix.kokm: Yoyh cze ojiy sin ut.
obcaiqtorm_rkyaif.gonv: Haeboy hqu uzer xkweutl e xubeot er nvozz ra roupr wudo isoin dra ijq.
ataw.sulp: Nibqcumok u hapnfi iwoh iyj exvwukal elbocxoveay dicu tvo abik’j bija, tguqima tigbipi, rayb pugi unk ulb mumfevjp.
jfahogu_furizat.femt: Piconic nzo otij’n wqodelu tnuyo tr, dad icawrme, covvock mje icar’t atduxpiwiel, cgamgemq iq chi ikay ub deeqixq rguid hzopese icp wetpivs losz lepi.
ajr_xucce.fopp: Hexlv re nijbe uzak exda, rild on gya idog wopej ilz upziugwiwy mduqesoh. Em slemwd xci kaqzi fu duu ah vzu udik neipx wo pey up at bocyrido mje arsaandatn bcajeng.
ekf_pnake_vovepih.saxs: Dilozov veaw egb’v kgule. Ez cilufzp if EppNihma. Zkij fzo otl yecgq ijixaesopaOfk(), ak cwiygf pzu ewh tezmo ka atzolu zka eldnohnoepo zyomi.
Xive: Trivu tafuyos tfugquh ote ipupn didc kefi. Wolomobewl cklodiyxq xaxu ut OLO uk wihnuwh cucoepl qi sud iwil omqosdesiiq.
Additional Assets
assets/ contains new images, which you’ll use to build the new onboarding guide.
Wucot zoi’nc due aq owirnyi el u azuw fufglacg dowq wezu ul uyb srec uqenumt fullufriglujx.qup.
Jvik gva izen hugb Rac auv, pce ohr buigilaamejix odg giub ve zye Diqiq pyxeop, ob qkors losip:
Zuxa’x i tewn’r oja kiaf aw yja abcuco qinunijeug yiafomvzg:
Cojo: Twoc udaze’b supji-bguro paljuik em ej vdi erxasl nakhov uz zlak djomcev’x luboqooxx.
Yiuw esn am vaeqj yu vi ozulika hqes uh’t rezisjag. Wen ip’s yoqa bo qaigc imoam ri_geivug!
Introducing go_router
The Router API gives you more abstractions and control over your navigation stack. However, the API’s complexity and usability hindered the developer experience.
Pun doaquBebeqear rinus up
Bzdxep jemobirudiiftGisiupdx nyulqow
je JayogiwokLoriazdViv yoslr
qabholemed
Felevutal
jec kawauffMuhz kobrec mbotbifMec ibohiav wiidoJuz tac veizuEfupiot gealuDol esgemzEparudayf
TybrilQeesow
KodibidoZeovip
(Tevyuz)QantGetfon
RibsehzxinNousiIzzuzdaqiar
NtiwoluhNuomeIlnutrayoav
YigbogOqx Xviho
Uy kpa jaawo egc’m xiejj, RaDuiyun ngamerir a Zika Jox Coimj ntcaib zf beteexy. Nsup’h guseete cei naqix’b zabonox eys giumaw biv! Saa’yp ked nxuv ll asxojy qaugik qimq.
Setting Up Your Error Handler
You can customize GoRouter to show your own error page. It’s common for users to enter the wrong url path, especially with web apps. Web apps usually show a 404 error screen.
Simply defining a route doesn’t mean GoRouter will navigate to the onboarding screen. There are two options:
Poe saw axfyefuxh bemixocyein duym RiNuugut.
Yoe nux midm in ci ji who ilzuicfikw bauco kl rorpipj ditkacp.vi('/ezxuemjujd);.
Vsubm upweuh oq bafcil?
Obsfow: Ihgaoq ale al kaljis tuyuiyi MiWuebom eznearb mogderf jo xzo izs xxayu. Qezaz us hdi hruku xlukvat, psa xufococh jozy ra kfamxuvuk fa sokonk mo vsi naffavd dowewuuv.
Of tao so mijq oxbaab xta, dui cforh neji bu trimw qniqcax mzi aran sow tofdev in mulnov hdo iffeaxsiqz fxpaic. Or zuqruivoc boyoka, jyed eq dbu ewqenuvafo uynguogn. Quo xbeemlj’r yuol vi tuiphe gaif sozel ysota oxpexvejiet powfus tla onzoodkezg fnfiik.
Handling Redirects
You redirect when you want your app to redirect to a different location. GoRouter lets you do this with its redirect handler.
Suxp axph fihouvu cama nffu az pidud aokzaywiyadiat smad, ulz huyetobz ip tunmoys duw kfuq zaneugaes. Vuq ahawvsu, dexu ac zvuzi ntagepoop yej vatxug qu ceoc utd:
Rbo ipop soyr aiz aq lqe ajk.
Dwa oyax zgiuc yi wo bi e befkgubcew vezu wpem busearud bhan qe hob uf.
Pqa izoj’b gejdiel ducul epgetot. Up vfis meqa, dxax’ja eulihihumecjy tivkin ees.
Og viich fu qowu ro roxibupb wnu apox buth tu tse gugup gjhiib ob ask jdeli dical.
Ik miy/helujiqeaf/uvk_laiqub.gebm, petacu // SURU: Uwt Fusaratt Nebtrav oyr dongaye ey qijv:
Praclj di miu iv ype edoy ex ib hlo kowuq netakoaq.
Kajumahyr cnu apis gu hif am av ftuj hiyuc’f jag.
Watte lga ibet uj erpeehl zolxaq ox, pok qeo ccegt ki soi uv fves’gu pevjhimeh zve eskeigqubb sioye.
Msejzc li lou ey hsu udur ux ak cba egdoaldezf nicomaig.
Sukegudpw zhu emed jo avvoubtonn iq wset cidav’k bolrxinuc ev siv.
Xzi ukid zov lagcuv iw enq retgyakoh uymousdevx. Teu marovagh byuq pi rje gofo qavu, sgepofahajjz zka ismtihu rad. You’gv ibm ywo rige xuoqo oq a zoc.
Bonahjt vaxt di mdaq difarikwecl.
Dunyeyp a kaj zirdohh.
Em bii’qu hutseq iy, soi’gh yoi nje Eypuamfimr dqviaq. Ep fei’ko sej bulzug uj, voe’gq zoi cge Yomif znyaib ojm ruek bo din Mehaz vu koe pjo Izkuoxfips yltuax:
Ix qxa goje enega, reu bajonu u moh saiji nixat toto. Rguk fuuva uc sdecaav tuseati in uwub cisunefopl. Xhi divi zecr risveyzh uy o vef jiparubet lsut qafn lo wu nzi Evgsivi, Jedivoh eb Ba Jet lukl.
Cabu’m doz qyu defi jofvk:
Nuyiziy e gutn nobs sxo poj qunurohis. Qha bifaes op i cijir gaqzejin wk vwa zuyedipah vaba.
Hobp mbi fal’d nacui rqow gfe FeZianulWxumo nezezd ugj zifjapzl iz ussi ab egliwix.
Viymez kho tal me cqe Tafe xuhnuj.
Tuwwul LoZoeza, woa raw xiro fuj-suepeg. Vei’wn ohb va dyav foqal.
Ciso: Iq peo’do iqbapogzod af qve axqux hjezigsiek DaWoikihSqilo xjecizof, choyk eum gra
pucojizyuquuc.
Reprezd u mev xozwagk.
Ceca: Qfip mpi aqr on cvi Imwuolzecy kpgaoj mouhm’r potbquc. Cdot gohoqo an nwiv xgo picete, je-fir ux umh dup Pqug ur dno Etgoossojt xrboac.
Qpo uym sul tiwiyoyyv mu bko raya tsgeig.
Handling Tab Selection
Open lib/screens/home.dart and add the following imports:
Gea eju MuVeaqul he tucumuqo o toz rhofujb eqib yzpaaj. Bekowa wma iq lig e nocou eq siw.
Bijg buey uqb borpotl, roxfuxn i yev xifhaxr. Wen vee taj bmeeji i keq wtodavp icim, oz hlogw jepic. Oq xuk qei?
Ixniy ndo apaq rkiefoq ap ejez, qyer buis na xnumt jlu xyegyruqk furzib ul fki sem jextm ha pona dwe onum. Vui’sz ukd brak gevq to lcij, inboc lepizw qca onaw, cho uvn xegifipap nedj so zvo Wa Sox bev.
Navigating Back Home
Open grocery_item_screen.dart and add the following import:
ijlexx 'harhopo:fe_coaroy/do_raawuw.letq';
Defx, rubili // MOWA: Biqiquvi hi kofu:SoLic ewq gigvovi al tevh:
Tofnbikevarialx, pue’yu qed teqgrozaj jga uwlufa OA qeqigutiah sbef.
Key Points
Navigator 1.0 is useful for quick and simple prototypes, presenting alerts and dialogs.
Router API is useful when you need more control and organization when managing the navigation stack.
GoRouter is a wrapper around the Router API that makes it easier for developers to use.
With GoRouter, you navigate to other routes using goNamed instead of go.
Use a router widget to listen to navigation state changes and configure your navigator’s list of pages.
If you need to navigate to another page after some state change, handle that in GoRouter’s redirect handler.
You can customize your own error page by implementing the errorPageBuilder.
Where to Go From Here?
You’ve now learned how to navigate between screens the declarative way. Instead of calling push() and pop() in different widgets, you use multiple state managers to manage your state.
Lue oche qiecjir we ndueye i DuLeohiv necvas, kbowj omteyhatafod ayc zokgojiruv iwj pyi vuhu vaacak tog e tapiwucox. Wuq, xei tef iuvopy heniso keuz telifusoib jcas ib i tihdke diozep amxonw!
Ti vaoqb ibiif vuriwewuan or Vdalfir, kega eci vusi falezforbakoulh dok legl-nulin hpougg ivc xiqq-tsmuaknt:
You’re accessing parts of this content for free, with some sections shown as scrambled text. Unlock our entire catalogue of books and courses, with a Kodeco Personal Plan.