라우트 매칭

라우트 매칭은 일관되고 예측 가능한 패턴을 따릅니다. 이 가이드에서는 라우트 트리가 매칭되는 방식을 설명합니다.

TanStack Router가 라우트 트리를 처리할 때 모든 라우트를 가장 구체적인 라우트부터 매칭하도록 자동 정렬합니다. 따라서 라우트 트리를 정의한 순서와 관계없이 라우트는 항상 다음 순서로 정렬됩니다.

• 인덱스 라우트
• 정적 라우트(가장 구체적인 라우트부터 가장 덜 구체적인 라우트 순)
• 동적 라우트(가장 긴 라우트부터 가장 짧은 라우트 순)
• Splat/와일드카드 라우트

다음 의사 라우트 트리를 살펴보겠습니다.

Root
  - blog
    - $postId
    - /
    - new
  - /
  - *
  - about
  - about/us

정렬하면 이 라우트 트리는 다음과 같이 됩니다.

Root
  - /
  - about/us
  - about
  - blog
    - /
    - new
    - $postId
  - *

이 최종 순서는 구체성에 따라 라우트를 매칭하는 순서를 나타냅니다.

이 라우트 트리를 사용해 몇 가지 다른 URL의 매칭 과정을 살펴보겠습니다.

• /blog

  Root
    ❌ /
    ❌ about/us
    ❌ about
    ⏩ blog
      ✅ /
      - new
      - $postId
    - *
• /blog/my-post

  Root
    ❌ /
    ❌ about/us
    ❌ about
    ⏩ blog
      ❌ /
      ❌ new
      ✅ $postId
    - *
• /

  Root
    ✅ /
    - about/us
    - about
    - blog
      - /
      - new
      - $postId
    - *
• /not-a-route

  Root
    ❌ /
    ❌ about/us
    ❌ about
    ❌ blog
      - /
      - new
      - $postId
    ✅ *