Grid

import { Grid } from '@vapor-ui/core';

export default function DefaultGrid() {
    return (
        <Grid.Root templateColumns="repeat(3, 1fr)" gap="4">
            <Grid.Item className="bg-gray-100 p-4 rounded">1</Grid.Item>
            <Grid.Item className="bg-gray-100 p-4 rounded">2</Grid.Item>
            <Grid.Item className="bg-gray-100 p-4 rounded">3</Grid.Item>
            <Grid.Item className="bg-gray-100 p-4 rounded">4</Grid.Item>
            <Grid.Item className="bg-gray-100 p-4 rounded">5</Grid.Item>
            <Grid.Item className="bg-gray-100 p-4 rounded">6</Grid.Item>
        </Grid.Root>
    );
}

Property

Template

Grid의 행과 열 템플릿을 설정하여 레이아웃 구조를 정의할 수 있습니다.

Template Columns

200px

1fr

100px

Template Rows

60px

1fr

40px

import { Grid } from '@vapor-ui/core';

export default function GridTemplate() {
    return (
        <div className="flex flex-wrap gap-4">
            <div>
                <h4 className="text-sm font-medium mb-2">Template Columns</h4>
                <Grid.Root templateColumns="200px 1fr 100px" gap="2">
                    <Grid.Item className="bg-blue-100 p-2 rounded text-center">200px</Grid.Item>
                    <Grid.Item className="bg-blue-100 p-2 rounded text-center">1fr</Grid.Item>
                    <Grid.Item className="bg-blue-100 p-2 rounded text-center">100px</Grid.Item>
                </Grid.Root>
            </div>

            <div>
                <h4 className="text-sm font-medium mb-2">Template Rows</h4>
                <Grid.Root
                    templateColumns="1fr"
                    templateRows="60px 1fr 40px"
                    gap="2"
                    className="h-40"
                >
                    <Grid.Item className="bg-green-100 p-2 rounded text-center">60px</Grid.Item>
                    <Grid.Item className="bg-green-100 p-2 rounded text-center">1fr</Grid.Item>
                    <Grid.Item className="bg-green-100 p-2 rounded text-center">40px</Grid.Item>
                </Grid.Root>
            </div>
        </div>
    );
}

Flow

Grid 아이템들의 자동 배치 방향을 설정할 수 있습니다.

Row Flow

Column Flow

import { Grid } from '@vapor-ui/core';

export default function GridFlow() {
    return (
        <div className="flex flex-wrap gap-4">
            <div>
                <h4 className="text-sm font-medium mb-2">Row Flow</h4>
                <Grid.Root templateColumns="repeat(3, 1fr)" flow="row" gap="2">
                    <Grid.Item className="bg-purple-100 p-2 rounded text-center">1</Grid.Item>
                    <Grid.Item className="bg-purple-100 p-2 rounded text-center">2</Grid.Item>
                    <Grid.Item className="bg-purple-100 p-2 rounded text-center">3</Grid.Item>
                    <Grid.Item className="bg-purple-100 p-2 rounded text-center">4</Grid.Item>
                    <Grid.Item className="bg-purple-100 p-2 rounded text-center">5</Grid.Item>
                </Grid.Root>
            </div>

            <div>
                <h4 className="text-sm font-medium mb-2">Column Flow</h4>
                <Grid.Root templateRows="repeat(3, 1fr)" flow="column" gap="2" className="h-32">
                    <Grid.Item className="bg-orange-100 p-2 rounded text-center">1</Grid.Item>
                    <Grid.Item className="bg-orange-100 p-2 rounded text-center">2</Grid.Item>
                    <Grid.Item className="bg-orange-100 p-2 rounded text-center">3</Grid.Item>
                    <Grid.Item className="bg-orange-100 p-2 rounded text-center">4</Grid.Item>
                    <Grid.Item className="bg-orange-100 p-2 rounded text-center">5</Grid.Item>
                </Grid.Root>
            </div>
        </div>
    );
}

Inline

Grid를 인라인 요소로 표시할 수 있습니다.

Block Grid (default)

Block level grid

Inline Grid

Inline grid

import { Grid } from '@vapor-ui/core';

export default function GridInline() {
    return (
        <div className="flex flex-wrap gap-4">
            <div>
                <h4 className="text-sm font-medium mb-2">Block Grid (default)</h4>
                <Grid.Root templateColumns="repeat(2, 1fr)" gap="2">
                    <Grid.Item className="bg-indigo-100 p-2 rounded text-center">1</Grid.Item>
                    <Grid.Item className="bg-indigo-100 p-2 rounded text-center">2</Grid.Item>
                </Grid.Root>
                <p className="text-sm text-gray-600 mt-1">Block level grid</p>
            </div>

            <div>
                <h4 className="text-sm font-medium mb-2">Inline Grid</h4>
                <Grid.Root inline templateColumns="repeat(2, 1fr)" gap="2">
                    <Grid.Item className="bg-pink-100 p-2 rounded text-center">1</Grid.Item>
                    <Grid.Item className="bg-pink-100 p-2 rounded text-center">2</Grid.Item>
                </Grid.Root>
                <span className="text-sm text-gray-600 ml-2">Inline grid</span>
            </div>
        </div>
    );
}

