Tabs
한 화면 내에서 콘텐츠를 탭 단위로 구분하여 전환할 수 있는 컴포넌트입니다.
import { TabsContent, TabsList, TabsRoot, TabsTrigger } from "seed-design/ui/tabs";
export default function TabsPreview() {
return (
<div style={{ width: "360px" }}>
<TabsRoot defaultValue="1">
<TabsList>
<TabsTrigger value="1">라벨1</TabsTrigger>
<TabsTrigger value="2">라벨2</TabsTrigger>
<TabsTrigger value="3">라벨3</TabsTrigger>
</TabsList>
<TabsContent value="1">
<Content>Content 1</Content>
</TabsContent>
<TabsContent value="2">
<Content>Content 2</Content>
</TabsContent>
<TabsContent value="3">
<Content>Content 3</Content>
</TabsContent>
</TabsRoot>
</div>
);
}
const Content = (props: React.PropsWithChildren) => {
return (
<div
style={{
display: "flex",
justifyContent: "center",
alignItems: "center",
height: "300px",
backgroundColor: "var(--seed-color-bg-layer-default)",
}}
>
{props.children}
</div>
);
};Installation
npx @seed-design/cli@latest add ui:tabspnpm dlx @seed-design/cli@latest add ui:tabsyarn dlx @seed-design/cli@latest add ui:tabsbun x @seed-design/cli@latest add ui:tabs의존성 설치
npm install @seed-design/reactyarn add @seed-design/reactpnpm add @seed-design/reactbun add @seed-design/react아래 코드를 복사 후 붙여넣고 사용하세요
/**
* @file ui:tabs
* @requires @seed-design/react@^2.0.0 || ^3.0.0
**/
"use client";
import {
Box,
NotificationBadge,
NotificationBadgePositioner,
Tabs as SeedTabs,
} from "@seed-design/react";
import { forwardRef } from "react";
export interface TabsRootProps extends SeedTabs.RootProps {}
export const TabsRoot = forwardRef<HTMLDivElement, TabsRootProps>((props, ref) => {
const { children, ...otherProps } = props;
return (
<SeedTabs.Root ref={ref} {...otherProps}>
{children}
</SeedTabs.Root>
);
});
TabsRoot.displayName = "TabsRoot";
export interface TabsListProps extends Omit<SeedTabs.ListProps, "asChild"> {}
export const TabsList = forwardRef<HTMLDivElement, TabsListProps>((props, ref) => {
const { children, ...otherProps } = props;
return (
<SeedTabs.List ref={ref} {...otherProps}>
{children}
<SeedTabs.Indicator />
</SeedTabs.List>
);
});
TabsList.displayName = "TabsList";
export interface TabsTriggerProps extends Omit<SeedTabs.TriggerProps, "asChild"> {
notification?: boolean;
}
export const TabsTrigger = forwardRef<HTMLButtonElement, TabsTriggerProps>((props, ref) => {
const { children, notification, ...otherProps } = props;
return (
<SeedTabs.Trigger ref={ref} {...otherProps}>
{notification ? (
<Box as="span" position="relative">
{children}
<NotificationBadgePositioner size="small" attach="text">
<NotificationBadge />
</NotificationBadgePositioner>
</Box>
) : (
children
)}
</SeedTabs.Trigger>
);
});
TabsTrigger.displayName = "TabsTrigger";
export interface TabsCarouselProps extends Omit<SeedTabs.CarouselProps, "asChild"> {}
export const TabsCarousel = (props: TabsCarouselProps) => {
const { children, ...otherProps } = props;
return (
<SeedTabs.Carousel {...otherProps}>
<SeedTabs.CarouselCamera>{children}</SeedTabs.CarouselCamera>
</SeedTabs.Carousel>
);
};
TabsCarousel.displayName = "TabsCarousel";
export interface TabsContentProps extends SeedTabs.ContentProps {}
export const TabsContent = SeedTabs.Content;
/**
* This file is a snippet from SEED Design, helping you get started quickly with @seed-design/* packages.
* You can extend this snippet however you want.
*/
Props
TabsRoot
Prop
Type
value?string | undefineddefaultValue?string | undefinedonValueChange?((value: string) => void) | undefinedorientation?"horizontal" | "vertical" | undefinedTabsList
Prop
Type
TabsTrigger
Prop
Type
notification?boolean | undefinedvaluestringdisabled?boolean | undefinedTabsCarousel
Prop
Type
swipeable?boolean | undefinedautoHeight?boolean | undefinedloop?boolean | undefineddragThreshold?number | undefinedonSettle?(() => void) | undefinedTabsContent
Prop
Type
valuestringExamples
Layout Fill (Default)
import { TabsContent, TabsList, TabsRoot, TabsTrigger } from "seed-design/ui/tabs";
export default function TabsLayoutFill() {
return (
<div style={{ width: "360px" }}>
<TabsRoot defaultValue="2" triggerLayout="fill">
<TabsList>
<TabsTrigger value="1">라벨1</TabsTrigger>
<TabsTrigger value="2">라벨2</TabsTrigger>
<TabsTrigger value="3">라벨3</TabsTrigger>
</TabsList>
<TabsContent value="1">
<Content>Content 1</Content>
</TabsContent>
<TabsContent value="2">
<Content>Content 2</Content>
</TabsContent>
<TabsContent value="3">
<Content>Content 3</Content>
</TabsContent>
</TabsRoot>
</div>
);
}
const Content = (props: React.PropsWithChildren) => {
return (
<div
style={{
display: "flex",
justifyContent: "center",
alignItems: "center",
height: "300px",
backgroundColor: "var(--seed-color-bg-layer-default)",
}}
>
{props.children}
</div>
);
};Layout Hug
import { TabsContent, TabsList, TabsRoot, TabsTrigger } from "seed-design/ui/tabs";
export default function TabsLayoutHug() {
return (
<div style={{ width: "360px" }}>
<TabsRoot defaultValue="1" triggerLayout="hug">
<TabsList>
<TabsTrigger value="1">라벨1</TabsTrigger>
<TabsTrigger value="2">라벨2</TabsTrigger>
<TabsTrigger value="3">라벨3</TabsTrigger>
</TabsList>
<TabsContent value="1">
<Content>Content 1</Content>
</TabsContent>
<TabsContent value="2">
<Content>Content 2</Content>
</TabsContent>
<TabsContent value="3">
<Content>Content 3</Content>
</TabsContent>
</TabsRoot>
</div>
);
}
const Content = (props: React.PropsWithChildren) => {
return (
<div
style={{
display: "flex",
justifyContent: "center",
alignItems: "center",
height: "300px",
backgroundColor: "var(--seed-color-bg-layer-default)",
}}
>
{props.children}
</div>
);
};Size Medium
import { TabsContent, TabsList, TabsRoot, TabsTrigger } from "seed-design/ui/tabs";
export default function TabsSizeMedium() {
return (
<div style={{ width: "360px" }}>
<TabsRoot defaultValue="1" size="medium">
<TabsList>
<TabsTrigger value="1">라벨1</TabsTrigger>
<TabsTrigger value="2">라벨2</TabsTrigger>
<TabsTrigger value="3">라벨3</TabsTrigger>
</TabsList>
<TabsContent value="1">
<Content>Content 1</Content>
</TabsContent>
<TabsContent value="2">
<Content>Content 2</Content>
</TabsContent>
<TabsContent value="3">
<Content>Content 3</Content>
</TabsContent>
</TabsRoot>
</div>
);
}
const Content = (props: React.PropsWithChildren) => {
return (
<div
style={{
display: "flex",
justifyContent: "center",
alignItems: "center",
height: "300px",
backgroundColor: "var(--seed-color-bg-layer-default)",
}}
>
{props.children}
</div>
);
};Size Small (Default)
import { TabsContent, TabsList, TabsRoot, TabsTrigger } from "seed-design/ui/tabs";
export default function TabsSizeSmall() {
return (
<div style={{ width: "360px" }}>
<TabsRoot defaultValue="1" size="small">
<TabsList>
<TabsTrigger value="1">라벨1</TabsTrigger>
<TabsTrigger value="2">라벨2</TabsTrigger>
<TabsTrigger value="3">라벨3</TabsTrigger>
</TabsList>
<TabsContent value="1">
<Content>Content 1</Content>
</TabsContent>
<TabsContent value="2">
<Content>Content 2</Content>
</TabsContent>
<TabsContent value="3">
<Content>Content 3</Content>
</TabsContent>
</TabsRoot>
</div>
);
}
const Content = (props: React.PropsWithChildren) => {
return (
<div
style={{
display: "flex",
justifyContent: "center",
alignItems: "center",
height: "300px",
backgroundColor: "var(--seed-color-bg-layer-default)",
}}
>
{props.children}
</div>
);
};Transition
TabsCarousel 컴포넌트로 TabsContent 컴포넌트들을 감싸면 탭 변경시 컨텐츠가 자연스럽게 전환됩니다.
import { TabsRoot, TabsList, TabsTrigger, TabsCarousel, TabsContent } from "seed-design/ui/tabs";
export default function TabsTransition() {
return (
<div style={{ width: "360px" }}>
<TabsRoot defaultValue="2">
<TabsList>
<TabsTrigger value="1">라벨1</TabsTrigger>
<TabsTrigger value="2">라벨2</TabsTrigger>
<TabsTrigger value="3">라벨3</TabsTrigger>
</TabsList>
<TabsCarousel>
<TabsContent value="1">
<Content>Content 1</Content>
</TabsContent>
<TabsContent value="2">
<Content>Content 2</Content>
</TabsContent>
<TabsContent value="3">
<Content>Content 3</Content>
</TabsContent>
</TabsCarousel>
</TabsRoot>
</div>
);
}
const Content = (props: React.PropsWithChildren) => {
return (
<div
style={{
display: "flex",
justifyContent: "center",
alignItems: "center",
height: "300px",
backgroundColor: "var(--seed-color-bg-layer-default)",
}}
>
{props.children}
</div>
);
};Swipeable
TabsCarousel 컴포넌트에 swipeable 속성을 추가하면 스와이프 제스처로 탭을 이동할 수 있습니다.
import { TabsRoot, TabsList, TabsTrigger, TabsCarousel, TabsContent } from "seed-design/ui/tabs";
export default function TabsSwipeable() {
return (
<div style={{ width: "360px" }}>
<TabsRoot defaultValue="2">
<TabsList>
<TabsTrigger value="1">라벨1</TabsTrigger>
<TabsTrigger value="2">라벨2</TabsTrigger>
<TabsTrigger value="3">라벨3</TabsTrigger>
</TabsList>
<TabsCarousel swipeable>
<TabsContent value="1">
<Content>Content 1</Content>
</TabsContent>
<TabsContent value="2">
<Content>Content 2</Content>
</TabsContent>
<TabsContent value="3">
<Content>Content 3</Content>
</TabsContent>
</TabsCarousel>
</TabsRoot>
</div>
);
}
const Content = (props: React.PropsWithChildren) => {
return (
<div
style={{
display: "flex",
justifyContent: "center",
alignItems: "center",
height: "300px",
backgroundColor: "var(--seed-color-bg-layer-default)",
}}
>
{props.children}
</div>
);
};Carousel Prevent Drag
Tabs.carouselPreventDrag를 사용하면 특정 요소가 드래그 제스처에 반응하지 않도록 설정할 수 있습니다.
import { Box, Tabs } from "@seed-design/react";
import { TabsCarousel, TabsContent, TabsList, TabsRoot, TabsTrigger } from "seed-design/ui/tabs";
export default function TabsCarouselPreventDrag() {
return (
<Box width="360px" height="480px">
<TabsRoot contentLayout="fill" defaultValue="1">
<TabsList>
<TabsTrigger value="1">Tab 1</TabsTrigger>
<TabsTrigger value="2">Tab 2</TabsTrigger>
</TabsList>
<TabsCarousel swipeable>
<TabsContent value="1">
<Box overflowX="scroll" {...Tabs.carouselPreventDrag}>
<Box width="1000px" height="100px" bg="bg.criticalWeak">
Scrollable area
</Box>
</Box>
Lorem ipsum dolor sit, amet consectetur adipisicing elit. Reiciendis ab ex accusantium
sit. Amet maxime eum molestiae nemo. Beatae sint omnis aut cumque doloremque fugit
perspiciatis rerum possimus, reiciendis eaque?
</TabsContent>
<TabsContent value="2">
Lorem ipsum dolor sit amet consectetur adipisicing elit.
</TabsContent>
</TabsCarousel>
</TabsRoot>
</Box>
);
}Disabled
import { TabsContent, TabsList, TabsRoot, TabsTrigger } from "seed-design/ui/tabs";
export default function TabsDisabled() {
return (
<div style={{ width: "360px" }}>
<TabsRoot defaultValue="1">
<TabsList>
<TabsTrigger value="1">라벨1</TabsTrigger>
<TabsTrigger value="2" disabled>
라벨2
</TabsTrigger>
<TabsTrigger value="3">라벨3</TabsTrigger>
</TabsList>
<TabsContent value="1">
<Content>Content 1</Content>
</TabsContent>
<TabsContent value="2">
<Content>Content 2</Content>
</TabsContent>
<TabsContent value="3">
<Content>Content 3</Content>
</TabsContent>
</TabsRoot>
</div>
);
}
const Content = (props: React.PropsWithChildren) => {
return (
<div
style={{
display: "flex",
justifyContent: "center",
alignItems: "center",
height: "300px",
backgroundColor: "var(--seed-color-bg-layer-default)",
}}
>
{props.children}
</div>
);
};Notification
import { TabsContent, TabsList, TabsRoot, TabsTrigger } from "seed-design/ui/tabs";
export default function TabsNotification() {
return (
<div style={{ width: "360px" }}>
<TabsRoot defaultValue="1">
<TabsList>
<TabsTrigger value="1">라벨1</TabsTrigger>
<TabsTrigger value="2" notification>
라벨2
</TabsTrigger>
<TabsTrigger value="3">라벨3</TabsTrigger>
</TabsList>
<TabsContent value="1">
<Content>Content 1</Content>
</TabsContent>
<TabsContent value="2">
<Content>Content 2</Content>
</TabsContent>
<TabsContent value="3">
<Content>Content 3</Content>
</TabsContent>
</TabsRoot>
</div>
);
}
const Content = (props: React.PropsWithChildren) => {
return (
<div
style={{
display: "flex",
justifyContent: "center",
alignItems: "center",
height: "300px",
backgroundColor: "var(--seed-color-bg-layer-default)",
}}
>
{props.children}
</div>
);
};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 영역이며, 두 경계선 사이는 안전 영역입니다.
import { useState } from "react";
import { Box, Text, VStack } from "@seed-design/react";
import { Switch } from "seed-design/ui/switch";
import { TabsRoot, TabsList, TabsTrigger, TabsContent, TabsCarousel } from "seed-design/ui/tabs";
const items = ["전체", "동네 소식", "중고거래", "동네 생활", "가까운 이웃", "추천 소식"];
export default function Example() {
const [extend, setExtend] = useState(false);
return (
<VStack gap="x4" width="100%">
<Switch checked={extend} onCheckedChange={setExtend} label="안전 영역까지 확장" />
<Text textStyle="t3Bold">
{extend
? "확장 후 (TO BE) · extendSafeAreaX=true"
: "확장 전 (AS IS) · extendSafeAreaX=false"}
</Text>
<Box pl="safeArea" pr="safeArea" className="docs-safe-area-frame">
<TabsRoot defaultValue="0" extendSafeAreaX={extend} triggerLayout="hug">
<TabsList>
{items.map((label, index) => (
<TabsTrigger key={label} value={String(index)}>
{label}
</TabsTrigger>
))}
</TabsList>
<TabsCarousel swipeable>
{items.map((label, index) => (
<TabsContent key={label} value={String(index)}>
<Box px="spacingX.globalGutter" py="x6">
<Text>{label} 콘텐츠</Text>
</Box>
</TabsContent>
))}
</TabsCarousel>
</TabsRoot>
</Box>
</VStack>
);
}Sticky List
탭이 전체화면을 차지하고, Tabs.List가 top에 고정되어 있는 경우 사용하는 예시입니다.
import { TabsContent, TabsList, TabsRoot, TabsTrigger } from "seed-design/ui/tabs";
export default function TabsStickyList() {
return (
// 600은 화면 높이라고 가정합니다. 실제 앱에서는 화면(body)이 스크롤 컨테이너 역할을 하므로
// 예제에서는 overflowY로 이를 흉내냅니다. TabsList는 이 컨테이너의 top에 고정됩니다.
<div style={{ width: "360px", height: "600px", overflowY: "auto" }}>
<TabsRoot defaultValue="1" size="medium" stickyList>
<TabsList>
<TabsTrigger value="1">라벨1</TabsTrigger>
<TabsTrigger value="2">라벨2</TabsTrigger>
<TabsTrigger value="3">라벨3</TabsTrigger>
</TabsList>
<TabsContent value="1">
<Content height="1000px">Content 1</Content>
</TabsContent>
<TabsContent value="2">
<Content height="1000px">Content 2</Content>
</TabsContent>
<TabsContent value="3">
<Content height="1000px">Content 3</Content>
</TabsContent>
</TabsRoot>
</div>
);
}
const Content = (props: React.PropsWithChildren<{ height: string }>) => {
const { height, children } = props;
return (
<div
style={{
display: "flex",
justifyContent: "center",
alignItems: "center",
height,
background: "linear-gradient(to bottom, white, gray)",
}}
>
{children}
</div>
);
};Standalone
TabContent를 사용하지 않고, 컨텐츠 영역을 온전히 소유하고 싶을 때 사용하는 예시입니다.
탭에서 제공하는 Swipe 기능을 사용할 수 없습니다.
import { useState } from "react";
import { TabsList, TabsRoot, TabsTrigger } from "seed-design/ui/tabs";
export default function TabsStandalone() {
const [activeTab, setActiveTab] = useState("1");
return (
<div style={{ width: "360px" }}>
<TabsRoot defaultValue="1" onValueChange={setActiveTab}>
<TabsList>
<TabsTrigger value="1">라벨1</TabsTrigger>
<TabsTrigger value="2">라벨2</TabsTrigger>
<TabsTrigger value="3">라벨3</TabsTrigger>
</TabsList>
{activeTab === "1" && (
<div>
<Content>Content 1</Content>
</div>
)}
{activeTab === "2" && (
<div>
<Content>Content 2</Content>
</div>
)}
{activeTab === "3" && (
<div>
<Content>Content 3</Content>
</div>
)}
</TabsRoot>
</div>
);
}
const Content = (props: React.PropsWithChildren) => {
return (
<div
style={{
display: "flex",
justifyContent: "center",
alignItems: "center",
height: "300px",
backgroundColor: "var(--seed-color-bg-layer-default)",
}}
>
{props.children}
</div>
);
};Dynamic Height
각 탭의 높이가 다를 때, 아래의 컨텐츠를 탭 아래에 바로 맞추기 위해서 사용하는 예시입니다.
탭이 자주 바뀌고, 탭에 네트워크 요청이 많은 경우 캐싱을 잘 고려해주세요.
import { TabsCarousel, TabsContent, TabsList, TabsRoot, TabsTrigger } from "seed-design/ui/tabs";
export default function TabsDynamicHeight() {
return (
<div style={{ width: "360px" }}>
<TabsRoot defaultValue="1" lazyMount unmountOnExit>
<TabsList>
<TabsTrigger value="1">라벨1</TabsTrigger>
<TabsTrigger value="2">라벨2</TabsTrigger>
<TabsTrigger value="3">라벨3</TabsTrigger>
</TabsList>
<TabsCarousel autoHeight>
<TabsContent value="1">
<Content height="100px">Content 1</Content>
</TabsContent>
<TabsContent value="2">
<Content height="200px">Content 2</Content>
</TabsContent>
<TabsContent value="3">
<Content height="300px">Content 3</Content>
</TabsContent>
</TabsCarousel>
</TabsRoot>
<div style={{ height: "100px", backgroundColor: "gray" }}>아래 컨텐츠</div>
</div>
);
}
const Content = (props: React.PropsWithChildren<{ height: string }>) => {
const { height, children } = props;
return (
<div
style={{
display: "flex",
justifyContent: "center",
alignItems: "center",
height,
backgroundColor: "var(--seed-color-bg-layer-default)",
}}
>
{children}
</div>
);
};Scroll to Top
import { RefObject, useRef, useState } from "react";
import { TabsCarousel, TabsContent, TabsList, TabsRoot, TabsTrigger } from "seed-design/ui/tabs";
export default function TabsScrollTop() {
const [currentTab, setCurrentTab] = useState("1");
const contentRefs: Record<string, RefObject<HTMLDivElement | null>> = {
"1": useRef(null),
"2": useRef(null),
};
const handleTriggerClick = (value: string) => {
if (value === currentTab) {
contentRefs[value].current?.scrollTo({ top: 0, behavior: "smooth" });
}
};
return (
<div style={{ width: "360px" }}>
<TabsRoot triggerLayout="fill" value={currentTab} onValueChange={setCurrentTab}>
<TabsList>
<TabsTrigger onClick={() => handleTriggerClick("1")} value="1">
라벨1
</TabsTrigger>
<TabsTrigger onClick={() => handleTriggerClick("2")} value="2">
라벨2
</TabsTrigger>
</TabsList>
<TabsCarousel swipeable>
<TabsContent ref={contentRefs["1"]} value="1" style={{ maxHeight: "200px" }}>
<Content height="1000px">Content 1</Content>
</TabsContent>
<TabsContent ref={contentRefs["2"]} value="2" style={{ maxHeight: "200px" }}>
<Content height="1000px">Content 2</Content>
</TabsContent>
</TabsCarousel>
</TabsRoot>
</div>
);
}
const Content = (props: React.PropsWithChildren<{ height: string }>) => {
const { height, children } = props;
return (
<div
style={{
display: "flex",
justifyContent: "center",
height,
backgroundColor: "var(--seed-color-bg-layer-default)",
}}
>
{children}
</div>
);
};Last updated on