View on GitHub

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.

  1. <div class="position-static">...</div>
  2. <div class="position-relative">...</div>
  3. <div class="position-absolute">...</div>
  4. <div class="position-fixed">...</div>
  5. <div class="position-sticky">...</div>

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 map variable.)

Position - 图1

html

  1. <div class="position-relative">
  2. <div class="position-absolute top-0 start-0"></div>
  3. <div class="position-absolute top-0 end-0"></div>
  4. <div class="position-absolute top-50 start-50"></div>
  5. <div class="position-absolute bottom-50 end-50"></div>
  6. <div class="position-absolute bottom-0 start-0"></div>
  7. <div class="position-absolute bottom-0 end-0"></div>
  8. </div>

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.

Position - 图2

html

  1. <div class="position-relative">
  2. <div class="position-absolute top-0 start-0 translate-middle"></div>
  3. <div class="position-absolute top-0 start-50 translate-middle"></div>
  4. <div class="position-absolute top-0 start-100 translate-middle"></div>
  5. <div class="position-absolute top-50 start-0 translate-middle"></div>
  6. <div class="position-absolute top-50 start-50 translate-middle"></div>
  7. <div class="position-absolute top-50 start-100 translate-middle"></div>
  8. <div class="position-absolute top-100 start-0 translate-middle"></div>
  9. <div class="position-absolute top-100 start-50 translate-middle"></div>
  10. <div class="position-absolute top-100 start-100 translate-middle"></div>
  11. </div>

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

Position - 图3

html

  1. <div class="position-relative">
  2. <div class="position-absolute top-0 start-0"></div>
  3. <div class="position-absolute top-0 start-50 translate-middle-x"></div>
  4. <div class="position-absolute top-0 end-0"></div>
  5. <div class="position-absolute top-50 start-0 translate-middle-y"></div>
  6. <div class="position-absolute top-50 start-50 translate-middle"></div>
  7. <div class="position-absolute top-50 end-0 translate-middle-y"></div>
  8. <div class="position-absolute bottom-0 start-0"></div>
  9. <div class="position-absolute bottom-0 start-50 translate-middle-x"></div>
  10. <div class="position-absolute bottom-0 end-0"></div>
  11. </div>

Examples

Here are some real life examples of these classes:

Position - 图4

html

  1. <button type="button" class="btn btn-primary position-relative">
  2. Mails <span class="position-absolute top-0 start-100 translate-middle badge rounded-pill bg-secondary">+99 <span class="visually-hidden">unread messages</span></span>
  3. </button>
  4. <button type="button" class="btn btn-dark position-relative">
  5. Marker <svg width="1em" height="1em" viewBox="0 0 16 16" class="position-absolute top-100 start-50 translate-middle mt-1" fill="#212529" xmlns="http://www.w3.org/2000/svg"><path d="M7.247 11.14L2.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>
  6. </button>
  7. <button type="button" class="btn btn-primary position-relative">
  8. 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>
  9. </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.

Position - 图5

html

  1. <div class="position-relative m-4">
  2. <div class="progress" style="height: 1px;">
  3. <div class="progress-bar" role="progressbar" aria-label="Progress" style="width: 50%;" aria-valuenow="50" aria-valuemin="0" aria-valuemax="100"></div>
  4. </div>
  5. <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>
  6. <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>
  7. <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>
  8. </div>

Sass

Maps

Default position utility values are declared in a Sass map, then used to generate our utilities.

  1. $position-values: (
  2. 0: 0,
  3. 50: 50%,
  4. 100: 100%
  5. );

Utilities API

Position utilities are declared in our utilities API in scss/_utilities.scss. Learn how to use the utilities API.

  1. "position": (
  2. property: position,
  3. values: static relative absolute fixed sticky
  4. ),
  5. "top": (
  6. property: top,
  7. values: $position-values
  8. ),
  9. "bottom": (
  10. property: bottom,
  11. values: $position-values
  12. ),
  13. "start": (
  14. property: left,
  15. class: start,
  16. values: $position-values
  17. ),
  18. "end": (
  19. property: right,
  20. class: end,
  21. values: $position-values
  22. ),
  23. "translate-middle": (
  24. property: transform,
  25. class: translate-middle,
  26. values: (
  27. null: translate(-50%, -50%),
  28. x: translateX(-50%),
  29. y: translateY(-50%),
  30. )
  31. ),