Skip to main content

Utilities

Position

Use these shorthand utilities for quickly configuring the position of an element.

Position values

Quick positioning classes are available, though they are not responsive. They set the CSS position property and nothing else.

<div class="position-static">...</div>
<div class="position-relative">...</div>
<div class="position-absolute">...</div>
<div class="position-fixed">...</div>
<div class="position-sticky">...</div>

The position helpers (.fixed-top, .sticky-top, …) combine these with an offset and a z-index for the common "pin the navbar" cases.

Arrange elements

Arrange elements easily with the edge positioning utilities. The format is {property}-{position}.

Where property is one of:

  • top — for the vertical top position
  • start — for the horizontal left position (in LTR)
  • bottom — for the vertical bottom position
  • end — for the horizontal right position (in LTR)

Where position is one of:

  • 0 — for 0 edge position
  • 50 — for 50% edge position
  • 100 — for 100% edge position

(You can add more position values by adding entries to the $position-values Sass variable.)

HTML
<div class="position-relative bg-body-tertiary border rounded" style="height: 200px">
  <div class="position-absolute top-0 start-0 text-bg-gold rounded" style="width: 2rem; height: 2rem"></div>
  <div class="position-absolute top-0 end-0 text-bg-gold rounded" style="width: 2rem; height: 2rem"></div>
  <div class="position-absolute top-50 start-50 text-bg-gold rounded" style="width: 2rem; height: 2rem"></div>
  <div class="position-absolute bottom-50 end-50 text-bg-gold rounded" style="width: 2rem; height: 2rem"></div>
  <div class="position-absolute bottom-0 start-0 text-bg-gold rounded" style="width: 2rem; height: 2rem"></div>
  <div class="position-absolute bottom-0 end-0 text-bg-gold rounded" style="width: 2rem; height: 2rem"></div>
</div>
<div class="position-relative">
  <div class="position-absolute top-0 start-0"></div>
  <div class="position-absolute top-0 end-0"></div>
  <div class="position-absolute top-50 start-50"></div>
  <div class="position-absolute bottom-50 end-50"></div>
  <div class="position-absolute bottom-0 start-0"></div>
  <div class="position-absolute bottom-0 end-0"></div>
</div>

Notice that .top-50 .start-50 puts the box's top-left corner at the centre, not the box itself. That is what the translate utilities below fix.

Center elements

In addition, you can also center the elements with the transform utility class .translate-middle.

This class applies the transformations translateX(-50%) and translateY(-50%) to the element which, in combination with the edge positioning utilities, allows you to absolute center an element.

HTML
<div class="position-relative bg-body-tertiary border rounded" style="height: 200px">
  <div class="position-absolute top-0 start-0 translate-middle text-bg-gold rounded" style="width: 2rem; height: 2rem"></div>
  <div class="position-absolute top-0 start-50 translate-middle text-bg-gold rounded" style="width: 2rem; height: 2rem"></div>
  <div class="position-absolute top-0 start-100 translate-middle text-bg-gold rounded" style="width: 2rem; height: 2rem"></div>
  <div class="position-absolute top-50 start-0 translate-middle text-bg-gold rounded" style="width: 2rem; height: 2rem"></div>
  <div class="position-absolute top-50 start-50 translate-middle text-bg-gold rounded" style="width: 2rem; height: 2rem"></div>
  <div class="position-absolute top-50 start-100 translate-middle text-bg-gold rounded" style="width: 2rem; height: 2rem"></div>
  <div class="position-absolute top-100 start-0 translate-middle text-bg-gold rounded" style="width: 2rem; height: 2rem"></div>
  <div class="position-absolute top-100 start-50 translate-middle text-bg-gold rounded" style="width: 2rem; height: 2rem"></div>
  <div class="position-absolute top-100 start-100 translate-middle text-bg-gold rounded" style="width: 2rem; height: 2rem"></div>
</div>
<div class="position-relative">
  <div class="position-absolute top-0 start-0 translate-middle"></div>
  <div class="position-absolute top-0 start-50 translate-middle"></div>
  <div class="position-absolute top-0 start-100 translate-middle"></div>
  <div class="position-absolute top-50 start-0 translate-middle"></div>
  <div class="position-absolute top-50 start-50 translate-middle"></div>
  <div class="position-absolute top-50 start-100 translate-middle"></div>
  <div class="position-absolute top-100 start-0 translate-middle"></div>
  <div class="position-absolute top-100 start-50 translate-middle"></div>
  <div class="position-absolute top-100 start-100 translate-middle"></div>
</div>

By adding .translate-middle-x or .translate-middle-y classes, elements can be positioned only in horizontal or vertical direction.

HTML
<div class="position-relative bg-body-tertiary border rounded" style="height: 200px">
  <div class="position-absolute top-0 start-0 text-bg-gold rounded" style="width: 2rem; height: 2rem"></div>
  <div class="position-absolute top-0 start-50 translate-middle-x text-bg-gold rounded" style="width: 2rem; height: 2rem"></div>
  <div class="position-absolute top-0 end-0 text-bg-gold rounded" style="width: 2rem; height: 2rem"></div>
  <div class="position-absolute top-50 start-0 translate-middle-y text-bg-gold rounded" style="width: 2rem; height: 2rem"></div>
  <div class="position-absolute top-50 start-50 translate-middle text-bg-gold rounded" style="width: 2rem; height: 2rem"></div>
  <div class="position-absolute top-50 end-0 translate-middle-y text-bg-gold rounded" style="width: 2rem; height: 2rem"></div>
  <div class="position-absolute bottom-0 start-0 text-bg-gold rounded" style="width: 2rem; height: 2rem"></div>
  <div class="position-absolute bottom-0 start-50 translate-middle-x text-bg-gold rounded" style="width: 2rem; height: 2rem"></div>
  <div class="position-absolute bottom-0 end-0 text-bg-gold rounded" style="width: 2rem; height: 2rem"></div>
