Deprecate `invisible()` mixin (#28066)

diff --git a/scss/mixins/_visibility.scss b/scss/mixins/_visibility.scss
index fe523d0ee365bb91541276f6dddbd72b72c5a543..f174673117839c3ff29949edf212248fe3132e3a 100644 (file)
--- a/scss/mixins/_visibility.scss
+++ b/scss/mixins/_visibility.scss
@@ -4,4 +4,5 @@
 
 @mixin invisible($visibility) {
   visibility: $visibility !important;
+  @include deprecate("`invisible()`", "v4.3.0", "v5");
 }

diff --git a/scss/utilities/_visibility.scss b/scss/utilities/_visibility.scss
index 823406dc3c74b6f53f1764b7e5c905b57bed27ba..7756c3bfacf76d2ff6e7852cdc6ee4e8b3e1aa3d 100644 (file)
--- a/scss/utilities/_visibility.scss
+++ b/scss/utilities/_visibility.scss
@@ -1,11 +1,13 @@
+// stylelint-disable declaration-no-important
+
 //
 // Visibility utilities
 //
 
 .visible {
-  @include invisible(visible);
+  visibility: visible !important;
 }
 
 .invisible {
-  @include invisible(hidden);
+  visibility: hidden !important;
 }

diff --git a/site/docs/4.2/utilities/visibility.md b/site/docs/4.2/utilities/visibility.md
index cb02e1b88ccf24a132b5516fcbe3d8a6be4312a4..bbfc0cbbc69ffadde04b57f86e1b162efa581771 100644 (file)
--- a/site/docs/4.2/utilities/visibility.md
+++ b/site/docs/4.2/utilities/visibility.md
@@ -17,13 +17,14 @@ Apply `.visible` or `.invisible` as needed.
 {% highlight scss %}
 // Class
 .visible {
-  visibility: visible;
+  visibility: visible !important;
 }
 .invisible {
-  visibility: hidden;
+  visibility: hidden !important;
 }
 
 // Usage as a mixin
+// Warning: The `invisible()` mixin has been deprecated as of v4.3.0. It will be removed entirely in v5.
 .element {
   @include invisible(visible);
 }