ContextQMD
Back to Tailwindcss

Align Content

src/docs/align-content.mdx

latest9.2 KB
Original Source

import { ApiTable } from "@/components/api-table.tsx"; import { Example } from "@/components/example.tsx"; import { Figure } from "@/components/figure.tsx"; import { ResponsiveDesign } from "@/components/content.tsx"; import { Stripes } from "@/components/stripes.tsx";

export const title = "align-content"; export const description = "Utilities for controlling how rows are positioned in multi-row flex and grid containers.";

<ApiTable rows={[ ["content-normal", "align-content: normal;"], ["content-center", "align-content: center;"], ["content-start", "align-content: flex-start;"], ["content-end", "align-content: flex-end;"], ["content-between", "align-content: space-between;"], ["content-around", "align-content: space-around;"], ["content-evenly", "align-content: space-evenly;"], ["content-baseline", "align-content: baseline;"], ["content-stretch", "align-content: stretch;"], ]} />

Examples

Start

Use content-start to pack rows in a container against the start of the cross axis:

<Figure> <Example> { <div className="grid h-56 grid-cols-1"> <Stripes border className="col-start-1 row-start-1 rounded-lg" /> <div className="col-start-1 row-start-1 grid grid-cols-3 content-start gap-4 rounded-lg text-center font-mono text-sm leading-6 font-bold text-white"> <div className="rounded-lg bg-purple-500 p-4">01</div> <div className="rounded-lg bg-purple-500 p-4">02</div> <div className="rounded-lg bg-purple-500 p-4">03</div> <div className="rounded-lg bg-purple-500 p-4">04</div> <div className="rounded-lg bg-purple-500 p-4">05</div> </div> </div> } </Example>
html
<!-- [!code classes:content-start] -->
<div class="grid h-56 grid-cols-3 content-start gap-4 ...">
  <div>01</div>
  <div>02</div>
  <div>03</div>
  <div>04</div>
  <div>05</div>
</div>
</Figure>

Center

Use content-center to pack rows in a container in the center of the cross axis:

<Figure> <Example> { <div className="grid h-56 grid-cols-1"> <Stripes border className="col-start-1 row-start-1 rounded-lg" /> <div className="col-start-1 row-start-1 grid h-56 w-full grid-cols-3 content-center gap-4 rounded-lg text-center font-mono text-sm leading-6 font-bold text-white"> <div className="rounded-lg bg-sky-500 p-4">01</div> <div className="rounded-lg bg-sky-500 p-4">02</div> <div className="rounded-lg bg-sky-500 p-4">03</div> <div className="rounded-lg bg-sky-500 p-4">04</div> <div className="rounded-lg bg-sky-500 p-4">05</div> </div> </div> } </Example>
html
<!-- [!code classes:content-center] -->
<div class="grid h-56 grid-cols-3 content-center gap-4 ...">
  <div>01</div>
  <div>02</div>
  <div>03</div>
  <div>04</div>
  <div>05</div>
</div>
</Figure>

End

Use content-end to pack rows in a container against the end of the cross axis:

<Figure> <Example> { <div className="grid h-56 grid-cols-1"> <Stripes border className="col-start-1 row-start-1 rounded-lg" /> <div className="col-start-1 row-start-1 grid h-56 w-full grid-cols-3 content-end gap-4 rounded-lg text-center font-mono text-sm leading-6 font-bold text-white"> <div className="rounded-lg bg-pink-500 p-4">01</div> <div className="rounded-lg bg-pink-500 p-4">02</div> <div className="rounded-lg bg-pink-500 p-4">03</div> <div className="rounded-lg bg-pink-500 p-4">04</div> <div className="rounded-lg bg-pink-500 p-4">05</div> </div> </div> } </Example>
html
<!-- [!code classes:content-end] -->
<div class="grid h-56 grid-cols-3 content-end gap-4 ...">
  <div>01</div>
  <div>02</div>
  <div>03</div>
  <div>04</div>
  <div>05</div>
</div>
</Figure>

Space between

Use content-between to distribute rows in a container such that there is an equal amount of space between each line:

<Figure> <Example> { <div className="grid h-56 grid-cols-1"> <Stripes border className="col-start-1 row-start-1 rounded-lg" /> <div className="col-start-1 row-start-1 grid h-56 w-full grid-cols-3 content-between gap-4 rounded-lg text-center font-mono text-sm leading-6 font-bold text-white"> <div className="rounded-lg bg-violet-500 p-4">01</div> <div className="rounded-lg bg-violet-500 p-4">02</div> <div className="rounded-lg bg-violet-500 p-4">03</div> <div className="rounded-lg bg-violet-500 p-4">04</div> <div className="rounded-lg bg-violet-500 p-4">05</div> </div> </div> } </Example>
html
<!-- [!code classes:content-between] -->
<div class="grid h-56 grid-cols-3 content-between gap-4 ...">
  <div>01</div>
  <div>02</div>
  <div>03</div>
  <div>04</div>
  <div>05</div>
