PPolaris ComponentsConnect an agent

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>
);