Introduce posibility to disable !important suffix for utility classes (#29625)

diff --git a/scss/_variables.scss b/scss/_variables.scss
index c72f21c91932f6aa42303530cda29f28d056a7b0..3bbf6bf321dc57fde5ab49fd967bb224d54a92ba 100644 (file)
--- a/scss/_variables.scss
+++ b/scss/_variables.scss
@@ -227,6 +227,7 @@ $enable-pointer-cursor-for-buttons:           true !default;
 $enable-rfs:                                  true !default;
 $enable-validation-icons:                     true !default;
 $enable-deprecation-messages:                 true !default;
+$enable-important-utilities:                  true !default;
 
 
 // Spacing

diff --git a/scss/mixins/_utilities.scss b/scss/mixins/_utilities.scss
index 4604ef537ab2867f5f2f0a4159e15310920ef8f5..0d7fc61f056050e43b837be6524d92844603e36a 100644 (file)
--- a/scss/mixins/_utilities.scss
+++ b/scss/mixins/_utilities.scss
@@ -28,7 +28,7 @@
     .#{$property-class + $infix + $property-class-modifier} {
       @each $property in $properties {
         // stylelint-disable-next-line declaration-no-important
-        #{$property}: $value !important;
+        #{$property}: $value if($enable-important-utilities, !important, null);
       }
     }
   }

diff --git a/site/content/docs/4.3/getting-started/theming.md b/site/content/docs/4.3/getting-started/theming.md
index 07134f373ca5208964866e8418f1bc18bf0fa7ed..f34f641b07c521dca7f00c530341e3ce919aa4fd 100644 (file)
--- a/site/content/docs/4.3/getting-started/theming.md
+++ b/site/content/docs/4.3/getting-started/theming.md
@@ -273,6 +273,7 @@ You can find and customize these variables for key global options in Bootstrap's
 | `$enable-rfs`                                | `true` (default)  or `false`       | Globally enables [RFS]({{< docsref "/getting-started/rfs" >}}). |
 | `$enable-validation-icons`                   | `true` (default) or `false`        | Enables `background-image` icons within textual inputs and some custom forms for validation states. |
 | `$enable-deprecation-messages`               | `true` or `false` (default)        | Set to `true` to show warnings when using any of the deprecated mixins and functions that are planned to be removed in `v5`. |
+| `$enable-important-utilities`                | `true` (default) or `false`        | Enables the `!important` suffix in utility classes. |
 
 ## Color