Skip to Content
Lynx

Chip Tabs

Chip 형태로 표현된 탭 컴포넌트입니다. 카테고리나 필터를 선택하여 콘텐츠를 전환할 때 사용합니다.

Engine ≥ 3.9<viewpager><viewpager-item>
사용 가능 버전@seed-design/lynx-react@0.8.0, @seed-design/lynx-css@0.12.0
Lynx 예제를 불러오는 중입니다.

Installation

npx @seed-design/cli@latest add ui:chip-tabs

Props

ChipTabsRoot

Prop

Type

value?string | undefined
defaultValue?string | undefined
onValueChange?((value: string) => void) | undefined

ChipTabsList

Prop

Type

ChipTabsTrigger

Prop

Type

notification?boolean | undefined
valuestring
disabled?boolean | undefined
childrenstring | number

ChipTabsCarousel

Prop

Type

swipeable?boolean | undefined
onSettle?(() => void) | undefined

ChipTabsContent

Prop

Type

valuestring

Usage

Content

탭 선택으로만 콘텐츠를 전환할 때는 ChipTabsContent를 ChipTabsRoot 안에 배치합니다. Trigger와 Content의 value를 맞추면 선택된 패널만 표시됩니다. 이 구성은 콘텐츠 높이에 맞춰 배치되며 좌우 스와이프는 제공하지 않습니다.

import {
  ChipTabsContent,
  ChipTabsList,
  ChipTabsRoot,
  ChipTabsTrigger,
} from "@/components/ui/chip-tabs";

export function App() {
  return (
    <ChipTabsRoot defaultValue="1">
      <ChipTabsList>
        <ChipTabsTrigger value="1">라벨1</ChipTabsTrigger>
        <ChipTabsTrigger value="2">라벨2</ChipTabsTrigger>
        <ChipTabsTrigger value="3">라벨3</ChipTabsTrigger>
      </ChipTabsList>
      <ChipTabsContent value="1">
        <text>첫 번째 콘텐츠</text>
      </ChipTabsContent>
      <ChipTabsContent value="2">
        <text>두 번째 콘텐츠</text>
      </ChipTabsContent>
      <ChipTabsContent value="3">
        <text>세 번째 콘텐츠</text>
      </ChipTabsContent>
    </ChipTabsRoot>
  );
}

ChipTabsRoot는 value와 onValueChange로 제어하거나 defaultValue로 초기 선택 값을 지정합니다. notification을 설정한 Trigger에는 알림 배지가 표시됩니다.

Swipeable

콘텐츠를 좌우로 밀어 탭을 바꾸려면 ChipTabsContent를 ChipTabsCarousel 안에 배치하고 swipeable을 설정합니다. Carousel에 앱 레이아웃에 맞는 높이를 지정하세요. iOS의 뒤로 가기 제스처 범위는 iosBackGestureEdgeWidth로 조절할 수 있습니다.

Lynx 예제를 불러오는 중입니다.

Scroll Alignment

ChipTabsList의 scrollAlign은 선택한 chip을 가로 목록에 맞추는 방식입니다. "nearest", "start", "center", "end"를 지원하며 기본값은 "nearest"입니다.

"nearest"는 선택한 chip이 완전히 보이면 이동하지 않고, 일부가 가려졌을 때만 필요한 만큼 스크롤합니다.

Lynx 예제를 불러오는 중입니다.

Examples

Size=Medium

medium의 최소 높이는 36px입니다.

Lynx 예제를 불러오는 중입니다.

Size=Large

large의 최소 높이는 40px입니다.

Lynx 예제를 불러오는 중입니다.

Variant=Neutral Solid

Lynx 예제를 불러오는 중입니다.

Variant=Neutral Outline

Lynx 예제를 불러오는 중입니다.

Notification

Lynx 예제를 불러오는 중입니다.

With Scroll Fog

ChipTabsList를 placement={["left", "right"]}인 ScrollFog로 감싸면 좌우에 fog를 표시할 수 있습니다.

Lynx 예제를 불러오는 중입니다.

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 영역이며, 두 경계선 사이는 안전 영역입니다.

Lynx 예제를 불러오는 중입니다.

Last updated on

목차