메인 콘텐츠로 건너뛰기

탐색경로 구성요소

마지막 업데이트:

사용자 정의 구분 기호 및 접근 가능한 랜드마크 마크업이 포함된 CSS 전용 Tailwind CSS 탐색경로 탐색입니다. WCAG AA는 Django, HTMX, Laravel, React 및 모든 Tailwind CSS v4 프로젝트에서 작동합니다.

이동 경로 구성 요소는 탐색 계층 구조를 표시하고 사용자가 웹 사이트 내에서 자신의 위치를 ​​이해하는 데 도움을 줍니다. 접근성을 위한 시맨틱 HTML 탐색 요소와 ARIA 랜드마크로 구축된 이동 경로는 사용자가 상위 섹션으로 빠르게 이동할 수 있도록 하여 유용성을 향상시킵니다. Frutjam 이동 경로 시스템은 자동으로 구분 기호를 렌더링하고 유연한 스타일을 위해 사용자 정의 구분 기호를 지원합니다.

CSS 전용이며 JavaScript가 필요하지 않습니다. WCAG AA 액세스 가능 및 프레임워크에 구애받지 않음 — Django, HTMX, Laravel, React 및 모든 스택에서 작동합니다.

수업 유형 설명
breadcrumb베이스탐색경로 트레일용 탐색 컨테이너
breadcrumb-list수정자탐색경로 항목의 주문 목록
breadcrumb-item수정자탐색경로의 개별 목록 항목
breadcrumb-link수정자탐색경로 링크 스타일의 앵커 요소
breadcrumb-separator수정자항목 사이의 구분 요소
breadcrumb-current수정자현재(활성) 페이지 항목을 표시합니다.

기본 사용법

구분 기호가 제공되지 않으면 탐색경로 항목 사이에 자동으로 화살표가 표시됩니다.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
<nav class="breadcrumb" aria-label="Breadcrumb">
  <ol class="breadcrumb-list">
    <li class="breadcrumb-item">
      <a href="/" class="breadcrumb-link">Home</a>
    </li>
    <li class="breadcrumb-item">
      <span class="breadcrumb-current" aria-current="page">Current Page</span>
    </li>
  </ol>
</nav>
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
<nav className="breadcrumb" aria-label="Breadcrumb">
  <ol className="breadcrumb-list">
    <li className="breadcrumb-item">
      <a href="/" className="breadcrumb-link">Home</a>
    </li>
    <li className="breadcrumb-item">
      <span className="breadcrumb-current" aria-current="page">Current Page</span>
    </li>
  </ol>
</nav>
html
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
<nav class="breadcrumb" aria-label="Breadcrumb">
  <ol class="breadcrumb-list">
    <li class="breadcrumb-item">
      <a href="/" class="breadcrumb-link">Home</a>
    </li>
    <li class="breadcrumb-item">
      <span class="breadcrumb-separator">/</span>
      <a href="/components" class="breadcrumb-link">Components</a>
    </li>
    <li class="breadcrumb-item">
      <span class="breadcrumb-separator">/</span>
      <span class="breadcrumb-current" aria-current="page">Badge</span>
    </li>
  </ol>
</nav>
html
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
<nav class="breadcrumb" aria-label="Breadcrumb">
  <ol class="breadcrumb-list">
    <li class="breadcrumb-item">
      <a href="/" class="breadcrumb-link">Home</a>
    </li>
    <li class="breadcrumb-item">
      <span class="breadcrumb-separator">
        <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
          <path d="M5 12h14"></path>
          <path d="m12 5 7 7-7 7"></path>
        </svg>
      </span>
      <a href="/components" class="breadcrumb-link">Components</a>
    </li>
    <li class="breadcrumb-item">
      <span class="breadcrumb-separator">
        <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
          <path d="M5 12h14"></path>
          <path d="m12 5 7 7-7 7"></path>
        </svg>
      </span>
      <span class="breadcrumb-current" aria-current="page">Button</span>
    </li>
  </ol>
</nav>

화면 판독기에서 탐색경로에 액세스할 수 있도록 하려면 다음을 수행하세요.

  • aria-label="Breadcrumb"를 사용하여 <nav> 요소의 구조를 래핑합니다.
  • 마지막 항목(현재 페이지)은 aria-current="page"를 사용해야 하며 링크보다는 <span>을 사용하는 것이 좋습니다.
  • 구분 기호는 스크린 리더에서 무시되어야 합니다(종종 CSS를 통해 처리되거나 물리적 요소를 사용하는 경우 aria-hidden="true").

Claude Code, Cursor 또는 다른 AI 편집기를 사용하시나요?

Cherry MCP는 AI 편집기에 요청 시 정확한 탐색경로 클래스 이름과 구조를 제공합니다. 더 이상 환각에 빠진 수업은 없습니다.

Cherry MCP를 사용해 보세요