</div>
<div class="position-relative">
  <div class="position-absolute top-0 start-0"></div>
  <div class="position-absolute top-0 start-50 translate-middle-x"></div>
  <div class="position-absolute top-0 end-0"></div>
  <div class="position-absolute top-50 start-0 translate-middle-y"></div>
  <div class="position-absolute top-50 start-50 translate-middle"></div>
  <div class="position-absolute top-50 end-0 translate-middle-y"></div>
  <div class="position-absolute bottom-0 start-0"></div>
  <div class="position-absolute bottom-0 start-50 translate-middle-x"></div>
  <div class="position-absolute bottom-0 end-0"></div>
</div>

Examples

Here are some real life examples of these classes:

HTML
<button type="button" class="btn btn-primary position-relative">
  Mails <span class="position-absolute top-0 start-100 translate-middle badge rounded-pill text-bg-secondary">+99 <span class="visually-hidden">unread messages</span></span>
</button>

<button type="button" class="btn btn-dark position-relative">
  Marker <svg width="1em" height="1em" viewBox="0 0 16 16" class="position-absolute top-100 start-50 translate-middle mt-1" fill="var(--bs-gold-500)" xmlns="http://www.w3.org/2000/svg" aria-hidden="true"><path d="M7.247 11.14 2.451 5.658C1.885 5.013 2.345 4 3.204 4h9.592a1 1 0 0 1 .753 1.659l-4.796 5.48a1 1 0 0 1-1.506 0z"/></svg>
</button>

<button type="button" class="btn btn-primary position-relative">
  Alerts <span class="position-absolute top-0 start-100 translate-middle badge border border-light rounded-circle bg-danger p-2"><span class="visually-hidden">unread messages</span></span>
</button>

You can use these classes with existing components to create new ones. Remember that you can extend its functionality by adding entries to the $position-values variable.

HTML
<div class="position-relative m-4">
  <div class="progress" role="progressbar" aria-label="Progress" aria-valuenow="50" aria-valuemin="0" aria-valuemax="100" style="height: 1px;">
    <div class="progress-bar" style="width: 50%"></div>
  </div>
  <button type="button" class="position-absolute top-0 start-0 translate-middle btn btn-sm btn-primary rounded-pill" style="width: 2rem; height:2rem;">1</button>
  <button type="button" class="position-absolute top-0 start-50 translate-middle btn btn-sm btn-primary rounded-pill" style="width: 2rem; height:2rem;">2</button>
  <button type="button" class="position-absolute top-0 start-100 translate-middle btn btn-sm btn-secondary rounded-pill" style="width: 2rem; height:2rem;">3</button>
</div>

Sticky in this theme

.position-sticky needs an offset to stick to. The theme's z-index scale reserves 110 for sticky chrome, so a sticky header is normally .position-sticky .top-0 plus .z-3 or the .sticky-top helper, which sets both. Brand rule: sticky chrome gets a hard rule, not a drop shadow — see Shadows.

Results — sticky header
  • Match 1 — Opener, 8:42
  • Match 2 — Tag team, 11:05
  • Match 3 — Women's title, 9:30
  • Match 4 — Hardcore, 12:18
  • Match 5 — Tournament semi, 14:55
  • Match 6 — Tournament semi, 13:40
  • Match 7 — Intercontinental title, 17:02
  • Match 8 — Cage main event, 22:31
  • Dark match — post-show, 6:10
HTML
<div class="docs-scroll-demo">
  <div class="position-sticky top-0 z-1 p-2 bg-body border-bottom border-primary border-2 fw-bold">Results — sticky header</div>
  <ul class="list-unstyled m-0 p-2">
    <li class="py-1">Match 1 — Opener, 8:42</li>
    <li class="py-1">Match 2 — Tag team, 11:05</li>
    <li class="py-1">Match 3 — Women's title, 9:30</li>
    <li class="py-1">Match 4 — Hardcore, 12:18</li>
    <li class="py-1">Match 5 — Tournament semi, 14:55</li>
    <li class="py-1">Match 6 — Tournament semi, 13:40</li>
    <li class="py-1">Match 7 — Intercontinental title, 17:02</li>
    <li class="py-1">Match 8 — Cage main event, 22:31</li>
    <li class="py-1">Dark match — post-show, 6:10</li>
  </ul>
</div>

CSS

$position-values: (
  0: 0,
  50: 50%,
  100: 100%
);

"position": (
  property: position,
  values: static relative absolute fixed sticky
),
"top":    (property: top,    values: $position-values),
"bottom": (property: bottom, values: $position-values),
"start":  (property: left,   class: start, values: $position-values),
"end":    (property: right,  class: end,   values: $position-values),
"translate-middle": (
  property: transform,
  class: translate-middle,
  values: (
    null: translate(-50%, -50%),
    x: translateX(-50%),
    y: translateY(-50%),
  )
),