React Router 사용법
React Router 8.5의 BrowserRouter, Routes, Route로 주소와 화면을 잇고, Link와 NavLink, useNavigate로 문서를 새로 받지 않는 이동을 만듭니다.
앞 글 SPA 이해에서는 링크 클릭을 가로채고, pushState로 주소를 바꾸고, popstate를 듣고, 주소에 맞는 컴포넌트를 고르는 일을 모두 손으로 했습니다. 화면이 두 개일 때는 할 만했지만, 화면이 늘어날수록 이 코드를 직접 관리하기는 어렵습니다. 이 글에서는 그 일을 React Router에 맡기고, 쇼핑몰의 홈과 소개, 상품 등록 화면을 다시 만듭니다.
이 글을 읽고 나면 다음을 할 수 있습니다.
- React Router를 설치하고
BrowserRouter,Routes,Route로 주소와 화면을 잇습니다. Link와NavLink로 문서를 새로 받지 않는 메뉴를 만들고, 지금 보고 있는 메뉴를 표시합니다.- 폼을 제출한 뒤
useNavigate로 화면을 옮기고, 없는 주소에 보여 줄 화면을 만듭니다.
앞 글과 같은 Vite 프로젝트를 씁니다. 이 교재는 React Router 8.5의 Declarative 모드를 기준으로 합니다. Declarative 모드는 JSX로 라우트를 선언하는 가장 단순한 사용 방식이며, 필요한 것이 모두 react-router 패키지 하나에 들어 있습니다. 이 버전은 React와 React DOM 19.2.7 이상, Node.js 22.22.0 이상을 요구합니다. 개발 서버를 켜고 개발자 도구의 Network 탭을 열어 둡니다.
설치하고 앱을 라우터로 감싸기
프로젝트 폴더의 터미널에서 React Router를 설치합니다. 개발 서버가 켜져 있다면 Ctrl+C로 잠시 끄고 설치한 뒤 npm run dev로 다시 켭니다.
npm install react-router이 명령은 설치하는 시점의 최신 버전을 받습니다. 이 글과 정확히 같은 버전으로 맞추려면 npm install [email protected]처럼 버전을 적습니다. 예전 자료에 나오는 react-router-dom 패키지는 설치하지 않습니다.
먼저 앱 전체를 BrowserRouter로 감쌉니다. src/main.jsx를 열어 BrowserRouter를 가져오고, <App />을 그 안에 넣습니다.
import { StrictMode } from 'react';
import { createRoot } from 'react-dom/client';
import { BrowserRouter } from 'react-router';
import './index.css';
import App from './App.jsx';
createRoot(document.getElementById('root')).render(
<StrictMode>
<BrowserRouter>
<App />
</BrowserRouter>
</StrictMode>,
);BrowserRouter는 앞 글에서 path state와 popstate Effect가 하던 일을 합니다. 브라우저의 현재 주소를 기억하고, 주소가 바뀔 때마다 자기 안에 있는 컴포넌트들에 알려 줍니다. 이 글에서 쓰는 나머지 부품은 모두 BrowserRouter 안에서만 동작하므로, 앱의 가장 바깥에 한 번만 둡니다.
주소와 화면 잇기: Routes와 Route
화면 컴포넌트는 파일 하나에 하나씩 두겠습니다. src 아래에 pages 폴더를 만들고 홈과 소개 화면을 만듭니다.
export default function Home() {
return (
<section>
<h2>홈</h2>
<p>React Router를 연습하는 작은 쇼핑몰입니다.</p>
</section>
);
}export default function About() {
return (
<section>
<h2>소개</h2>
<p>이 쇼핑몰은 6장을 따라가며 조금씩 커집니다.</p>
</section>
);
}이제 src/App.jsx를 다음 내용으로 바꿉니다. 앞 글의 코드는 모두 지웁니다. 다만 장바구니 담기 버튼은 실험에 한 번 더 쓰려고 남겨 둡니다.
import { useState } from 'react';
import { Route, Routes } from 'react-router';
import Home from './pages/Home';
import About from './pages/About';
export default function App() {
const [cartCount, setCartCount] = useState(0);
return (
<div>
<h1>내 쇼핑몰</h1>
<button onClick={() => setCartCount(cartCount + 1)}>
장바구니 담기 {cartCount}
</button>
<Routes>
<Route path="/" element={<Home />} />
<Route path="/about" element={<About />} />
</Routes>
</div>
);
}Route 하나가 "이 주소에서는 이 화면"이라는 짝 하나입니다. path에는 주소의 경로를, element에는 그때 보여 줄 JSX를 적습니다. 이렇게 주소와 화면을 이은 짝을 라우트(route)라고 부릅니다. Routes는 자기 안의 라우트들을 현재 주소와 비교해, 맞는 라우트의 element를 그 자리에 그립니다. 앞 글 연습 문제의 routes 객체와 <Page />가 하던 일입니다.
저장한 뒤 주소창에 http://localhost:5173/를 입력하면 제목과 버튼 아래에 "홈"이, http://localhost:5173/about을 입력하면 "소개"가 보입니다. 포트 번호는 터미널에 나온 주소를 따릅니다. 제목과 버튼은 Routes 바깥에 있으므로 어느 주소에서나 보입니다.
화면 전체가 하얗게 비거나 제목 아래에 아무것도 나오지 않는다면 두 가지를 먼저 확인합니다. main.jsx에서 <App />을 BrowserRouter로 감쌌는지, 그리고 element에 Home이 아니라 <Home />을 넣었는지입니다. element가 받는 것은 컴포넌트 함수가 아니라 JSX로 만든 요소입니다.
메뉴는 a 대신 Link로 만듭니다
주소창에 직접 입력하지 않아도 되도록 메뉴를 만듭니다. 우선 익숙한 <a href>로 만들어 보겠습니다. src 아래에 components 폴더를 만들고 Navbar.jsx를 만듭니다.
export default function Navbar() {
return (
<nav>
<a href="/">홈</a> <a href="/about">소개</a>
</nav>
);
}App.jsx에서 장바구니 담기 버튼과 Routes 사이에 Navbar를 넣습니다.
import Navbar from './components/Navbar';
// return 안, 장바구니 담기 버튼 아래
<Navbar />
<Routes>
<Route path="/" element={<Home />} />
<Route path="/about" element={<About />} />
</Routes>메뉴를 누르면 화면이 바뀝니다. 그런데 이번에는 React Router가 주소를 지켜보고 있습니다. 버튼을 세 번 눌러 "장바구니 담기 3"을 만들고 "소개"를 누르면 숫자는 유지될까요? 먼저 예상해 보세요.
결과 확인하기
"장바구니 담기 0"으로 돌아갑니다. Network 탭에는 about 문서 요청이 생깁니다. BrowserRouter는 주소가 바뀌는 것을 지켜볼 뿐, 평범한 <a> 클릭을 가로채지는 않습니다. 그래서 브라우저가 문서를 새로 받았고, 새 문서에서 앱이 처음부터 다시 실행되었습니다.
앞 글에서 handleLinkClick으로 하던 가로채기는 React Router의 Link 컴포넌트가 합니다. Navbar.jsx를 다음과 같이 고칩니다. href 대신 to에 주소를 적습니다.
import { Link } from 'react-router';
export default function Navbar() {
return (
<nav>
<Link to="/">홈</Link> <Link to="/about">소개</Link>
</nav>
);
}홈 링크로 돌아와 버튼을 세 번 누른 뒤 "소개"를 누르면 "장바구니 담기 3"이 그대로이고, Network 탭에 문서 요청이 생기지 않습니다. 뒤로 가기를 누르면 주소와 화면이 함께 "홈"으로 돌아옵니다.
개발자 도구의 Elements 탭에서 메뉴를 살펴보면 Link가 그린 것은 <a href="/about">입니다. 진짜 링크이므로 키보드로 이동할 수 있고, 주소를 복사하거나 새 탭에서 여는 일도 그대로 됩니다. 일반적인 클릭만 가로채 pushState로 처리합니다. 정리하면, 앱 안의 화면으로 가는 링크는 Link로 만들고, 다른 사이트로 나가는 링크만 <a href>로 만듭니다.
실험이 끝났으니 App.jsx에서 장바구니 담기 버튼과 cartCount state, useState import를 지웁니다.
지금 보고 있는 메뉴 표시하기: NavLink
메뉴에는 보통 현재 화면에 해당하는 항목이 강조되어 있습니다. NavLink는 Link와 똑같이 동작하면서, 자기 주소가 현재 주소와 맞으면 그 링크에 active라는 클래스를 붙여 줍니다. Navbar.jsx의 Link를 NavLink로 바꿉니다.
import { NavLink } from 'react-router';
export default function Navbar() {
return (
<nav>
<NavLink to="/">홈</NavLink> <NavLink to="/about">소개</NavLink>
</nav>
);
}active 클래스에 모양을 주는 규칙을 src/index.css의 맨 아래에 추가합니다.
nav a.active {
font-weight: bold;
text-decoration: underline;
}저장한 뒤 메뉴를 번갈아 누르면, 지금 보고 있는 화면의 메뉴만 굵게 밑줄이 그어집니다. Elements 탭에서 보면 활성 링크에는 class="active"와 함께 aria-current="page"가 붙어 있습니다. aria-current는 화면 낭독기 같은 보조 기술에 "지금 있는 곳"을 알려 주는 속성으로, NavLink가 알아서 붙입니다.
클래스 이름을 직접 정하고 싶으면 className에 함수를 넘깁니다. 이 함수는 isActive가 든 객체를 받아 클래스 이름을 돌려줍니다.
<NavLink to="/about" className={({ isActive }) => (isActive ? 'menu menu-on' : 'menu')}>
소개
</NavLink>NavLink는 현재 주소가 to와 같은 경로이거나 그 아래의 하위 경로이면 활성으로 판단합니다. /products-old처럼 글자만 /products로 시작하는 별개의 경로는 포함하지 않습니다. 그래서 to="/products"인 메뉴가 있다면 /products에서도, /products/456에서도 활성입니다. 상품 하나를 보는 동안에도 "상품 목록" 메뉴가 강조되기를 바란다면 알맞은 동작입니다. 정확히 그 주소일 때만 활성이 되게 하려면 <NavLink to="/products" end>처럼 end를 붙입니다. 그런데 모든 주소는 /로 시작하므로, 이 기준대로라면 홈 메뉴는 언제나 활성이어야 합니다. React Router는 to="/"만 예외로 다뤄, end가 없어도 정확히 /일 때만 활성으로 표시합니다(React Router의 NavLink). 방금 "소개" 화면에서 "홈"이 강조되지 않은 것이 이 때문입니다.
일이 끝난 뒤 코드로 이동하기: useNavigate
Link는 사용자가 눌러서 이동하는 경우에 씁니다. 그런데 사용자가 누른 것이 링크가 아닌데도 화면을 옮겨야 할 때가 있습니다. 새 상품의 정보를 적고 "등록" 버튼을 눌렀다면, 등록이 끝난 뒤 다른 화면으로 넘어가야 합니다. 이렇게 어떤 일이 끝난 뒤 코드가 이동을 시작해야 할 때 useNavigate를 씁니다.
상품 이름 하나만 입력받는 상품 등록 화면을 만듭니다. 폼을 state와 잇는 방법은 폼 다루기 기초에서 배운 그대로입니다.
import { useState } from 'react';
import { useNavigate } from 'react-router';
export default function NewProduct() {
const [name, setName] = useState('');
const navigate = useNavigate();
function handleSubmit(event) {
event.preventDefault();
console.log('등록할 상품:', name);
navigate('/');
}
return (
<form onSubmit={handleSubmit}>
<h2>상품 등록</h2>
<label>
상품 이름{' '}
<input
value={name}
onChange={(event) => setName(event.target.value)}
required
/>
</label>{' '}
<button type="submit">등록</button>
</form>
);
}useNavigate()는 이동을 시작하는 함수를 돌려줍니다. navigate('/')를 호출하면 Link to="/"를 누른 것과 같은 이동이 일어납니다. 이 예제에는 아직 상품을 저장할 곳이 없으므로 등록은 Console에 이름을 찍는 것으로 대신했습니다.
App.jsx에 라우트를, Navbar.jsx에 메뉴를 하나씩 더합니다. 이 화면의 주소는 /products/new로 합니다.
import NewProduct from './pages/NewProduct';
<Routes>
<Route path="/" element={<Home />} />
<Route path="/about" element={<About />} />
<Route path="/products/new" element={<NewProduct />} />
</Routes><NavLink to="/">홈</NavLink> <NavLink to="/about">소개</NavLink>{' '}
<NavLink to="/products/new">상품 등록</NavLink>"상품 등록" 메뉴를 눌러 이름을 입력하고 "등록"을 누르면, Console에 이름이 찍히고 화면이 홈으로 넘어가면 성공입니다. 이름을 비운 채 누르면 required 때문에 브라우저가 제출을 막으므로 이동도 일어나지 않습니다.
useNavigate를 쓸 수 있다고 해서 버튼에 onClick={() => navigate('/about')}을 달아 메뉴를 만들지는 않습니다. 그런 버튼은 링크가 아니라서 주소를 복사하거나 새 탭으로 열 수 없습니다. 사용자가 눌러서 가는 곳은 Link로, 어떤 일의 결과로 가는 곳만 navigate로 만듭니다.
없는 주소에는 무엇을 보여 줄까
주소창에 http://localhost:5173/unknown/path를 입력해 봅니다. 제목과 메뉴는 보이는데 그 아래가 비어 있습니다. /unknown/path에 맞는 라우트가 없어서 Routes가 아무것도 그리지 않았기 때문입니다. 사용자가 주소를 잘못 입력했거나 낡은 링크를 타고 들어왔을 때 빈 화면을 보게 되는 것입니다.
이런 주소를 받아 줄 화면을 만듭니다. path="*"는 다른 라우트가 맞지 않은 모든 주소와 맞는 라우트입니다.
import { Link } from 'react-router';
export default function NotFound() {
return (
<section>
<h2>페이지를 찾을 수 없습니다</h2>
<p>주소가 바뀌었거나 잘못 입력되었습니다.</p>
<Link to="/">홈으로 돌아가기</Link>
</section>
);
}import NotFound from './pages/NotFound';
<Routes>
<Route path="/" element={<Home />} />
<Route path="/about" element={<About />} />
<Route path="/products/new" element={<NewProduct />} />
<Route path="*" element={<NotFound />} />
</Routes>이제 /unknown/path에서 "페이지를 찾을 수 없습니다"가 보이고, 링크를 누르면 홈으로 돌아갑니다.
여기서 하나 궁금해집니다. *가 모든 주소와 맞는다면, 이 라우트를 맨 위로 옮기면 어떻게 될까요? path="*"인 줄을 Routes의 첫 줄로 옮기고 /products/new에 들어가면 무엇이 보일지 먼저 예상해 보세요.
결과 확인하기
여전히 "상품 등록"이 보입니다. Routes는 위에서부터 처음 맞는 라우트를 고르지 않습니다. 맞는 라우트가 여럿이면 그 가운데 주소를 가장 구체적으로 적은 것을 고릅니다. /products/new라는 글자를 그대로 적은 라우트가 무엇이든 받는 *보다 구체적이므로, 적은 순서와 상관없이 NewProduct가 선택됩니다. 확인한 뒤에는 읽기 좋게 *를 다시 맨 아래로 내려 둡니다.
pathname에서 중첩 element tree까지 — 상태 추적
현재 /products/456은 후보 branch 중 products/:id를 고르고 RootLayout Outlet에 ProductDetail과 params.id 문자열을 전달합니다. 선언 순서 오해를 줄이도록 현재 location/선택/출력을 추적합니다.
REACT ROUTING · URL & RESPONSIBILITY
pathname이 branch를 고르고 부모 Outlet이 자식을 렌더합니다
예제의 다섯 후보 가운데 /products/456은 동적 products/:id branch에 맞습니다. search와 hash는 같은 화면의 입력이며 pathname branch 선택과 구분합니다.
실제 ProductDetail · 문자열 ID와 데이터 조회
/products/456?tab=spec#buy
RootLayout → Outlet
→ ProductDetail
params.id = "456"
React 후드티 · 45,000원ID 형식 오류, 존재하지 않는 데이터, 일치하는 route가 없는 경우는 따로 처리합니다. /products/new는 정적 branch가 동적 :id보다 구체적입니다.
location.pathname/products/456이 route 매칭 입력이 됩니다.<Routes>가 다섯 branch를 비교합니다index·about·products/new·products/:id·*의 구체성을 비교하므로 단순한 첫 항목 선택이 아닙니다.
후보 element: Home · About · NewProduct · ProductDetail · NotFound.
/ + products/:id가 선택됩니다부모와 자식 match가 함께 남고
params.id는 문자열"456"입니다.중첩 element tree를 렌더링합니다
RootLayout이 유지되고ProductDetail이 부모의Outlet에 들어갑니다.
| URL 부분 | 예 | React Router API | route branch 선택 |
|---|---|---|---|
| pathname | /products/456 |
useParams() → { id: "456" } |
참여 · path 패턴과 비교 |
| search | ?tab=spec |
useSearchParams() |
같은 pathname branch의 보기 조건 |
| hash | #buy |
useLocation().hash |
branch 선택과 분리된 fragment |
pathname · /products/456
path 패턴과 비교하며, 동적 segment 값은 useParams()로 읽습니다.
search · ?tab=spec
useSearchParams()로 읽고 갱신합니다. pathname branch 자체를 고르는 값은 아닙니다.
hash · #buy
useLocation().hash로 읽는 fragment이며 pathname 매칭과 분리됩니다.
정적 branch는 동적 branch보다 구체적이고 splat은 fallback입니다. 경로 param·search·hash는 모두 외부 입력이므로 사용 전에 형식과 허용 범위를 검증합니다.
이 예의 조건
- 도표의 전체 구조와 설명은 위 관계도와 표에서 볼 수 있습니다. 아래 표에도 도표의 관계·조건·라벨·설명·주석을 모았습니다.
- 두 칸의 위치는 고정입니다. 현재 상태는 그 순간의 값이고, 동작·이유는 그 조건에서의 판정과 변화 원인입니다. 독립 비교와 실패 분기는 별도 조건이므로 모든 분기를 한 요청의 실행 순서로 이어 읽지 않습니다.
관계도의 보충 설명
| 구분 | 내용 |
|---|---|
| 도표 설명 | /products/456이 route 매칭 입력이 됩니다. |
| 도표 조건·주석 | location.pathname: /products/456이 route 매칭 입력이 됩니다. |
| 도표 설명 | <Routes>가 다섯 branch를 비교합니다 |
| 도표 조건·주석 | <Routes>가 다섯 branch를 비교합니다. index·about·products/new·products/:id·*의 구체성을 비교하므로 단순한 첫 항목 선택이 아닙니다. 후보 element: Home · About · NewProduct · ProductDetail · NotFound. |
| 도표 설명 | / + products/:id가 선택됩니다 |
| 도표 설명 | 부모와 자식 match가 함께 남고 params.id는 문자열 "456"입니다. |
| 도표 조건·주석 | / + products/:id가 선택됩니다. 부모와 자식 match가 함께 남고 params.id는 문자열 "456"입니다. |
| 도표 설명 | RootLayout이 유지되고 ProductDetail이 부모의 Outlet에 들어갑니다. |
| 도표 조건·주석 | 중첩 element tree를 렌더링합니다. RootLayout이 유지되고 ProductDetail이 부모의 Outlet에 들어갑니다. |
| 도표 표 행 | URL 부분 | 예 | React Router API | route branch 선택 |
| 도표 표 행 | pathname | /products/456 | useParams() → { id: "456" } | 참여 · path 패턴과 비교 |
| 도표 표 행 | search | ?tab=spec | useSearchParams() | 같은 pathname branch의 보기 조건 |
| 도표 표 행 | hash | #buy | useLocation().hash | branch 선택과 분리된 fragment |
| 도표 설명 | path 패턴과 비교하며, 동적 segment 값은 useParams()로 읽습니다. |
| 도표 설명 | useSearchParams()로 읽고 갱신합니다. pathname branch 자체를 고르는 값은 아닙니다. |
| 도표 설명 | useLocation().hash로 읽는 fragment이며 pathname 매칭과 분리됩니다. |
| 장면 | 현재 관찰값 | 설명 | 변화 이유 |
|---|---|---|---|
| 현재 location | pathname: /products/456 / 후보: 5개의 route branch | pathname은 /products/456입니다 | 등록 순서가 첫 매칭의 선택 규칙은 아닙니다 |
| 구체 branch 선택 | branch: RootLayout + ProductDetail / params.id: 문자열 456 | products/:id가 현재 경로를 매칭합니다 | path 매칭은 resource의 존재 검증이 아닙니다 |
| Outlet 표시 | 부모: RootLayout / child: ProductDetail | 부모 RootLayout의 Outlet에 ProductDetail을 렌더합니다 | 부모가 Outlet을 빠뜨리면 자식의 표시 자리가 없습니다 |
pathname에서 중첩 element tree까지 — 상태 추적
현재 /products/456은 후보 branch 중 products/:id를 고르고 RootLayout Outlet에 ProductDetail과 params.id 문자열을 전달합니다. 선언 순서 오해를 줄이도록 현재 location/선택/출력을 추적합니다.
REACT ROUTING · URL & RESPONSIBILITY
pathname이 branch를 고르고 부모 Outlet이 자식을 렌더합니다
예제의 다섯 후보 가운데 /products/456은 동적 products/:id branch에 맞습니다. search와 hash는 같은 화면의 입력이며 pathname branch 선택과 구분합니다.
실제 ProductDetail · 문자열 ID와 데이터 조회
/products/456?tab=spec#buy
RootLayout → Outlet
→ ProductDetail
params.id = "456"
React 후드티 · 45,000원ID 형식 오류, 존재하지 않는 데이터, 일치하는 route가 없는 경우는 따로 처리합니다. /products/new는 정적 branch가 동적 :id보다 구체적입니다.
location.pathname/products/456이 route 매칭 입력이 됩니다.<Routes>가 다섯 branch를 비교합니다index·about·products/new·products/:id·*의 구체성을 비교하므로 단순한 첫 항목 선택이 아닙니다.
후보 element: Home · About · NewProduct · ProductDetail · NotFound.
/ + products/:id가 선택됩니다부모와 자식 match가 함께 남고
params.id는 문자열"456"입니다.중첩 element tree를 렌더링합니다
RootLayout이 유지되고ProductDetail이 부모의Outlet에 들어갑니다.
| URL 부분 | 예 | React Router API | route branch 선택 |
|---|---|---|---|
| pathname | /products/456 |
useParams() → { id: "456" } |
참여 · path 패턴과 비교 |
| search | ?tab=spec |
useSearchParams() |
같은 pathname branch의 보기 조건 |
| hash | #buy |
useLocation().hash |
branch 선택과 분리된 fragment |
pathname · /products/456
path 패턴과 비교하며, 동적 segment 값은 useParams()로 읽습니다.
search · ?tab=spec
useSearchParams()로 읽고 갱신합니다. pathname branch 자체를 고르는 값은 아닙니다.
hash · #buy
useLocation().hash로 읽는 fragment이며 pathname 매칭과 분리됩니다.
정적 branch는 동적 branch보다 구체적이고 splat은 fallback입니다. 경로 param·search·hash는 모두 외부 입력이므로 사용 전에 형식과 허용 범위를 검증합니다.
이 예의 조건
- 도표의 전체 구조와 설명은 위 관계도와 표에서 볼 수 있습니다. 아래 표에도 도표의 관계·조건·라벨·설명·주석을 모았습니다.
- 두 칸의 위치는 고정입니다. 현재 상태는 그 순간의 값이고, 동작·이유는 그 조건에서의 판정과 변화 원인입니다. 독립 비교와 실패 분기는 별도 조건이므로 모든 분기를 한 요청의 실행 순서로 이어 읽지 않습니다.
관계도의 보충 설명
| 구분 | 내용 |
|---|---|
| 도표 설명 | /products/456이 route 매칭 입력이 됩니다. |
| 도표 조건·주석 | location.pathname: /products/456이 route 매칭 입력이 됩니다. |
| 도표 설명 | <Routes>가 다섯 branch를 비교합니다 |
| 도표 조건·주석 | <Routes>가 다섯 branch를 비교합니다. index·about·products/new·products/:id·*의 구체성을 비교하므로 단순한 첫 항목 선택이 아닙니다. 후보 element: Home · About · NewProduct · ProductDetail · NotFound. |
| 도표 설명 | / + products/:id가 선택됩니다 |
| 도표 설명 | 부모와 자식 match가 함께 남고 params.id는 문자열 "456"입니다. |
| 도표 조건·주석 | / + products/:id가 선택됩니다. 부모와 자식 match가 함께 남고 params.id는 문자열 "456"입니다. |
| 도표 설명 | RootLayout이 유지되고 ProductDetail이 부모의 Outlet에 들어갑니다. |
| 도표 조건·주석 | 중첩 element tree를 렌더링합니다. RootLayout이 유지되고 ProductDetail이 부모의 Outlet에 들어갑니다. |
| 도표 표 행 | URL 부분 | 예 | React Router API | route branch 선택 |
| 도표 표 행 | pathname | /products/456 | useParams() → { id: "456" } | 참여 · path 패턴과 비교 |
| 도표 표 행 | search | ?tab=spec | useSearchParams() | 같은 pathname branch의 보기 조건 |
| 도표 표 행 | hash | #buy | useLocation().hash | branch 선택과 분리된 fragment |
| 도표 설명 | path 패턴과 비교하며, 동적 segment 값은 useParams()로 읽습니다. |
| 도표 설명 | useSearchParams()로 읽고 갱신합니다. pathname branch 자체를 고르는 값은 아닙니다. |
| 도표 설명 | useLocation().hash로 읽는 fragment이며 pathname 매칭과 분리됩니다. |
| 장면 | 현재 관찰값 | 설명 | 변화 이유 |
|---|---|---|---|
| 현재 location | pathname: /products/456 / 후보: 5개의 route branch | pathname은 /products/456입니다 | 등록 순서가 첫 매칭의 선택 규칙은 아닙니다 |
| 구체 branch 선택 | branch: RootLayout + ProductDetail / params.id: 문자열 456 | products/:id가 현재 경로를 매칭합니다 | path 매칭은 resource의 존재 검증이 아닙니다 |
| Outlet 표시 | 부모: RootLayout / child: ProductDetail | 부모 RootLayout의 Outlet에 ProductDetail을 렌더합니다 | 부모가 Outlet을 빠뜨리면 자식의 표시 자리가 없습니다 |
위 그림은 Routes가 주소 /products/456을 받았을 때 후보들을 모두 비교해 가장 구체적으로 맞는 하나를 고르는 모습입니다. 다섯 후보 가운데 홈, about, products/new, * 네 개가 지금 우리 앱에 있는 라우트입니다. 지금은 /products/456에 맞는 것이 *뿐이라서 이 주소에 들어가면 NotFound가 보입니다. 그림에서 이 주소를 받는 products/:id와 ProductDetail은 다음 글에서, 공통 틀인 RootLayout과 Outlet은 중첩 라우팅 소개에서 다룹니다.
여기까지의 전체 파일
import { Route, Routes } from 'react-router';
import Navbar from './components/Navbar';
import Home from './pages/Home';
import About from './pages/About';
import NewProduct from './pages/NewProduct';
import NotFound from './pages/NotFound';
export default function App() {
return (
<div>
<h1>내 쇼핑몰</h1>
<Navbar />
<Routes>
<Route path="/" element={<Home />} />
<Route path="/about" element={<About />} />
<Route path="/products/new" element={<NewProduct />} />
<Route path="*" element={<NotFound />} />
</Routes>
</div>
);
}import { NavLink } from 'react-router';
export default function Navbar() {
return (
<nav>
<NavLink to="/">홈</NavLink> <NavLink to="/about">소개</NavLink>{' '}
<NavLink to="/products/new">상품 등록</NavLink>
</nav>
);
}앱 안의 이동과 문서 요청이 만나는 곳
이 글에서 만든 이동은 두 갈래입니다. Link와 NavLink, navigate는 문서를 그대로 둔 채 방문 기록만 바꾸고, <a href> 클릭과 주소창 입력, 새로고침은 서버에 문서를 먼저 요청합니다. 어느 쪽으로 오든 마지막에는 같은 Routes가 주소에 맞는 화면을 고릅니다.
내부 탐색과 직접 진입의 처리 차이 — 상태 추적
Link/history와 document GET은 출발점이 다르지만 같은 route matching에 합류합니다. HTTP 404/200과 client splat UI가 별개임을 실제 URL 사례로 보여 줍니다.
REACT ROUTING · URL & RESPONSIBILITY
같은 route tree에 도달해도 문서 응답을 맡는 쪽은 다릅니다
현재 문서가 처리하는 내부 이동은 history와 location으로, 직접 진입은 host의 문서 응답으로 시작합니다. Declarative Routes는 실행 뒤 match와 element 렌더를 담당합니다.
확인할 URL · 직접 진입과 client fallback
/products/456?tab=spec#buy
→ 같은 상세 branch
/products/new → 정적 작성
/unknown/path → NotFound UI
(앱이 로드된 뒤)host가 entry HTML 200을 반환한 경우 client wildcard가 HTTP 상태를 바꾸지 않습니다. 제목·초점·알림·스크롤은 앱의 전환 정책으로 확인합니다.
앱 내부 탐색
Link·NavLink와 navigate(to)는 기본 PUSH 또는 명시한 REPLACE를 만듭니다. 뒤로·앞으로 이동이 현재 앱 문서의 entry에 머무르면 POP으로 location을 바꾸고 route branch를 다시 매칭합니다.
직접 진입 · 새로고침 · 새 탭
브라우저가 host/server에 문서를 먼저 요청합니다. client-only 정적 SPA rewrite는 알 수 없는 비자산 경로에도 entry HTML 200을 보낸 뒤 path="*" UI를 고를 수 있습니다. 실제 HTTP 404는 route-aware host나 SSR이 결정합니다.
| 영역 | React Router 기본 | 앱·host가 결정할 것 |
|---|---|---|
| 링크·활성 상태 | Link는 실제 anchor, NavLink는 활성 링크의 aria-current 값을 page로 설정 |
의미 있는 링크 문구와 useNavigate가 정말 비상호작용 이동인지 판단 |
| 초점·알림 | route 변경 뒤 UI에 관한 가정을 하지 않음 | 문서 제목, 주 콘텐츠 초점, 필요한 live-region 완료·오류 알림 |
| 스크롤 | Declarative mode는 location과 navigation primitives 제공 | 앱에서 복원 정책 구현, 또는 Data/Framework mode의 ScrollRestoration 사용 |
| 대기·오류 | <Routes>는 match와 element 렌더만 담당 |
앱 상태·React error boundary, 또는 Data/Framework mode의 pending·route error API |
| 404·보안 | path="*"는 앱 안의 unmatched UI를 선택 |
HTTP 상태·문서 fallback·API 분리·입력 검증·인증과 인가는 server가 맡음 |
링크·활성 상태
Link는 실제 anchor이고 NavLink는 활성 링크의 aria-current 값을 page로 설정합니다. 링크 문구와 이동 수단 선택은 앱이 정합니다.
초점·알림·스크롤
route 변경 뒤 제목, 주 콘텐츠 초점, 필요한 live-region 알림과 스크롤 정책을 앱이 설계합니다. Declarative mode는 앱에서 복원 정책을 구현하며, Data/Framework mode에서는 ScrollRestoration을 선택할 수 있습니다.
대기·오류
Declarative <Routes>는 match와 렌더만 담당합니다. 앱 상태와 React error boundary를 쓰거나 Data/Framework mode의 전용 API를 선택합니다.
404·보안
path="*"는 UI fallback입니다. HTTP 상태, 문서 fallback, API 분리, 입력 검증과 최종 인가는 host/server가 강제합니다.
client-only SPA의 path="*"는 unmatched UI를 선택할 뿐 이미 받은 entry 문서의 200 상태를 바꾸지 않습니다. HashRouter는 route location을 server로 전송되지 않는 hash에 두어 pathname fallback 부담을 피하지만, base URL에서 앱 문서를 제공하는 host 설정까지 없애지는 않습니다.
이 예의 조건
- 도표의 전체 구조와 설명은 위 관계도와 표에서 볼 수 있습니다. 아래 표에도 도표의 관계·조건·라벨·설명·주석을 모았습니다.
- 두 칸의 위치는 고정입니다. 현재 상태는 그 순간의 값이고, 동작·이유는 그 조건에서의 판정과 변화 원인입니다. 독립 비교와 실패 분기는 별도 조건이므로 모든 분기를 한 요청의 실행 순서로 이어 읽지 않습니다.
관계도의 보충 설명
| 구분 | 내용 |
|---|---|
| 도표 설명 | Link·NavLink와 navigate(to)는 기본 PUSH 또는 명시한 REPLACE를 만듭니다. 뒤로·앞으로 이동이 현재 앱 문서의 entry에 머무르면 POP으로 location을 바꾸고 route branch를 다시 매칭합니다. |
| 도표 설명 | 브라우저가 host/server에 문서를 먼저 요청합니다. client-only 정적 SPA rewrite는 알 수 없는 비자산 경로에도 entry HTML 200을 보낸 뒤 path="*" UI를 고를 수 있습니다. 실제 HTTP 404는 route-aware host나 SSR이 결정합니다. |
| 도표 표 행 | 영역 | React Router 기본 | 앱·host가 결정할 것 |
| 도표 표 행 | 링크·활성 상태 | Link는 실제 anchor, NavLink는 활성 링크의 aria-current 값을 page로 설정 | 의미 있는 링크 문구와 useNavigate가 정말 비상호작용 이동인지 판단 |
| 도표 표 행 | 초점·알림 | route 변경 뒤 UI에 관한 가정을 하지 않음 | 문서 제목, 주 콘텐츠 초점, 필요한 live-region 완료·오류 알림 |
| 도표 표 행 | 스크롤 | Declarative mode는 location과 navigation primitives 제공 | 앱에서 복원 정책 구현, 또는 Data/Framework mode의 ScrollRestoration 사용 |
| 도표 표 행 | 대기·오류 | <Routes>는 match와 element 렌더만 담당 | 앱 상태·React error boundary, 또는 Data/Framework mode의 pending·route error API |
| 도표 표 행 | 404·보안 | path="*"는 앱 안의 unmatched UI를 선택 | HTTP 상태·문서 fallback·API 분리·입력 검증·인증과 인가는 server가 맡음 |
| 도표 설명 | Link는 실제 anchor이고 NavLink는 활성 링크의 aria-current 값을 page로 설정합니다. 링크 문구와 이동 수단 선택은 앱이 정합니다. |
| 도표 설명 | route 변경 뒤 제목, 주 콘텐츠 초점, 필요한 live-region 알림과 스크롤 정책을 앱이 설계합니다. Declarative mode는 앱에서 복원 정책을 구현하며, Data/Framework mode에서는 ScrollRestoration을 선택할 수 있습니다. |
| 도표 설명 | Declarative <Routes>는 match와 렌더만 담당합니다. 앱 상태와 React error boundary를 쓰거나 Data/Framework mode의 전용 API를 선택합니다. |
| 도표 설명 | path="*"는 UI fallback입니다. HTTP 상태, 문서 fallback, API 분리, 입력 검증과 최종 인가는 host/server가 강제합니다. |
| 도표 설명 | client-only SPA의 path="*"는 unmatched UI를 선택할 뿐 이미 받은 entry 문서의 200 상태를 바꾸지 않습니다. HashRouter는 route location을 server로 전송되지 않는 hash에 두어 pathname fallback 부담을 피하지만, base URL에서 앱 문서를 제공하는 host 설정까지 없애지는 않습니다. |
| 장면 | 현재 관찰값 | 설명 | 변화 이유 |
|---|---|---|---|
| 앱 내부 탐색 | 문서: 현재 문서 유지 / 현재: client location | Link와 navigate가 history와 location을 바꿉니다 | 새 HTML 요청과는 다른 이동입니다 |
| 직접 진입 비교 | host: GET /products/456 / HTTP: 응답 status | 주소 입력은 host의 200 또는 404 응답을 먼저 얻습니다 | HTTP 404라면 client의 성공 경로와 구별합니다 |
| route 결과 | UI: route 또는 NotFound / HTTP: 200 유지 가능 | HTML 200 뒤 매칭 또는 SPA의 wildcard UI를 고릅니다 | NotFound UI가 자동으로 HTTP 404를 만들지는 않습니다 |
내부 탐색과 직접 진입의 처리 차이 — 상태 추적
Link/history와 document GET은 출발점이 다르지만 같은 route matching에 합류합니다. HTTP 404/200과 client splat UI가 별개임을 실제 URL 사례로 보여 줍니다.
REACT ROUTING · URL & RESPONSIBILITY
같은 route tree에 도달해도 문서 응답을 맡는 쪽은 다릅니다
현재 문서가 처리하는 내부 이동은 history와 location으로, 직접 진입은 host의 문서 응답으로 시작합니다. Declarative Routes는 실행 뒤 match와 element 렌더를 담당합니다.
확인할 URL · 직접 진입과 client fallback
/products/456?tab=spec#buy
→ 같은 상세 branch
/products/new → 정적 작성
/unknown/path → NotFound UI
(앱이 로드된 뒤)host가 entry HTML 200을 반환한 경우 client wildcard가 HTTP 상태를 바꾸지 않습니다. 제목·초점·알림·스크롤은 앱의 전환 정책으로 확인합니다.
앱 내부 탐색
Link·NavLink와 navigate(to)는 기본 PUSH 또는 명시한 REPLACE를 만듭니다. 뒤로·앞으로 이동이 현재 앱 문서의 entry에 머무르면 POP으로 location을 바꾸고 route branch를 다시 매칭합니다.
직접 진입 · 새로고침 · 새 탭
브라우저가 host/server에 문서를 먼저 요청합니다. client-only 정적 SPA rewrite는 알 수 없는 비자산 경로에도 entry HTML 200을 보낸 뒤 path="*" UI를 고를 수 있습니다. 실제 HTTP 404는 route-aware host나 SSR이 결정합니다.
| 영역 | React Router 기본 | 앱·host가 결정할 것 |
|---|---|---|
| 링크·활성 상태 | Link는 실제 anchor, NavLink는 활성 링크의 aria-current 값을 page로 설정 |
의미 있는 링크 문구와 useNavigate가 정말 비상호작용 이동인지 판단 |
| 초점·알림 | route 변경 뒤 UI에 관한 가정을 하지 않음 | 문서 제목, 주 콘텐츠 초점, 필요한 live-region 완료·오류 알림 |
| 스크롤 | Declarative mode는 location과 navigation primitives 제공 | 앱에서 복원 정책 구현, 또는 Data/Framework mode의 ScrollRestoration 사용 |
| 대기·오류 | <Routes>는 match와 element 렌더만 담당 |
앱 상태·React error boundary, 또는 Data/Framework mode의 pending·route error API |
| 404·보안 | path="*"는 앱 안의 unmatched UI를 선택 |
HTTP 상태·문서 fallback·API 분리·입력 검증·인증과 인가는 server가 맡음 |
링크·활성 상태
Link는 실제 anchor이고 NavLink는 활성 링크의 aria-current 값을 page로 설정합니다. 링크 문구와 이동 수단 선택은 앱이 정합니다.
초점·알림·스크롤
route 변경 뒤 제목, 주 콘텐츠 초점, 필요한 live-region 알림과 스크롤 정책을 앱이 설계합니다. Declarative mode는 앱에서 복원 정책을 구현하며, Data/Framework mode에서는 ScrollRestoration을 선택할 수 있습니다.
대기·오류
Declarative <Routes>는 match와 렌더만 담당합니다. 앱 상태와 React error boundary를 쓰거나 Data/Framework mode의 전용 API를 선택합니다.
404·보안
path="*"는 UI fallback입니다. HTTP 상태, 문서 fallback, API 분리, 입력 검증과 최종 인가는 host/server가 강제합니다.
client-only SPA의 path="*"는 unmatched UI를 선택할 뿐 이미 받은 entry 문서의 200 상태를 바꾸지 않습니다. HashRouter는 route location을 server로 전송되지 않는 hash에 두어 pathname fallback 부담을 피하지만, base URL에서 앱 문서를 제공하는 host 설정까지 없애지는 않습니다.
이 예의 조건
- 도표의 전체 구조와 설명은 위 관계도와 표에서 볼 수 있습니다. 아래 표에도 도표의 관계·조건·라벨·설명·주석을 모았습니다.
- 두 칸의 위치는 고정입니다. 현재 상태는 그 순간의 값이고, 동작·이유는 그 조건에서의 판정과 변화 원인입니다. 독립 비교와 실패 분기는 별도 조건이므로 모든 분기를 한 요청의 실행 순서로 이어 읽지 않습니다.
관계도의 보충 설명
| 구분 | 내용 |
|---|---|
| 도표 설명 | Link·NavLink와 navigate(to)는 기본 PUSH 또는 명시한 REPLACE를 만듭니다. 뒤로·앞으로 이동이 현재 앱 문서의 entry에 머무르면 POP으로 location을 바꾸고 route branch를 다시 매칭합니다. |
| 도표 설명 | 브라우저가 host/server에 문서를 먼저 요청합니다. client-only 정적 SPA rewrite는 알 수 없는 비자산 경로에도 entry HTML 200을 보낸 뒤 path="*" UI를 고를 수 있습니다. 실제 HTTP 404는 route-aware host나 SSR이 결정합니다. |
| 도표 표 행 | 영역 | React Router 기본 | 앱·host가 결정할 것 |
| 도표 표 행 | 링크·활성 상태 | Link는 실제 anchor, NavLink는 활성 링크의 aria-current 값을 page로 설정 | 의미 있는 링크 문구와 useNavigate가 정말 비상호작용 이동인지 판단 |
| 도표 표 행 | 초점·알림 | route 변경 뒤 UI에 관한 가정을 하지 않음 | 문서 제목, 주 콘텐츠 초점, 필요한 live-region 완료·오류 알림 |
| 도표 표 행 | 스크롤 | Declarative mode는 location과 navigation primitives 제공 | 앱에서 복원 정책 구현, 또는 Data/Framework mode의 ScrollRestoration 사용 |
| 도표 표 행 | 대기·오류 | <Routes>는 match와 element 렌더만 담당 | 앱 상태·React error boundary, 또는 Data/Framework mode의 pending·route error API |
| 도표 표 행 | 404·보안 | path="*"는 앱 안의 unmatched UI를 선택 | HTTP 상태·문서 fallback·API 분리·입력 검증·인증과 인가는 server가 맡음 |
| 도표 설명 | Link는 실제 anchor이고 NavLink는 활성 링크의 aria-current 값을 page로 설정합니다. 링크 문구와 이동 수단 선택은 앱이 정합니다. |
| 도표 설명 | route 변경 뒤 제목, 주 콘텐츠 초점, 필요한 live-region 알림과 스크롤 정책을 앱이 설계합니다. Declarative mode는 앱에서 복원 정책을 구현하며, Data/Framework mode에서는 ScrollRestoration을 선택할 수 있습니다. |
| 도표 설명 | Declarative <Routes>는 match와 렌더만 담당합니다. 앱 상태와 React error boundary를 쓰거나 Data/Framework mode의 전용 API를 선택합니다. |
| 도표 설명 | path="*"는 UI fallback입니다. HTTP 상태, 문서 fallback, API 분리, 입력 검증과 최종 인가는 host/server가 강제합니다. |
| 도표 설명 | client-only SPA의 path="*"는 unmatched UI를 선택할 뿐 이미 받은 entry 문서의 200 상태를 바꾸지 않습니다. HashRouter는 route location을 server로 전송되지 않는 hash에 두어 pathname fallback 부담을 피하지만, base URL에서 앱 문서를 제공하는 host 설정까지 없애지는 않습니다. |
| 장면 | 현재 관찰값 | 설명 | 변화 이유 |
|---|---|---|---|
| 앱 내부 탐색 | 문서: 현재 문서 유지 / 현재: client location | Link와 navigate가 history와 location을 바꿉니다 | 새 HTML 요청과는 다른 이동입니다 |
| 직접 진입 비교 | host: GET /products/456 / HTTP: 응답 status | 주소 입력은 host의 200 또는 404 응답을 먼저 얻습니다 | HTTP 404라면 client의 성공 경로와 구별합니다 |
| route 결과 | UI: route 또는 NotFound / HTTP: 200 유지 가능 | HTML 200 뒤 매칭 또는 SPA의 wildcard UI를 고릅니다 | NotFound UI가 자동으로 HTTP 404를 만들지는 않습니다 |
위 그림의 오른쪽 길이 앱 안의 이동이고, 왼쪽 길이 문서를 요청하는 이동입니다. 왼쪽 길에서는 서버가 문서를 돌려준 뒤에야 앱이 실행되어 Routes에 도착합니다. 주소창에 /unknown/path를 입력했을 때 Network 탭의 문서 요청이 404가 아니라 200인 것도 이 순서 때문입니다. 개발 서버가 index.html을 정상적으로 돌려주었고, "페이지를 찾을 수 없습니다"는 그 뒤에 * 라우트가 그린 화면입니다. 그림 아래 표는 React Router가 해 주는 일과 앱이나 서버가 정해야 하는 일을 나눈 것으로, 이 장을 마친 뒤 다시 보면 좋습니다.
더 깊이: "가장 구체적인 라우트"를 고르는 방법
React Router 8.5.1의 소스를 보면, 라우트마다 전체 경로에 점수를 매기고 점수가 높은 것부터 맞춰 봅니다. 점수는 경로를 /로 나눈 조각의 개수에서 시작해, 글자 그대로 적은 조각 하나에 10점, :id 같은 동적 조각에 3점, 빈 조각에 1점을 더하고, *가 들어 있으면 2점을 뺍니다. 그래서 /products/new는 /products/:id보다 점수가 높고, *만 있는 라우트는 거의 언제나 맨 마지막에 비교됩니다. 점수가 같을 때만 같은 부모 아래의 형제끼리 적은 순서대로 비교합니다. 이 숫자는 문서에 적힌 약속이 아니라 구현의 세부 사항이므로, 글자 그대로 적은 조각이 동적 조각보다, 동적 조각이 *보다 앞선다는 규칙만 기억하면 됩니다.
더 깊이: Declarative 모드와 다른 모드, HashRouter
React Router에는 이 글의 Declarative 모드 말고도 Data 모드와 Framework 모드가 있습니다. 두 모드는 라우트마다 데이터를 미리 불러오는 함수, 이동 중임을 알려 주는 상태, 라우트 단위의 오류 화면, 스크롤 위치 복원 같은 기능을 더 제공합니다. Declarative 모드에서는 이런 일을 앱이 직접 합니다. 예를 들어 데이터를 불러오는 동안의 로딩 표시는 8장에서 state로 직접 만듭니다. 화면이 바뀐 뒤 문서의 제목을 바꾸거나 본문으로 포커스를 옮기는 일도 React Router가 대신 정해 주지 않습니다.
HashRouter는 BrowserRouter 대신 쓸 수 있는 라우터로, 화면의 주소를 /#/about처럼 # 뒤에 둡니다. # 뒤의 부분은 서버에 전송되지 않으므로, 앞 글에서 본 대체 응답을 설정할 수 없는 서버에서도 새로고침이 동작합니다. 대신 주소 모양이 달라지므로, 서버를 설정할 수 있다면 BrowserRouter를 씁니다.
정리
react-router패키지를 설치하고,main.jsx에서 앱 전체를BrowserRouter로 한 번 감쌉니다.Route는 주소(path)와 화면(element)의 짝이고,Routes는 현재 주소에 가장 구체적으로 맞는 라우트 하나를 골라 그립니다. 적은 순서로 고르지 않습니다.- 앱 안의 이동은
Link로 만듭니다.<a href>는 React Router를 써도 문서를 새로 받습니다. NavLink는 현재 주소와 맞는 링크에active클래스와aria-current="page"를 붙입니다. 하위 주소에서 활성이 되지 않게 하려면end를 붙입니다.- 폼 제출처럼 어떤 일이 끝난 뒤의 이동은
useNavigate가 돌려준 함수로 시작합니다. path="*"라우트로 없는 주소에 보여 줄 화면을 만듭니다. 이 화면이 보여도 이미 받은 문서의 상태 코드는 바뀌지 않습니다.
연습 문제
1. 두 메뉴가 함께 강조되는 이유
Navbar에 <NavLink to="/products">상품 목록</NavLink>을 더했다고 합시다. "상품 등록" 메뉴를 눌러 /products/new에 있을 때 강조되는 메뉴는 무엇일까요? "상품 등록"만 강조되게 하려면 어떻게 고칠까요?
해설 보기
"상품 목록"과 "상품 등록"이 함께 강조됩니다. 현재 주소 /products/new는 /products로 시작하므로 to="/products"인 링크도 활성으로 판단됩니다. 두 링크 모두 aria-current="page"를 갖게 되어 보조 기술에도 현재 위치가 둘로 전달됩니다. "홈"은 to="/"의 예외 규칙 덕분에 강조되지 않습니다.
<NavLink to="/products" end>상품 목록</NavLink>으로 고치면 정확히 /products일 때만 활성이 됩니다.
2. 등록한 뒤 뒤로 가기
홈에서 "상품 등록" 메뉴를 눌러 등록 화면으로 간 뒤, 이름을 입력하고 등록해 홈으로 넘어왔습니다. 여기서 브라우저의 뒤로 가기를 누르면 어떤 화면이 나올까요? handleSubmit의 이동을 navigate('/', { replace: true })로 바꾸면 어떻게 달라질까요?
해설 보기
navigate('/')는 방문 기록에 새 항목을 더합니다. 기록은 홈, 상품 등록, 홈의 순서가 되고, 뒤로 가기는 가운데의 상품 등록 화면으로 돌아갑니다. 이때 NewProduct는 새로 그려지므로 입력했던 이름은 남아 있지 않습니다.
{ replace: true }를 주면 새 항목을 더하지 않고 현재 항목을 바꿉니다. 상품 등록 항목이 홈으로 바뀌어 기록은 홈, 홈이 되고, 뒤로 가기를 눌러도 상품 등록 화면이 나오지 않습니다. 등록이 끝난 폼으로 되돌아가 같은 상품을 한 번 더 등록하는 일을 막고 싶을 때 이 옵션을 씁니다.
3. 소개 화면이 비어 보이는 코드 고치기
다음 App에서 /는 잘 보이는데 /about에 가면 제목과 메뉴 아래가 비어 있습니다. * 라우트의 화면도 나오지 않습니다. 원인을 찾아 고쳐 보세요.
<Routes>
<Route path="/" element={<Home />} />
<Route path="/about" element={About} />
<Route path="*" element={<NotFound />} />
</Routes>해설 보기
/about 라우트의 element에 JSX 요소가 아니라 컴포넌트 함수 About을 그대로 넘겼습니다. 주소 /about은 이 라우트와 제대로 맞았으므로 *로 넘어가지 않습니다. 그런데 그 자리에 그릴 것이 요소가 아니라 함수라서 React는 아무것도 그리지 못합니다. 라우트가 맞지 않는 것과, 맞았지만 그릴 것이 잘못된 것은 다른 문제입니다.
<Route path="/about" element={<About />} />고친 뒤 /about에서 "소개"가 보이는지 확인합니다.
4. 상품 목록 화면의 자리 만들기
다음 글에서 채울 상품 목록 화면의 자리를 미리 만들어 보세요.
src/pages/ProductList.jsx를 만들고,/products에서 "상품 목록"이라는 제목이 보이게 합니다.- 메뉴의 "소개"와 "상품 등록" 사이에 "상품 목록"을 더합니다.
/products/new에서는 "상품 목록"이 강조되지 않아야 합니다. - 등록 화면에서 등록하면 홈이 아니라 상품 목록으로 이동하게 바꿉니다.
해설 보기
export default function ProductList() {
return (
<section>
<h2>상품 목록</h2>
</section>
);
}import { Route, Routes } from 'react-router';
import Navbar from './components/Navbar';
import Home from './pages/Home';
import About from './pages/About';
import ProductList from './pages/ProductList';
import NewProduct from './pages/NewProduct';
import NotFound from './pages/NotFound';
export default function App() {
return (
<div>
<h1>내 쇼핑몰</h1>
<Navbar />
<Routes>
<Route path="/" element={<Home />} />
<Route path="/about" element={<About />} />
<Route path="/products" element={<ProductList />} />
<Route path="/products/new" element={<NewProduct />} />
<Route path="*" element={<NotFound />} />
</Routes>
</div>
);
}import { NavLink } from 'react-router';
export default function Navbar() {
return (
<nav>
<NavLink to="/">홈</NavLink> <NavLink to="/about">소개</NavLink>{' '}
<NavLink to="/products" end>상품 목록</NavLink>{' '}
<NavLink to="/products/new">상품 등록</NavLink>
</nav>
);
}NewProduct.jsx에서는 navigate('/')를 navigate('/products')로 바꿉니다.
네 메뉴를 차례로 눌러 화면과 강조가 함께 바뀌는지, /products/new에서 "상품 등록"만 강조되는지, 등록한 뒤 "상품 목록" 화면으로 넘어가는지 확인합니다. /products와 /products/new는 둘 다 /products로 시작하지만 서로 다른 라우트입니다. Routes는 주소 전체가 맞는 라우트를 고르므로 /products/new에서 목록 화면이 나오지 않습니다.
다음 글 라우트 파라미터와 쿼리 문자열에서는 이 목록 화면에 상품을 채우고, 상품마다 다른 주소를 가진 상세 화면과 주소에 남는 검색어를 만듭니다.