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 verticaltoppositionstart— for the horizontalleftposition (in LTR)bottom— for the verticalbottompositionend— for the horizontalrightposition (in LTR)
Where position is one of:
0— for0edge position50— for50%edge position100— for100%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.
- 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%),
)
),