Files
HMDesign/src/components/carousel.stories.tsx
T
shkim4 da0e647b49 docs(storybook): simplify sidebar Story pages around the UI
Drop the category kicker from the 83 sidebar Stories (kicker is now optional;
hidden verification Stories keep it) and shorten or remove repeated, obvious
or internal page/section descriptions. Required specs, limits, virtual-data
and undecided-value notices stay. Story IDs, exports, fixtures, shared state
notes and package code are unchanged. Record: docs/reports/storybook-ui-simplification-2026-10-22.md
2026-10-22 16:13:58 +09:00

169 lines
6.2 KiB
TypeScript

import { useEffect, useState, type ReactNode } from "react"
import type { Meta, StoryObj } from "@storybook/react-vite"
import { AspectRatio, Card, CardContent, Carousel, CarouselContent, CarouselItem, CarouselNext, CarouselPrevious, type CarouselApi } from "@hm-design/ui"
import { StateBoard } from "@/components/story-board"
import { StoryPage, StoryPageHeader, StorySection } from "@/components/story-page"
// The representative Story shows real, draggable carousels; the same specimens also exist as Stories tagged `verification`
// (hidden from the sidebar). Slide widths (`basis-*`) are the consumer's `className` on CarouselItem; Card and AspectRatio are
// Story composition (Carousel imports neither). `setApi` feeds the "slide n / total" readout.
const frame = (node: ReactNode) => <div style={{ width: "100%", maxWidth: 420, minWidth: 0 }}>{node}</div>
const svg = (n: number) =>
"data:image/svg+xml;utf8," +
encodeURIComponent(
`<svg xmlns="http://www.w3.org/2000/svg" width="480" height="270"><rect width="480" height="270" fill="${["#266651", "#3e3523", "#205241", "#604f32", "#123328"][n % 5]}"/><text x="24" y="52" font-family="sans-serif" font-size="34" fill="#ffffff">Slide ${n + 1}</text></svg>`
)
function SlideCard({ n }: { n: number }) {
return (
<Card>
<CardContent className="grid h-24 place-items-center text-2xl font-bold">{n + 1}</CardContent>
</Card>
)
}
function useReadout() {
const [api, setApi] = useState<CarouselApi>()
const [current, setCurrent] = useState(0)
const [count, setCount] = useState(0)
useEffect(() => {
if (!api) return
setCount(api.scrollSnapList().length)
setCurrent(api.selectedScrollSnap() + 1)
api.on("select", () => setCurrent(api.selectedScrollSnap() + 1))
}, [api])
return { setApi, current, count }
}
function Basic() {
const { setApi, current, count } = useReadout()
return frame(
<div className="grid gap-2">
<Carousel setApi={setApi} aria-label="기본 carousel">
<CarouselContent>
{Array.from({ length: 5 }, (_, i) => (
<CarouselItem key={i}>
<SlideCard n={i} />
</CarouselItem>
))}
</CarouselContent>
<CarouselPrevious />
<CarouselNext />
</Carousel>
<span className="text-center text-sm text-muted-foreground" data-testid="readout">{`slide ${current} / ${count}`}</span>
</div>
)
}
function Multiple() {
return frame(
<Carousel opts={{ align: "start" }} aria-label="여러 항목 carousel">
<CarouselContent>
{Array.from({ length: 8 }, (_, i) => (
<CarouselItem key={i} className="basis-1/2">
<SlideCard n={i} />
</CarouselItem>
))}
</CarouselContent>
<CarouselPrevious />
<CarouselNext />
</Carousel>
)
}
function Loop() {
const { setApi, current, count } = useReadout()
return frame(
<div className="grid gap-2">
<Carousel opts={{ loop: true }} setApi={setApi} aria-label="loop carousel">
<CarouselContent>
{Array.from({ length: 3 }, (_, i) => (
<CarouselItem key={i}>
<SlideCard n={i} />
</CarouselItem>
))}
</CarouselContent>
<CarouselPrevious />
<CarouselNext />
</Carousel>
<span className="text-center text-sm text-muted-foreground" data-testid="loop-readout">{`slide ${current} / ${count}`}</span>
</div>
)
}
function Vertical() {
return (
<div style={{ width: 220, height: 260 }}>
<Carousel orientation="vertical" opts={{ align: "start" }} aria-label="세로 carousel" className="h-full">
<CarouselContent style={{ height: 260 }}>
{Array.from({ length: 4 }, (_, i) => (
<CarouselItem key={i} className="basis-1/2">
<SlideCard n={i} />
</CarouselItem>
))}
</CarouselContent>
<CarouselPrevious />
<CarouselNext />
</Carousel>
</div>
)
}
function Media() {
return frame(
<Carousel aria-label="미디어 carousel">
<CarouselContent>
{Array.from({ length: 4 }, (_, i) => (
<CarouselItem key={i}>
<AspectRatio ratio={16 / 9}>
<img src={svg(i)} alt={`슬라이드 ${i + 1}`} className="size-full rounded-md object-cover" />
</AspectRatio>
</CarouselItem>
))}
</CarouselContent>
<CarouselPrevious />
<CarouselNext />
</Carousel>
)
}
const sections = [
{ id: "basic", label: "Basic (single item) + setApi readout", node: <Basic /> },
{ id: "multiple", label: "Multiple items (basis-1/2)", node: <Multiple /> },
{ id: "loop", label: "Loop (controls never disable)", node: <Loop /> },
{ id: "vertical", label: "Vertical", node: <Vertical /> },
{ id: "media", label: "Media (AspectRatio composition)", node: <Media /> },
]
const meta = { title: "Components/Data & Display/Carousel", component: Carousel, parameters: { layout: "padded" } } satisfies Meta<typeof Carousel>
export default meta
type Story = StoryObj<typeof meta>
const board = (...ids: string[]) => (
<StateBoard min={460} states={sections.filter((s) => ids.includes(s.id)).map((s) => ({ id: s.id, label: s.label, children: s.node }))} />
)
// Representative Story: the common Story page; the sections group the same specimens.
export const All: Story = {
name: "Carousel",
parameters: { layout: "fullscreen", controls: { disable: true } },
render: () => (
<StoryPage>
<StoryPageHeader
title="Carousel"
description="슬라이드 폭(basis-*)은 CarouselItem className"
/>
<StorySection title="Overview">{board("basic")}</StorySection>
<StorySection title="Variants" description="여러 항목 · loop · 세로">{board("multiple", "loop", "vertical")}</StorySection>
<StorySection title="Usage">{board("media")}</StorySection>
</StoryPage>
),
}
export const BasicCarousel: Story = { tags: ["verification"], name: "Basic", render: () => <Basic /> }
export const MultipleItems: Story = { tags: ["verification"], name: "Multiple Items", render: () => <Multiple /> }
export const LoopCarousel: Story = { tags: ["verification"], name: "Loop", render: () => <Loop /> }
export const VerticalCarousel: Story = { tags: ["verification"], name: "Vertical", render: () => <Vertical /> }