Get StartedFoundationsComponentsPatternsRulesDevelopAI & ToolsUpdates

Chip Tabs

Chip 형태의 탭으로, 카테고리나 필터를 골라 콘텐츠를 전환할 때 써요.

설치

pnpm dlx shadcn@latest add https://rebar.conmarket-landing.workers.dev/r/chip-tabs.json

Anatomy

Chip Tabs는 Tabs의 Chip 타입이에요. Label이 있는 Chip 형태의 Tab Item 모음으로 구성되고, Tab Item에는 필요에 따라 Notification Badge를 표시할 수 있어요.

요소컴포넌트설명
RootChipTabsRoot선택 상태와 Variant, 사이즈를 관리해요.
Chip TablistChipTabsListChip을 가로로 늘어놓는 영역이에요. 넘치면 가로로 스크롤돼요.
Tab ItemChipTabsTrigger하나의 Chip 탭이에요. 키보드 방향키로 이동할 수 있어요.
ContentChipTabsContent선택된 탭의 콘텐츠예요.

Properties

Variant

Neutral Solid, Neutral Outline 두 가지 Variant가 있어요. 화면 전체 콘텐츠를 전환할 때는 Solid 스타일을, 일부 콘텐츠를 전환할 때는 Outline 스타일을 권장해요.

Size

Large, Medium 두 가지 사이즈가 있어요. 기본값은 medium 이에요.

State

Tab Item은 Enabled, Selected, Disabled 상태를 가져요. 누르면 Chip이 살짝 작아지고, Disabled 상태는 반투명하게 보여요.

Notification

Tab Item에 새 콘텐츠가 있음을 알리는 Notification Badge를 notification 으로 표시할 수 있어요.

Scroll

Chip이 많아 목록이 넘치면 가로로 스크롤돼요. Chip은 줄어들지 않고 원래 너비를 유지해요. 좌우 여백은 화면 가장자리 여백과 같은 16px 을 유지해요.

Guidelines

Solid와 Outline 고르기

화면 전체 콘텐츠를 전환한다면 Solid 스타일을, 화면의 일부 콘텐츠만 전환한다면 Outline 스타일을 써요.

다른 Chip과 함께 쓰지 않기

화면 안 다른 Chip 요소와 함께 쓰면 동작이 헷갈려요. Filter Chip과 함께 써야 한다면 Line 스타일의 Tabs를 써요.

상품동네
가격거리
Do· Line Tabs + Filter Chip

Line 스타일 Tabs와 Filter Chip을 조합해요.

상품동네
가격거리
Don't· Chip Tabs + Filter Chip

Chip 스타일을 겹쳐 쓰면 어떤 것이 탭인지 알기 어려워요.

2차 분류에 사용하기

탭 구조를 이중으로 표시할 때는 1차 분류에 Line 타입 Tabs를, 2차 분류에 Chip Tabs를 조합해요.

새로운 콘텐츠 알리기

Notification Badge는 콘텐츠를 확인하면 사라지도록 하고, 여러 탭에 동시에 표시하는 것은 피해요.

Props

ChipTabsRoot

Prop

Type

ChipTabsTrigger

Prop

Type

ChipTabsContent

Prop

Type

On this page