diff --git a/scss/_utilities.scss b/scss/_utilities.scss index 3c927cf595..74f8a3a01c 100644 --- a/scss/_utilities.scss +++ b/scss/_utilities.scss @@ -24,6 +24,19 @@ $utilities: map-merge( ) ), // scss-docs-end utils-float + // Opacity utilities + // scss-docs-start utils-opacity + "opacity": ( + property: opacity, + values: ( + 0: 0, + 25: .25, + 50: .5, + 75: .75, + 100: 1, + ) + ), + // scss-docs-end utils-opacity // scss-docs-start utils-overflow "overflow": ( property: overflow, diff --git a/site/content/docs/5.0/utilities/opacity.md b/site/content/docs/5.0/utilities/opacity.md new file mode 100644 index 0000000000..a2fdc38071 --- /dev/null +++ b/site/content/docs/5.0/utilities/opacity.md @@ -0,0 +1,30 @@ +--- +layout: docs +title: Opacity +description: Control the opacity of elements. +group: utilities +--- + +The `opacity` property sets the opacity level for an element. The opacity level describes the transparency level, where `1` is not transparent at all, `.5` is 50% visible, and `0` is completely transparent. + +Set the `opacity` of an element using `.opacity-{value}` utilities. + +
+
100%
+
75%
+
50%
+
25%
+
+ +```html +
...
+
...
+
...
+
...
+``` + +### Utilities API + +Opacity 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-opacity" file="scss/_utilities.scss" >}} diff --git a/site/data/sidebar.yml b/site/data/sidebar.yml index 4e43255a3b..70652afd83 100644 --- a/site/data/sidebar.yml +++ b/site/data/sidebar.yml @@ -101,6 +101,7 @@ - title: Flex - title: Float - title: Interactions + - title: Opacity - title: Overflow - title: Position - title: Shadows