Box

Surface box with large padding

Outlined section

가져오기

import { Box } from "@pelagornis/page/components";

예제

위 미리보기는 이 파일을 렌더링한 것입니다. src/components/에 복사해서 시작하세요.

src/components/BoxExample.tsx

import { Box, Stack, Text } from "@pelagornis/page/components";

export default function BoxDemo() {
  return (
    <Stack gap="sizeMedium" className="w-full">
      <Box padding="sizeLarge" background="backgroundSurface" radius="roundedLarge">
        <Text variant="bodyMd">Surface box with large padding</Text>
      </Box>
      <Box
        as="section"
        paddingX="sizeLarge"
        paddingY="sizeSmall"
        border="strokeWidthThin"
        borderColor="borderDefault"
        radius="roundedLarge"
      >
        <Text variant="bodyMd">Outlined section</Text>
      </Box>
    </Stack>
  );
}

MDX에서 사용

Box 컴포넌트는 .mdx 페이지에 바로 쓸 수 있습니다. frontmatter 아래에서 가져오세요. 서버에서 렌더링되므로 client 지시어가 필요 없습니다.

src/content/docs/example.mdx

---
title: Example
---

import { Box } from "@pelagornis/page/components";

<Box padding="sizeLarge" background="backgroundSurface" radius="roundedLarge">
  Surface box
</Box>

Markdoc에서 사용

pageMarkdoc()가 이 컴포넌트의 box 태그를 등록합니다. markdoc.config.mjs에 프리셋을 한 번 추가한 뒤(Markdoc에서 사용 참고), 어느 .mdoc 페이지에서나 태그를 쓰세요.

src/content/docs/example.mdoc

{% box padding="sizeLarge" background="backgroundSurface" radius="roundedLarge" %}
Surface box
{% /box %}

속성 이름과 값은 React props와 같습니다.

구조

컴포넌트를 이루는 부분과 각 부분이 렌더링하는 data-refineui 역할입니다.

부분	역할
root	box

참고

• 디자인 가이드와 토큰 상세는 RefineUI · Box를 참고하세요.
• 공통 규칙은 MDX에서 사용과 Markdoc에서 사용을 참고하세요.