diff --git a/site/content/docs/0.0/utilities/api.md b/site/content/docs/0.0/utilities/api.md index f8f144135d..deaeb72a88 100644 --- a/site/content/docs/0.0/utilities/api.md +++ b/site/content/docs/0.0/utilities/api.md @@ -103,7 +103,7 @@ values: ( ) ``` -As a Sass variable that sets the list or map: +As a Sass variable that sets the list or map, as in our [`position` utilities]({{< docsref "/utilities/position" >}}): ```scss values: $position-values diff --git a/site/content/docs/0.0/utilities/position.md b/site/content/docs/0.0/utilities/position.md index 6ef74f4437..73bdab647c 100644 --- a/site/content/docs/0.0/utilities/position.md +++ b/site/content/docs/0.0/utilities/position.md @@ -8,4 +8,125 @@ aliases: toc: true --- -{{< callout-soon "page" >}} +## Position values + +Quick positioning classes are available, though they are not responsive. + +```html +
...
+
...
+
...
+
...
+
...
+``` + +## 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" >}} +
+
+
+
+
+
+
+
+{{< /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" >}} +
+
+
+
+
+
+
+
+
+
+
+{{< /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" >}} +
+
+
+
+
+
+
+
+
+
+
+{{< /example >}} + + + +## CSS + +### 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" >}} + +### Sass 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" >}} diff --git a/site/data/sidebar.yml b/site/data/sidebar.yml index d94838a966..5b5d8c2c49 100644 --- a/site/data/sidebar.yml +++ b/site/data/sidebar.yml @@ -231,7 +231,6 @@ draft: true - title: Overflow - title: Position - draft: true - title: Shadows draft: true - title: Sizing