Skip to Content
React

Tabs

한 화면 내에서 콘텐츠를 탭 단위로 구분하여 전환할 수 있는 컴포넌트입니다.

사용 가능 버전@seed-design/react@0.0.1, @seed-design/css@0.0.1

Installation

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

Props

TabsRoot

Prop

Type

value?string | undefined
defaultValue?string | undefined
onValueChange?((value: string) => void) | undefined
orientation?"horizontal" | "vertical" | undefined

TabsList

Prop

Type

TabsTrigger

Prop

Type

notification?boolean | undefined
valuestring
disabled?boolean | undefined

TabsCarousel

Prop

Type

swipeable?boolean | undefined
autoHeight?boolean | undefined
loop?boolean | undefined
dragThreshold?number | undefined
onSettle?(() => void) | undefined

TabsContent

Prop

Type

valuestring

Examples

Layout Fill (Default)

Layout Hug

Size Medium

Size Small (Default)

Transition

TabsCarousel 컴포넌트로 TabsContent 컴포넌트들을 감싸면 탭 변경시 컨텐츠가 자연스럽게 전환됩니다.

Swipeable

TabsCarousel 컴포넌트에 swipeable 속성을 추가하면 스와이프 제스처로 탭을 이동할 수 있습니다.

Tabs.carouselPreventDrag를 사용하면 특정 요소가 드래그 제스처에 반응하지 않도록 설정할 수 있습니다.

Disabled

Notification

Extending to Safe Area

TabsRoot에 extendSafeAreaX를 지정하면 목록 배경과 하단 선, TabsCarousel의 패널이 좌우 safe area inset까지 화면 끝으로 넓어지고, 탭과 패널 내용은 safe area 안에 남습니다. AppScreenContent처럼 inset을 반영한 컨테이너 바로 안에서 사용하세요. 화면 끝까지 채우는 다른 방법은 Safe Area 구현 가이드를 참고하세요.

TabsCarousel의 패널은 inset만큼 안쪽 여백을 다시 가지므로, 패널 안에서도 AppScreenContent 안과 같은 방법으로 요소를 화면 끝까지 넓힐 수 있습니다. 다만 100vw나 position: fixed처럼 패널의 여백을 따르지 않는 요소는 이 보정을 받지 않습니다.

아래 예제는 좌우에 가상의 inset을 적용합니다. 붉은 빗금은 콘텐츠를 피해야 하는 inset 영역이며, 두 경계선 사이는 안전 영역입니다. 스위치로 확장 전(AS IS)과 확장 후(TO BE)를 비교하고, 배경·스크롤 영역의 경계와 콘텐츠 위치를 확인하세요. 같은 버전에서 옵션을 끄고 켠 비교입니다.

비교용 inset: 왼쪽 24px · 오른쪽 48px (가상)

붉은 빗금은 콘텐츠를 피해야 하는 inset 영역이며, 두 경계선 사이는 안전 영역입니다.

Sticky List

탭이 전체화면을 차지하고, Tabs.List가 top에 고정되어 있는 경우 사용하는 예시입니다.

Standalone

TabContent를 사용하지 않고, 컨텐츠 영역을 온전히 소유하고 싶을 때 사용하는 예시입니다.

탭에서 제공하는 Swipe 기능을 사용할 수 없습니다.

Dynamic Height

각 탭의 높이가 다를 때, 아래의 컨텐츠를 탭 아래에 바로 맞추기 위해서 사용하는 예시입니다.

탭이 자주 바뀌고, 탭에 네트워크 요청이 많은 경우 캐싱을 잘 고려해주세요.

Scroll to Top

Last updated on

목차