Skip to content

Container

Container

A responsive container component for centering and constraining content width.

Import

import { Container } from '@primitivekit/react';

Basic Usage

<Container>
  <h1>Page Content</h1>
  <p>This content is centered and constrained to a maximum width.</p>
</Container>

Sizes

// Small container (max-width: 640px)
<Container size="sm">
  Small container
</Container>

// Medium container (max-width: 768px)
<Container size="md">
  Medium container
</Container>

// Large container (max-width: 1024px)
<Container size="lg">
  Large container
</Container>

// Extra large container (max-width: 1280px)
<Container size="xl">
  Extra large container
</Container>

// Full width (no max-width)
<Container size="full">
  Full width container
</Container>

Centered

<Container centered>
  Centered content
</Container>

With Padding

<Container padding="large">
  Container with padding
</Container>

Props

PropTypeDefaultDescription
size'sm' | 'md' | 'lg' | 'xl' | 'full''lg'Container max-width
centeredbooleantrueCenter the container
padding'none' | 'small' | 'medium' | 'large''medium'Container padding
childrenReactNoderequiredContainer content
classNamestring-Additional CSS classes
styleContainerCSSVariables-CSS variable overrides

Customization

<Container
  style={{
    '--container-max-width': '1200px',
    '--container-padding-x': '32px',
    '--container-padding-y': '24px',
  }}
>
  Custom container
</Container>

Examples

Page Layout

function Page() {
  return (
    <Container size="xl">
      <header>
        <h1>My Website</h1>
      </header>
      
      <main>
        <p>Main content</p>
      </main>
      
      <footer>
        <p>© 2024</p>
      </footer>
    </Container>
  );
}

Nested Containers

<Container size="xl">
  <h1>Full Width Header</h1>
  
  <Container size="md">
    <p>Narrower content for better readability</p>
  </Container>
</Container>

Accessibility

  • ✅ Semantic HTML
  • ✅ Responsive design
  • ✅ Proper content flow

Related Components

  • Card - Content container
  • Grid - Grid layout
  • Stack - Vertical/horizontal layout