Spacing Property

Markdown

Controls the overall spacing scale for elements. Supports scaled values and inheritance from parent elements.

<Flex gap="4" wrap="wrap" align="center" justify="center" className="w-full">
  <Box spacing="lg" p="4" className="border border-[rgb(var(--border-1))]">
    <Text>Large Spacing</Text>
  </Box>
</Flex>

Examples

Spacing Scale

The spacing prop sets the overall spacing scale for an element: xs, sm, md, lg, or xl.

XS
SM
MD
LG
XL
<Flex gap="4" wrap="wrap" align="center" justify="center" className="w-full">
  <Flex gap="2" align="center">
    {["xs", "sm", "md", "lg", "xl"].map((size) => (
      <Box
        p="4"
        key={size}
        className="border border-[rgb(var(--border-1))]"
        spacing={size}
      >
        {size.toUpperCase()}
      </Box>
    ))}
  </Flex>
</Flex>

Spacing Inheritance

Child elements use the theme spacing unless they are given spacing="inherit".

Parent Box (XL Spacing, p=2, m=2)
Child 1 (Inherited Spacing, p=2, m=2)
Child 2 (Default Spacing, p=2, m=2)
<Flex gap="4" wrap="wrap" align="center" justify="center" className="w-full">
  <Box
    p="2"
    m="2"
    spacing="xl"
    className="border border-[rgb(var(--border-1))]"
  >
    Parent Box (XL Spacing, p=2, m=2)
    <Box
      p="2"
      m="2"
      spacing="inherit"
      className="border border-[rgb(var(--border-1))]"
    >
      Child 1 (Inherited Spacing, p=2, m=2)
    </Box>
    <Box p="2" m="2" className="border border-[rgb(var(--border-1))]">
      Child 2 (Default Spacing, p=2, m=2)
    </Box>
  </Box>
</Flex>