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 <[email protected]>
author: Jaume Sala <[email protected]> 2020-09-21 04:42:41 +0200
committer: GitHub <[email protected]> 2020-09-20 19:42:41 -0700
commit: 7bbfd439c9d647cdfc1c4ec3bef57911cddfb00d (patch)
tree: b7698564c014829d2354df7af205446200b90182
parent: 4e9a29e47ae776064b5afe931a347d61a4390451 (diff)
download: bootstrap-7bbfd439c9d647cdfc1c4ec3bef57911cddfb00d.tar.xz
bootstrap-7bbfd439c9d647cdfc1c4ec3bef57911cddfb00d.zip
4 files changed, 140 insertions, 1 deletions
diff --git a/scss/_utilities.scss b/scss/_utilities.scss
index 69615ec4e..e9a9b1e33 100644
--- a/scss/_utilities.scss
+++ b/scss/_utilities.scss
@@ -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: (
diff --git a/scss/_variables.scss b/scss/_variables.scss
index bdf2d62a4..610a56962 100644
--- a/scss/_variables.scss
+++ b/scss/_variables.scss
@@ -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.
diff --git a/site/assets/scss/_component-examples.scss b/site/assets/scss/_component-examples.scss
index 4b7aa4355..7391f5998 100644
--- a/site/assets/scss/_component-examples.scss
+++ b/site/assets/scss/_component-examples.scss
@@ -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
 //
diff --git a/site/content/docs/5.0/utilities/position.md b/site/content/docs/5.0/utilities/position.md
index 4af457da4..8928ecd81 100644
--- a/site/content/docs/5.0/utilities/position.md
+++ b/site/content/docs/5.0/utilities/position.md
@@ -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 >}}
+
author	Jaume Sala <[email protected]>	2020-09-21 04:42:41 +0200
committer	GitHub <[email protected]>	2020-09-20 19:42:41 -0700
commit	7bbfd439c9d647cdfc1c4ec3bef57911cddfb00d (patch)
tree	b7698564c014829d2354df7af205446200b90182
parent	4e9a29e47ae776064b5afe931a347d61a4390451 (diff)
download	bootstrap-7bbfd439c9d647cdfc1c4ec3bef57911cddfb00d.tar.xz bootstrap-7bbfd439c9d647cdfc1c4ec3bef57911cddfb00d.zip