13 · Structure and shell

Container

max-width sm · md · lg · xl · 2xl · prose · full · padding

Limits the content width and centers it, with side breathing room that adapts to the screen.

The width adjusting

container
.heex
<.container_fluid preview loop label="container" width="100%" style="--w:56%" />

size

sm
640px
md
768px
lg
1024px
xl
1280px
2xl
1536px
prose
68ch
full
100%
.heex
<div class="flex flex-col gap-2">
  <div class="flex flex-wrap items-center gap-2.5">
    <span class="w-[50px] font-mono text-xs text-muted">sm</span>
    <.container_fixed preview size="sm" class="flex-1" />
  </div>
  <div class="flex flex-wrap items-center gap-2.5">
    <span class="w-[50px] font-mono text-xs text-muted">md</span>
    <.container_fixed preview size="md" class="flex-1" />
  </div>
  <div class="flex flex-wrap items-center gap-2.5">
    <span class="w-[50px] font-mono text-xs text-muted">lg</span>
    <.container_fixed preview size="lg" class="flex-1" />
  </div>
  <div class="flex flex-wrap items-center gap-2.5">
    <span class="w-[50px] font-mono text-xs text-muted">xl</span>
    <.container_fixed preview size="xl" class="flex-1" />
  </div>
  <div class="flex flex-wrap items-center gap-2.5">
    <span class="w-[50px] font-mono text-xs text-muted">2xl</span>
    <.container_fixed preview size="2xl" class="flex-1" />
  </div>
  <div class="flex flex-wrap items-center gap-2.5">
    <span class="w-[50px] font-mono text-xs text-muted">prose</span>
    <.container_fixed preview size="prose" class="flex-1" />
  </div>
  <div class="flex flex-wrap items-center gap-2.5">
    <span class="w-[50px] font-mono text-xs text-muted">full</span>
    <.container_fixed preview size="full" class="flex-1" />
  </div>
</div>

Usage

<.container size="lg">…</.container>
<.container size="prose" class="py-10">…</.container>

Rules

  • prose (~68 characters) for long texts; lg (1024px) for app screens.
  • The side breathing room grows from 16px (phone) to 32px (desktop).

API reference

Todos os function components, atributos, valores e slots que este componente cobre.

Page containers: container_fixed/1 centers its content up to the xl breakpoint (1280px), container_fluid/1 fills the width. Both keep a 24px gutter.

<.container_fixed>
  <h1>Title</h1>
</.container_fixed>

The sizing is plain utilities (width 100%, a 24px gutter, max-w-* and mx-auto for the fixed one), so a class or a style of the caller only adds layout to it.

Preview

preview draws the canvas diagram of a container instead of a real one: a hatched bar with the accent span that shows the width of a size (sm 640px, md 768px, lg 1024px, xl 1280px, 2xl 1536px, prose 68ch, full 100%). label and width override the text and the span width; the slot is ignored. For the documentation and the showcase only.

<.container_fixed preview size="lg" class="flex-1" />

<.container_fixed>

A centered container, as wide as the xl breakpoint at most.

Attr Type Default Values / notes
preview :boolean false The canvas diagram of a container.
size :string nil nil, 2xl, full, lg, md, prose, sm, xl - With preview: the size drawn.
label :string nil With preview: the text of the bar.
width :string nil With preview: the width of the bar.
loop :boolean false With preview: the span breathes between narrow and wide (--w is the wide end).
class :any nil

Any other HTML/phx attribute goes to the root element.

Slots:

  • <:inner_block>

<.container_fluid>

A container as wide as its parent.

Attr Type Default Values / notes
preview :boolean false The canvas diagram of a container.
size :string nil nil, 2xl, full, lg, md, prose, sm, xl - With preview: the size drawn.
label :string nil With preview: the text of the bar.
width :string nil With preview: the width of the bar.
loop :boolean false With preview: the span breathes between narrow and wide (--w is the wide end).
class :any nil

Any other HTML/phx attribute goes to the root element.

Slots:

  • <:inner_block>

<.container>

A centered container with a gutter, sized by size.

<.container size="lg">...</.container>
<.container size="prose" class="py-10">...</.container>
Attr Type Default Values / notes
size :string nil nil, full, 2xl, lg, md, prose, sm, xl - The widest the content gets: sm 640px, md 768px, lg 1024px, xl 1280px, 2xl 1536px, prose 68ch, full the parent's width. Without it, as container_fixed/1.
class :any nil

Any other HTML/phx attribute goes to the root element.

Slots:

  • <:inner_block>