Блог

Перестаньте ламати вкладки в Expo Router

2 лютого 2026 р. 9 хв читання

Як я не дав Expo Router монтувати нове піддерево вкладок, яке лише виглядало як той самий головний екран, у застосунку зі stack і вкладками.

Перестаньте ламати вкладки в Expo Router
ExpoExpo RouterReact NativeНавігаціяАрхітектура

Як я виправив дубльовані вкладки в Expo Router

Expo Router доволі простий, коли вкладки і є весь застосунок.

Цікавіше стає тоді, коли в застосунку є вкладки, але є й повноекранні маршрути поза ними: екрани деталей, обробки, результату, покупки чи онбордингу.

Саме так був влаштований мій застосунок.

І баг насправді не був у тому, що «Expo Router зламаний».

Баг був у тому, що я випадково створював друге піддерево вкладок.

Застосунок ніби повертався на головний екран, але це був уже не той самий інстанс вкладок.

Це зовсім інша проблема, ніж просто потрапити не на той екран.

Я потрапляв на екран, який виглядав правильно, але дерево вкладок під ним було новим.

Тож справжній збій виглядав так: дубльовані вкладки, інтерфейс виглядає так само, а інстанс не той.

Саме тому стрічка могла скидатися, стан окремих вкладок міг зникати, а застосунок міг поводитися непослідовно, хоча користувач «повернувся на головну».

Ця стаття з'явилася, бо я наштовхнувся саме на цю проблему і мусив її розгребти.

Граф мого застосунку не складався лише з вкладок

Важлива деталь була така:

навігатор вкладок не був усім застосунком.

У мене був кореневий stack, а вкладки були лише однією гілкою всередині нього.

<Stack>
  <Stack.Screen name="(tabs)" />
  <Stack.Screen name="details/[id]" />
  <Stack.Screen name="processing/[id]" />
  <Stack.Screen name="result/[id]" />
  <Stack.Screen name="purchase" />
</Stack>

Така структура була навмисною.

Я хотів, щоб details, processing і result були поза вкладками, щоб вони займали весь екран і ховали панель вкладок.

З цим усе було гаразд.

Проблема почалася, коли я раз у раз переходив назад у вкладки так, ніби /(tabs) був ще одним звичайним маршрутом.

Саме тут і виникало дублювання.

Я не завжди повертався до наявної гілки вкладок.

Іноді я фактично створював нову.

Інакше кажучи, у кореневому stack уже жила одна оболонка вкладок, а я випадково монтував ще одну, яка просто рендерила той самий головний екран.

Найпростіший спосіб задублювати вкладки

Щойно у вас змішаний граф, такі дії стають небезпечними:

router.replace("/(tabs)/(home)");
router.dismissTo("/");

Вони виглядають безневинно, але це не те саме, що «повернутися до наявного інстансу вкладок».

Я хотів ось чого:

root stack
├─ (tabs)            // existing tabs instance
├─ details/[id]
├─ processing/[id]
└─ result/[id]

back action -> return to the existing (tabs) branch

А натомість іноді робив ось що:

root stack
├─ (tabs)            // original tabs instance still exists
├─ details/[id]
├─ processing/[id]
├─ result/[id]
└─ (tabs)            // fresh tabs instance mounted again

Саме другий випадок і є справжнім багом.

Він означає, що користувач бачить головний екран і панель вкладок, але вже не перебуває в тій гілці вкладок, яку вибудував раніше.

На практиці це проявлялося так:

  • друга гілка вкладок монтувалася поверх початкової
  • гілка вкладок будувалася заново замість повернення до наявної
  • поточний стан вкладки губився
  • губилася позиція прокрутки чи завантажений стан вкладки
  • історія навігації ставала непослідовною

Найнеприємніше те, що цей баг легко пропустити.

Ви все ще бачите головний екран.

Ви все ще бачите панель вкладок.

Але тепер ви сидите в новому інстансі вкладок, а не в тому, який користувач уже вибудував.

Тому й здається, що стан вкладок ламається випадково.

Будьте точні щодо того, що таке «головна»

Після цього я перестав сприймати «перейти на головну» як розмиту ідею.

Я зробив це явним:

export const TAB_HOME_ROUTE = "/(tabs)/(home)";
export const TAB_CREATE_ROUTE = "/(tabs)/(create)";
export const TAB_PROFILE_ROUTE = "/(tabs)/(profile)";

А коли треба було повернутися до вкладок, я націлювався на справжній маршрут вкладки:

router.dismissTo("/(tabs)/(home)");

А не:

router.dismissTo("/");
router.replace("/(tabs)/(home)");

Зрештою я використав для цього dismissTo, але головне було не в самому API.

Головне, що місце призначення перестало бути розмитим.

Це було перше справжнє виправлення.

Коли ціль точна, навігація перестає працювати «як вийде» і починає відповідати реальному графу.

Симптом був не «не той екран», а «не той інстанс»

Ця різниця важлива.

Часто користувач і далі бачив правильну вкладку.

Проблема була в тому, що це було нове дерево вкладок.

Тому поломка проявлялася опосередковано:

  • позиція прокрутки зникала
  • раніше завантажений стан вкладки зникав
  • застосунок ніби забував, де був користувач
  • повторювані сценарії з часом робили stack дедалі дивнішим

Щойно я почав думати категоріями «я повертаюся до наявного інстансу вкладок чи створюю новий?», міркувати про всю проблему стало набагато легше.

Тримайте динамічні цілі повернення на короткому повідку

У мене також були сценарії, які передавали параметр returnTo.

Тут усе може дуже швидко заплутатися.

Якщо дозволити будь-якому випадковому значенню вирішувати, куди застосунок піде далі, ви отримаєте навігацію, про яку важко міркувати і яку легко зламати.

Тож я зупинився на простому правилі:

  • тримати перелік цілей повернення дуже обмеженим
  • повертатися на справжній маршрут вкладки, коли ціль відсутня або некоректна
  • не дозволяти «поверненню туди, звідки прийшов» відтворювати іншу гілку застосунку

Ця частина менш захоплива, ніж баг із дубльованими вкладками, але служить тій самій меті:

повернути користувача до наявної гілки навігації, а не до свіжої копії чогось, що лише виглядає правильно.

Що насправді все виправило

Якби треба було стиснути все це до кількох правил, вони були б такими:

  • не використовуйте /(tabs) як універсальний ярлик на головну
  • використовуйте точний маршрут вкладки, який вам потрібен, наприклад /(tabs)/(home)
  • думайте про «наявний інстанс вкладок», а не про «якийсь маршрут головної»
  • пропускайте динамічні цілі повернення через невеликий whitelist
  • оптимізуйте під повернення до поточної гілки вкладок, а не під створення нової

Підсумки

Головна помилка полягала в тому, що я недостатньо добре розумів граф.

Щойно я прийняв, що вкладки лише одна гілка всередині більшого кореневого stack, правила навігації стали набагато простішими.

І віддам належне Expo Router: виправлення не було якимось потворним обхідним рішенням.

Складно було лише чесно визнати, яким насправді є граф застосунку.

Вкладки не були застосунком.

Вони були одним піддеревом усередині застосунку.

Щойно я перестав переходити на «головну» абияк і почав повертатися саме до наявної гілки вкладок, проблема з дубльованими вкладками зникла.

Якщо у вашому застосунку змішаний граф із кореневим stack і вкладками, я б почав саме з цього.