Span

Grid 아이템이 차지할 행이나 열의 개수를 설정할 수 있습니다.

Column Span

Span 2

Span 3

Row Span

Row Span 2

import { Grid } from '@vapor-ui/core';

export default function GridSpan() {
    return (
        <div className="flex flex-wrap gap-4">
            <div>
                <h4 className="text-sm font-medium mb-2">Column Span</h4>
                <Grid.Root templateColumns="repeat(4, 1fr)" gap="2">
                    <Grid.Item className="bg-red-100 p-2 rounded text-center">1</Grid.Item>
                    <Grid.Item colSpan="2" className="bg-red-200 p-2 rounded text-center">
                        Span 2
                    </Grid.Item>
                    <Grid.Item className="bg-red-100 p-2 rounded text-center">4</Grid.Item>
                    <Grid.Item colSpan="3" className="bg-red-200 p-2 rounded text-center">
                        Span 3
                    </Grid.Item>
                    <Grid.Item className="bg-red-100 p-2 rounded text-center">8</Grid.Item>
                </Grid.Root>
            </div>

            <div>
                <h4 className="text-sm font-medium mb-2">Row Span</h4>
                <Grid.Root templateColumns="repeat(3, 1fr)" gap="2">
                    <Grid.Item rowSpan="2" className="bg-teal-200 p-2 rounded text-center">
                        Row Span 2
                    </Grid.Item>
                    <Grid.Item className="bg-teal-100 p-2 rounded text-center">2</Grid.Item>
                    <Grid.Item className="bg-teal-100 p-2 rounded text-center">3</Grid.Item>
                    <Grid.Item className="bg-teal-100 p-2 rounded text-center">5</Grid.Item>
                    <Grid.Item className="bg-teal-100 p-2 rounded text-center">6</Grid.Item>
                </Grid.Root>
            </div>
        </div>
    );
}

Examples

Layout Patterns

일반적인 레이아웃 패턴들을 Grid로 구현할 수 있습니다.

Dashboard Layout

Header

Sidebar

Main Content

Footer

Card Layout

Card 1

Card 2

Card 3

Card 4

import { Grid } from '@vapor-ui/core';

export default function GridLayout() {
    return (
        <div className="flex flex-wrap gap-4">
            <div>
                <h4 className="text-sm font-medium mb-2">Dashboard Layout</h4>
                <Grid.Root
                    templateColumns="200px 1fr"
                    templateRows="60px 1fr 40px"
                    gap="2"
                    className="h-64 w-full max-w-md"
                >
                    <Grid.Item
                        colSpan="2"
                        className="bg-gray-200 p-2 rounded flex items-center justify-center font-medium"
                    >
                        Header
                    </Grid.Item>
                    <Grid.Item className="bg-blue-100 p-2 rounded flex items-center justify-center">
                        Sidebar
                    </Grid.Item>
                    <Grid.Item className="bg-green-100 p-2 rounded flex items-center justify-center">
                        Main Content
                    </Grid.Item>
                    <Grid.Item
                        colSpan="2"
                        className="bg-gray-200 p-2 rounded flex items-center justify-center font-medium"
                    >
                        Footer
                    </Grid.Item>
                </Grid.Root>
            </div>

            <div>
                <h4 className="text-sm font-medium mb-2">Card Layout</h4>
                <Grid.Root
                    templateColumns="repeat(auto-fit, minmax(120px, 1fr))"
                    gap="2"
                    className="w-full max-w-md"
                >
                    <Grid.Item className="bg-yellow-100 p-4 rounded text-center">Card 1</Grid.Item>
                    <Grid.Item className="bg-yellow-100 p-4 rounded text-center">Card 2</Grid.Item>
                    <Grid.Item className="bg-yellow-100 p-4 rounded text-center">Card 3</Grid.Item>
                    <Grid.Item className="bg-yellow-100 p-4 rounded text-center">Card 4</Grid.Item>
                </Grid.Root>
            </div>
        </div>
    );
}

Props Table

Grid.Root

Grid 컨테이너 역할을 하는 루트 컴포넌트입니다.

Prop	Default	Type
inline?	false	boolean
templateRows?	undefined	string
templateColumns?	undefined	string
flow?	row	rowcolumnrow densecolumn dense

Grid.Item

Grid 아이템 역할을 하는 컴포넌트입니다.

Prop	Default	Type
rowSpan?	undefined	string
colSpan?	undefined	string

Template Columns

Template Rows

Row Flow

Column Flow

Block Grid (default)

Inline Grid

Column Span

Row Span

Dashboard Layout

Card Layout

On this page

Template Columns

Template Rows

Row Flow

Column Flow

Block Grid (default)

Inline Grid

Column Span

Row Span

Dashboard Layout

Card Layout