BlockStack
Stacks its children vertically with a consistent token-based gap, plus control over horizontal alignment and vertical distribution.
Preview
Code
Example.jsx
import { Card, Box, BlockStack, InlineGrid, Text } from '@shopify/polaris';
const GAPS = ['100', '300', '500'];
const INLINE_ALIGNS = ['start', 'center', 'end'];
const Tile = ({ children, width }) => (
<Box background="bg-surface-secondary" borderRadius="200" padding="300" minWidth={width}>
<Text as="span" variant="bodySm" alignment="center">
{children}
</Text>
</Box>
);
const Outline = ({ label, children }) => (
<BlockStack gap="200">
<Text as="h3" variant="headingSm">
{label}
</Text>
<Box background="bg-surface-secondary" borderRadius="200" padding="200" borderWidth="025" borderColor="border">
<Box background="bg-surface" borderRadius="100" padding="200">
{children}
</Box>
</Box>
</BlockStack>
);
export const Example = () => (
<Card>
<BlockStack gap="500">
<InlineGrid columns={{ xs: 1, sm: 3 }} gap="400">
{GAPS.map((gap) => (
<Outline key={gap} label={`gap="${gap}"`}>
<BlockStack gap={gap}>
<Tile>Title</Tile>
<Tile>Description</Tile>
<Tile>Action</Tile>
</BlockStack>
</Outline>
))}
</InlineGrid>
<InlineGrid columns={{ xs: 1, sm: 3 }} gap="400">
{INLINE_ALIGNS.map((inlineAlign) => (
<Outline key={inlineAlign} label={`inlineAlign="${inlineAlign}"`}>
<BlockStack gap="200" inlineAlign={inlineAlign}>
<Tile width="60px">SKU</Tile>
<Tile width="110px">Inventory</Tile>
<Tile width="80px">Price</Tile>
</BlockStack>
</Outline>
))}
</InlineGrid>
<Outline label='align="space-between" with a fixed height'>
<Box minHeight="180px">
<BlockStack gap="200" align="space-between">
<Tile>Plan name</Tile>
<Tile>Included features</Tile>
<Tile>Choose plan</Tile>
</BlockStack>
</Box>
</Outline>
</BlockStack>
</Card>
);