mirror of
https://github.com/twbs/bootstrap.git
synced 2025-02-08 05:54:23 +01:00
26a3ef1bcb
* Rework progress bar markup and styles Logically moves the various `role` and `aria-` attributes to the `.progress` element itself, leaving the `.progress-bar` to be used purely for the visual presentation. This fixes the problem #36736 that in certain browser/AT combinations, zero-value/zero-width progress bars are completely ignored and not announced. For multiple/stacked progress bars, this PR introduces a new wrapper and class `.progress-stacked`, to accommodate for the fact that with the more logical structure above, we need full `.progress` elements with child `.progress-bar` elements, and can't get away with the fudge we had before of having a single `.progress` with multiple `.progress-bar`s. Note that the old markup structures still work with this change, so this could be considered a non-breaking change - though one we definitely want to highlight as it's more accessible (as it now guarantees that zero-value/zero-width progress bars, whether on their own or as part of a multi/stacked bar, are actually announced) * Add a note about progress bar change in migration guide * Add notes with old markup examples and explanation * Fix bundlewatch * Update site/content/docs/5.2/components/progress.md Co-authored-by: Julien Déramond <julien.deramond@orange.com> * Reintroduce deleted styles Turns out they're needed for correct positioning of text inside progress bar * Move changes in markup to Migrationg guide, link to that from top of progress page, rewrite some content * Fix typo in callout * Clarify "Sizing" section * Remove redundant "now" Co-authored-by: Julien Déramond <julien.deramond@orange.com> Co-authored-by: Julien Déramond <juderamond@gmail.com> Co-authored-by: Mark Otto <markdotto@gmail.com> Co-authored-by: Mark Otto <markd.otto@gmail.com>
131 lines
5.8 KiB
Markdown
131 lines
5.8 KiB
Markdown
---
|
|
layout: docs
|
|
title: Position
|
|
description: Use these shorthand utilities for quickly configuring the position of an element.
|
|
group: utilities
|
|
toc: true
|
|
---
|
|
|
|
## Position values
|
|
|
|
Quick positioning classes are available, though they are not responsive.
|
|
|
|
```html
|
|
<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>
|
|
```
|
|
|
|
## 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.)
|
|
|
|
{{< example class="bd-example-position-utils" >}}
|
|
<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>
|
|
{{< /example >}}
|
|
|
|
## 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.
|
|
|
|
{{< example class="bd-example-position-utils" >}}
|
|
<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>
|
|
{{< /example >}}
|
|
|
|
By adding `.translate-middle-x` or `.translate-middle-y` classes, elements can be positioned only in horizontal or vertical direction.
|
|
|
|
{{< example class="bd-example-position-utils" >}}
|
|
<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>
|
|
{{< /example >}}
|
|
|
|
## Examples
|
|
|
|
Here are some real life examples of these classes:
|
|
|
|
{{< example class="bd-example-position-examples d-flex justify-content-around align-items-center" >}}
|
|
<button type="button" class="btn btn-primary position-relative">
|
|
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>
|
|
</button>
|
|
|
|
<div class="position-relative py-2 px-4 text-bg-dark border border-dark rounded-pill">
|
|
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-dark)" 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>
|
|
</div>
|
|
|
|
<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>
|
|
{{< /example >}}
|
|
|
|
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.
|
|
|
|
{{< example class="bd-example-position-examples" >}}
|
|
<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>
|
|
{{< /example >}}
|
|
|
|
## Sass
|
|
|
|
### Maps
|
|
|
|
Default position utility values are declared in a Sass map, then used to generate our utilities.
|
|
|
|
{{< scss-docs name="position-map" file="scss/_variables.scss" >}}
|
|
|
|
### Utilities API
|
|
|
|
Position utilities are declared in our utilities API in `scss/_utilities.scss`. [Learn how to use the utilities API.]({{< docsref "/utilities/api#using-the-api" >}})
|
|
|
|
{{< scss-docs name="utils-position" file="scss/_utilities.scss" >}}
|