Skip to content

Storybook 치트시트

컴포넌트를 독립적으로 만들고 테스트하는 UI 컴포넌트 작업대입니다.

01

시작하기

스토리

CSF 형식으로 스토리를 정의합니다.

storybook
import type { Meta, StoryObj } from "@storybook/react";
import Button from "./Button";

const meta: Meta<typeof Button> = {
  title: "Button",
  component: Button,
};
export default meta;

type Story = StoryObj<typeof Button>;
export const Primary: Story = {
  args: { primary: true, label: "Click" },
};

컨트롤

props를 인터랙티브하게 조작하는 Controls입니다.

storybook
export const Default: Story = {
  args: {
    label: "Button",
    size: "md",
  },
  argTypes: {
    size: { control: "select", options: ["sm", "md", "lg"] },
  },
};
02

주요 기능

데코레이터

데코레이터로 스토리를 감쌀 수 있습니다.

storybook
export const WithPadding: Story = {
  decorators: [(Story) => <div style={{padding: 20}}><Story /></div>],
};

Play 함수

인터랙션 테스트를 위한 play 함수입니다.

storybook
export const Interactive: Story = {
  play: async ({ canvasElement }) => {
    const canvas = within(canvasElement);
    await userEvent.click(canvas.getByRole("button"));
    await expect(canvas.getByText("Clicked")).toBeInTheDocument();
  },
};

Was this helpful?