Extra position utilities (#31280)
* Extra position utilities Given that there are utilities for the *position* property, it seems logic to have utilities for the *top*, *left*, *bottom* and *right* propertires. * Update extra position utilities * add default position values map * tweak examples * add real life examples * fix double colon Co-authored-by: XhmikosR <xhmikosr@gmail.com>
This commit is contained in:
Jaume Sala
GitHub
parent
4e9a29e47a
commit
7bbfd439c9
|
|
@ -39,6 +39,29 @@ $utilities: map-merge(
|
|||
property: position,
|
||||
values: static relative absolute fixed sticky
|
||||
),
|
||||
"top": (
|
||||
property: top,
|
||||
values: $position-values
|
||||
),
|
||||
"bottom": (
|
||||
property: bottom,
|
||||
values: $position-values
|
||||
),
|
||||
"left": (
|
||||
property: left,
|
||||
values: $position-values
|
||||
),
|
||||
"right": (
|
||||
property: right,
|
||||
values: $position-values
|
||||
),
|
||||
"translate-middle": (
|
||||
property: transform,
|
||||
class: translate-middle,
|
||||
values: (
|
||||
null: (translateX(-50%) translateY(-50%))
|
||||
)
|
||||
),
|
||||
"border": (
|
||||
property: border,
|
||||
values: (
|
||||
|
|
|
|||
|
|
@ -246,6 +246,17 @@ $spacers: (
|
|||
|
||||
$negative-spacers: if($enable-negative-margins, negativify-map($spacers), null) !default;
|
||||
|
||||
// Position
|
||||
//
|
||||
// Define the edge positioning anchors of the position utilities.
|
||||
|
||||
$position-values: (
|
||||
0: 0,
|
||||
50: 50%,
|
||||
100: 100%
|
||||
) !default;
|
||||
|
||||
|
||||
// Body
|
||||
//
|
||||
// Settings for the `<body>` element.
|
||||
|
|
|
|||
|
|
@ -217,6 +217,29 @@
|
|||
}
|
||||
}
|
||||
|
||||
.bd-example-position-utils {
|
||||
position: relative;
|
||||
padding: 3em;
|
||||
|
||||
.position-relative {
|
||||
height: 200px;
|
||||
background-color: #f5f5f5;
|
||||
}
|
||||
|
||||
.position-absolute {
|
||||
width: 2em;
|
||||
height: 2em;
|
||||
background-color: $dark;
|
||||
@include border-radius();
|
||||
}
|
||||
}
|
||||
|
||||
.bd-example-position-examples {
|
||||
&::after {
|
||||
content: none;
|
||||
}
|
||||
}
|
||||
|
||||
//
|
||||
// Code snippets
|
||||
//
|
||||
|
|
|
|||
|
|
@ -6,7 +6,7 @@ group: utilities
|
|||
toc: true
|
||||
---
|
||||
|
||||
## Common values
|
||||
## Position values
|
||||
|
||||
Quick positioning classes are available, though they are not responsive.
|
||||
|
||||
|
|
@ -17,3 +17,85 @@ Quick positioning classes are available, though they are not responsive.
|
|||
<div class="position-fixed">...</div>
|
||||
<div class="position-sticky">...</div>
|
||||
{{< /highlight >}}
|
||||
|
||||
## 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
|
||||
- `left` - for the horizontal `left` position
|
||||
- `bottom` - for the vertical `bottom` position
|
||||
- `right` - for the horizontal `right` position
|
||||
|
||||
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 left-0"></div>
|
||||
<div class="position-absolute top-0 right-0"></div>
|
||||
<div class="position-absolute top-50 left-50"></div>
|
||||
<div class="position-absolute bottom-50 right-50"></div>
|
||||
<div class="position-absolute bottom-0 left-0"></div>
|
||||
<div class="position-absolute bottom-0 right-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 left-0 translate-middle"></div>
|
||||
<div class="position-absolute top-0 left-50 translate-middle"></div>
|
||||
<div class="position-absolute top-0 left-100 translate-middle"></div>
|
||||
<div class="position-absolute top-50 left-0 translate-middle"></div>
|
||||
<div class="position-absolute top-50 left-50 translate-middle"></div>
|
||||
<div class="position-absolute top-50 left-100 translate-middle"></div>
|
||||
<div class="position-absolute top-100 left-0 translate-middle"></div>
|
||||
<div class="position-absolute top-100 left-50 translate-middle"></div>
|
||||
<div class="position-absolute top-100 left-100 translate-middle"></div>
|
||||
</div>
|
||||
{{< /example >}}
|
||||
|
||||
## Examples
|
||||
|
||||
Here are some real life examples of these classes:
|
||||
|
||||
{{< example class="bd-example-position-examples d-flex justify-content-around" >}}
|
||||
<button type="button" class="btn btn-primary position-relative">
|
||||
Mails <span class="position-absolute top-0 left-100 translate-middle badge rounded-pill 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 left-50 translate-middle mt-1 bi bi-caret-down-fill" fill="#343a40" 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>
|
||||
</button>
|
||||
|
||||
<button type="button" class="btn btn-primary position-relative">
|
||||
Alerts <span class="position-absolute top-0 left-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" style="height: 1px;">
|
||||
<div class="progress-bar" role="progressbar" style="width: 50%;" aria-valuenow="25" aria-valuemin="0" aria-valuemax="100"></div>
|
||||
</div>
|
||||
<button type="button" class="position-absolute top-0 left-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 left-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 left-100 translate-middle btn btn-sm btn-secondary rounded-pill" style="width: 2rem; height:2rem;">3</button>
|
||||
</div>
|
||||
{{< /example >}}
|
||||
|
||||
|
|
|
|||
Loading…
Reference in New Issue