</div>
</Figure>

Space around

Use content-around to distribute rows in a container such that there is an equal amount of space around each line:

<Figure> <Example> { <div className="grid h-56 grid-cols-1"> <Stripes border className="col-start-1 row-start-1 rounded-lg" /> <div className="col-start-1 row-start-1 grid h-56 w-full grid-cols-3 content-around gap-x-4 rounded-lg text-center font-mono text-sm leading-6 font-bold text-white"> <div className="rounded-lg bg-blue-500 p-4">01</div> <div className="rounded-lg bg-blue-500 p-4">02</div> <div className="rounded-lg bg-blue-500 p-4">03</div> <div className="rounded-lg bg-blue-500 p-4">04</div> <div className="rounded-lg bg-blue-500 p-4">05</div> </div> </div> } </Example>
html
<!-- [!code classes:content-around] -->
<div class="grid h-56 grid-cols-3 content-around gap-4 ...">
  <div>01</div>
  <div>02</div>
  <div>03</div>
  <div>04</div>
  <div>05</div>
</div>
</Figure>

Space evenly

Use content-evenly to distribute rows in a container such that there is an equal amount of space around each item, but also accounting for the doubling of space you would normally see between each item when using content-around:

<Figure> <Example> { <div className="grid h-56 grid-cols-1"> <Stripes border className="col-start-1 row-start-1 rounded-lg" /> <div className="col-start-1 row-start-1 grid h-56 w-full grid-cols-3 content-evenly gap-x-4 rounded-lg text-center font-mono text-sm leading-6 font-bold text-white"> <div className="rounded-lg bg-indigo-500 p-4">01</div> <div className="rounded-lg bg-indigo-500 p-4">02</div> <div className="rounded-lg bg-indigo-500 p-4">03</div> <div className="rounded-lg bg-indigo-500 p-4">04</div> <div className="rounded-lg bg-indigo-500 p-4">05</div> </div> </div> } </Example>
html
<!-- [!code classes:content-evenly] -->
<div class="grid h-56 grid-cols-3 content-evenly gap-4 ...">
  <div>01</div>
  <div>02</div>
  <div>03</div>
  <div>04</div>
  <div>05</div>
</div>
</Figure>

Stretch

Use content-stretch to allow content items to fill the available space along the container’s cross axis:

<Figure> <Example> { <div className="grid h-56 grid-cols-1"> <Stripes border className="col-start-1 row-start-1 rounded-lg" /> <div className="col-start-1 row-start-1 grid h-56 w-full grid-cols-3 content-stretch gap-4 rounded-lg text-center font-mono text-sm leading-6 font-bold text-white"> <div className="flex items-center justify-center rounded-lg bg-fuchsia-500 p-4">01</div> <div className="flex items-center justify-center rounded-lg bg-fuchsia-500 p-4">02</div> <div className="flex items-center justify-center rounded-lg bg-fuchsia-500 p-4">03</div> <div className="flex items-center justify-center rounded-lg bg-fuchsia-500 p-4">04</div> <div className="flex items-center justify-center rounded-lg bg-fuchsia-500 p-4">05</div> </div> </div> } </Example>
html
<!-- [!code classes:content-stretch] -->
<div class="grid h-56 grid-cols-3 content-stretch gap-4 ...">
  <div>01</div>
  <div>02</div>
  <div>03</div>
  <div>04</div>
  <div>05</div>
</div>
</Figure>

Normal

Use content-normal to pack content items in their default position as if no align-content value was set:

<Figure> <Example> { <div className="grid h-56 grid-cols-1"> <Stripes border className="col-start-1 row-start-1 rounded-lg" /> <div className="col-start-1 row-start-1 grid h-56 w-full grid-cols-3 gap-4 rounded-lg text-center font-mono text-sm leading-6 font-bold text-white"> <div className="flex items-center justify-center rounded-lg bg-indigo-500 p-4">01</div> <div className="flex items-center justify-center rounded-lg bg-indigo-500 p-4">02</div> <div className="flex items-center justify-center rounded-lg bg-indigo-500 p-4">03</div> <div className="flex items-center justify-center rounded-lg bg-indigo-500 p-4">04</div> <div className="flex items-center justify-center rounded-lg bg-indigo-500 p-4">05</div> </div> </div> } </Example>
html
<!-- [!code classes:content-normal] -->
<div class="grid h-56 grid-cols-3 content-normal gap-4 ...">
  <div>01</div>
  <div>02</div>
  <div>03</div>
  <div>04</div>
  <div>05</div>
</div>
</Figure>

Responsive design

<ResponsiveDesign property="align-content" defaultClass="grid content-start" featuredClass="content-around" />