Chip Tabs
Chip 형태로 표현된 탭 컴포넌트입니다. 카테고리나 필터를 선택하여 콘텐츠를 전환할 때 사용합니다.
<viewpager><viewpager-item>Installation
의존성 설치
아래 코드를 복사 후 붙여넣고 사용하세요
Props
ChipTabsRoot
Prop
Type
value?string | undefineddefaultValue?string | undefinedonValueChange?((value: string) => void) | undefinedChipTabsList
Prop
Type
ChipTabsTrigger
Prop
Type
notification?boolean | undefinedvaluestringdisabled?boolean | undefinedchildrenstring | numberChipTabsCarousel
Prop
Type
swipeable?boolean | undefinedonSettle?(() => void) | undefinedChipTabsContent
Prop
Type
valuestringUsage
Content
탭 선택으로만 콘텐츠를 전환할 때는 ChipTabsContent를 ChipTabsRoot 안에 배치합니다. Trigger와 Content의 value를 맞추면 선택된 패널만 표시됩니다. 이 구성은 콘텐츠 높이에 맞춰 배치되며 좌우 스와이프는 제공하지 않습니다.
ChipTabsRoot는 value와 onValueChange로 제어하거나 defaultValue로 초기 선택 값을 지정합니다. notification을 설정한 Trigger에는 알림 배지가 표시됩니다.
Swipeable
콘텐츠를 좌우로 밀어 탭을 바꾸려면 ChipTabsContent를 ChipTabsCarousel 안에 배치하고 swipeable을 설정합니다. Carousel에 앱 레이아웃에 맞는 높이를 지정하세요. iOS의 뒤로 가기 제스처 범위는 iosBackGestureEdgeWidth로 조절할 수 있습니다.
Scroll Alignment
ChipTabsList의 scrollAlign은 선택한 chip을 가로 목록에 맞추는 방식입니다. "nearest", "start", "center", "end"를 지원하며 기본값은 "nearest"입니다.
"nearest"는 선택한 chip이 완전히 보이면 이동하지 않고, 일부가 가려졌을 때만 필요한 만큼 스크롤합니다.
Examples
Size=Medium
medium의 최소 높이는 36px입니다.
Size=Large
large의 최소 높이는 40px입니다.
Variant=Neutral Solid
Variant=Neutral Outline
Notification
With Scroll Fog
ChipTabsList를 placement={["left", "right"]}인 ScrollFog로 감싸면 좌우에 fog를 표시할 수 있습니다.
Web Version Differences
- 탭 이벤트는
onClick대신bindtap으로 받습니다. - Carousel은 네이티브
<viewpager>, 가로 탭 목록은<scroll-view>를 사용합니다. - Root 밖에서 선택 값에 따라 네이티브 콘텐츠를 조건부로 렌더링할 수 있습니다.
Unsupported Lynx Features
- 키보드 포커스와 roving focus
- RTL 순서와 스와이프 방향 반전
lazyMount,unmountOnExit- Carousel의
loop,autoHeight,dragThreshold,carouselPreventDrag - 콘텐츠 전환 애니메이션
Extending to Safe Area
ChipTabsRoot에 extendSafeAreaX를 지정하면 스크롤 영역과 Carousel 패널이 좌우 Safe Area까지 확장됩니다. 첫 chip과 마지막 chip에는 기존 화면 여백과 inset이 함께 적용되고, 패널 내용은 안전 영역 안에 남습니다. 기본값은 false입니다.
기본 scrollAlign="nearest"는 안전 영역 안에 보이는 chip을 움직이지 않고, inset에 가린 chip만 안쪽으로 스크롤합니다.
Box pl="safeArea" pr="safeArea"처럼 좌우 inset을 이미 확보한 컨테이너 바로 안에서 사용하세요. inset을 확보하지 않은 곳에 적용하면 화면 밖으로 넘칠 수 있습니다. Carousel 안의 fixed 요소처럼 부모의 padding을 따르지 않는 요소는 별도로 처리해야 합니다.
확장 전 / 확장 후
| 비교 | 확장 전 (AS IS) | 확장 후 (TO BE) |
|---|---|---|
| 배경·스크롤 영역 | chip 목록과 패널이 안전 영역 안에서 끝남 | 스크롤 영역과 패널이 좌우 끝까지 이어짐 |
| 콘텐츠 | 안전 영역 안에 배치 | 처음·마지막 chip의 여백과 패널 내용은 안전 영역 안에 유지 |
아래 스위치를 켜고 끄며 같은 예제에서 비교할 수 있습니다. 브라우저에는 비교용 좌우 inset을 적용합니다. 붉은 빗금은 콘텐츠를 피해야 하는 inset 영역이며, 두 경계선 사이는 안전 영역입니다. QR로 연 기기에서는 실제 inset을 사용하므로, 좌우 inset이 모두 0이면 차이가 보이지 않을 수 있습니다. 적용 조건은 Safe Area 가이드를 참고하세요.
비교용 inset: 왼쪽 24px · 오른쪽 48px (가상)
붉은 빗금은 콘텐츠를 피해야 하는 inset 영역이며, 두 경계선 사이는 안전 영역입니다.
Last updated on