Merge branch 'twbs:main' into mainHEADmain

1 files changed, 36 insertions, 0 deletions

diff --git a/site/content/docs/5.3/utilities/opacity.md b/site/content/docs/5.3/utilities/opacity.md
new file mode 100644
index 000000000..1cf4696cc
--- /dev/null
+++ b/site/content/docs/5.3/utilities/opacity.md
@@ -0,0 +1,36 @@
+---
+layout: docs
+title: Opacity
+description: Control the opacity of elements.
+group: utilities
+added:
+  version: "5.1"
+---
+
+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.
+
+<div class="bd-example d-sm-flex">
+  <div class="opacity-100 p-3 m-2 bg-primary text-light fw-bold rounded">100%</div>
+  <div class="opacity-75 p-3 m-2 bg-primary text-light fw-bold rounded">75%</div>
+  <div class="opacity-50 p-3 m-2 bg-primary text-light fw-bold rounded">50%</div>
+  <div class="opacity-25 p-3 m-2 bg-primary text-light fw-bold rounded">25%</div>
+  <div class="opacity-0 p-3 m-2 bg-primary text-light fw-bold rounded">0%</div>
+</div>
+
+```html
+<div class="opacity-100">...</div>
+<div class="opacity-75">...</div>
+<div class="opacity-50">...</div>
+<div class="opacity-25">...</div>
+<div class="opacity-0">...</div>
+```
+
+## CSS
+
+### Sass 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" >}}