Position
Place a component outside the normal document flow.
Common Positioning
The following utilities are available for positioning.
<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>
Responsive variants are also available in the form of .position{breakpoint}-{type}
, such as .position-md-relative
. Please refer to how our breakpoint nomenclature is used.
Fixed Top
Position an element at the top of the viewport, from edge to edge.
<div class="fixed-top">...</div>
Fixed Bottom
Position an element at the bottom of the viewport, from edge to edge.
<div class="fixed-bottom">...</div>
Sticky Top
Position an element at the top of the viewport, from edge to edge, but only after you scroll past it.
This sticky utility uses CSS's position: sticky
, which isn't fully supported in all browsers. Additional support information can be found at Can I Use - CSS position:sticky.
IE11 and IE10 will render position: sticky
as position: relative
. As such, we wrap the styles in a @supports
query, limiting the stickiness to only browsers that can render it properly.
<div class="sticky-top">...</div>
Responsive Sticky Top
Responsive variations also exist for .sticky-top
utility.
<div class="sticky-sm-top">Stick to the top on viewports sized SM (small) or wider</div>
<div class="sticky-md-top">Stick to the top on viewports sized MD (medium) or wider</div>
<div class="sticky-lg-top">Stick to the top on viewports sized LG (large) or wider</div>
<div class="sticky-xl-top">Stick to the top on viewports sized XL (extra-large) or wider</div>
Element Placement
Arrange elements with the placement positioning utilities. The syntax is {property}-{position}
.
Where property is one of:
top
- for the verticaltop
positionstart
- for the horizontalleft
position (in LTR)bottom
- for the verticalbottom
positionend
- for the horizontalright
position (in LTR)
Where position is one of:
0
- for0
offset length50
- for50%
offset length100
- for100%
offset length
You can add more position values by adding entries to the $position-offsets
Sass map variable. It is also possible to generate the responsive variants by modifying the $utility-placement-breakpoints
Sass variable.
<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>
Element Translate
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.
<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 using .translate-middle-x
or .translate-middle-y
classes, elements can be positioned only in horizontal or vertical direction.
<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>
It is also possible to generate the responsive variants of the translate utilities by modifying the $utility-translate-breakpoints
Sass variable.
Examples
Here are some real life examples of these classes:
<button type="button" class="btn btn-primary position-relative">
Mails <span class="position-absolute top-0 start-100 translate-middle badge radius-pill bg-secondary">+99 <span class="sr-only">unread messages</span></span>
</button>
<button type="button" class="btn btn-dark position-relative">
Marker <svg width="1em" height="1em" viewBox="0 0 8 8" class="position-absolute top-100 start-50 translate-middle mt-0_25 text-dark" fill="currentColor" xmlns="http://www.w3.org/2000/svg"><path d="M0 0l4 4 4-4h-8z" transform="translate(0 2)" /></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 radius-circle bg-danger p-0_5"><span class="sr-only">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-offsets
variable.
<div class="position-relative m-1_5">
<div class="progress" style="height: 1px;">
<div class="progress-bar bg-primary" role="progressbar" style="width: 50%;" aria-valuenow="25" aria-valuemin="0" aria-valuemax="100"></div>
</div>
<button type="button" class="position-absolute top-0 start-0 translate-middle btn btn-sm btn-primary radius-circle">1</button>
<button type="button" class="position-absolute top-0 start-50 translate-middle btn btn-sm btn-primary radius-circle">2</button>
<button type="button" class="position-absolute top-0 start-100 translate-middle btn btn-sm btn-secondary radius-circle">3</button>
</div>
SASS Reference
Variables
The available Customization options, or Sass variables, that can be customized for this grouping of utility classes.
Name | Type | Default | Description |
---|---|---|---|
$enable-utility-position |
boolean | true |
Enable the generation of the position utility classes.
Smaller segements of the position utilities can be disabled with the following $enable-* variables.
|
$enable-utility-position-fixed-top |
boolean | true |
Enable the generation of the fixed top position utility class. |
$enable-utility-position-fixed-bottom |
boolean | true |
Enable the generation of the fixed bottom position utility class. |
$enable-utility-position-sticky-top |
boolean | true |
Enable the generation of the sticky top position utility class. |
$enable-utility-position-sticky-top-responsive |
boolean | true |
Enable the generation of the additional responsive sticky top position utility class.
$enable-utility-position-sticky-top needs to be true for this setting be be observed.
|
$enable-utility-position-placement |
boolean | true |
Enable the generation of the placement position utility classes. |
$enable-utility-position-translate |
boolean | true |
Enable the generation of the translate position utility classes. |
$utility-position-breakpoints |
string | map-keys($grid-breakpoints) |
Map of breakpoints that will be used to generate responsive position utilities. |
$utility-sticky-top-breakpoints |
string | map-keys($grid-breakpoints) |
Map of breakpoints that will be used to generate responsive sticky-top utilities. |
$utility-placement-breakpoints |
string | "xs" |
Map of breakpoints that will be used to generate responsive placement utilities. By default this is limited to just thexs breakpoint, so not all the responsive variants are created.
|
$utility-translate-breakpoints |
string | "xs" |
Map of breakpoints that will be used to generate responsive translate utilities. By default this is limited to just thexs breakpoint, so not all the responsive variants are created.
|
$utility-position |
string | static, relative, absolute, fixed, sticky |
List of position values that will be used to generate responsive position utilities. |
$position-offsets |
string |
|
Map of length (offset) values that will be used to generate placement utilities. |
$position-top-offsets |
string | $position-offsets |
Map of length (offset) values that will be used to generate top placement utilities. |
$position-end-offsets |
string | $position-offsets |
Map of length (offset) values that will be used to generate end-side placement utilities. |
$position-bottom-offsets |
string | $position-offsets |
Map of length (offset) values that will be used to generate bottom placement utilities. |
$position-start-offsets |
string | $position-offsets |
Map of length (offset) values that will be used to generate start-side placement utilities. |
Mixins
No mixins available.