]> git.ipfire.org Git - thirdparty/bootstrap.git/commitdiff
Some edits
authorMark Otto <markd.otto@gmail.com>
Sat, 2 Apr 2022 03:54:28 +0000 (20:54 -0700)
committerRomaric Pascal <hello@romaricpascal.is>
Fri, 17 Feb 2023 09:42:44 +0000 (09:42 +0000)
site/content/docs/5.3/utilities/api.md

index 3a3167a34109b0657f91b51ddad8250b40267ee9..989704c0b2831e84343c2448732d499ffcda106c 100644 (file)
@@ -366,20 +366,16 @@ All utilities generated by the API include `!important` to ensure they override
 
 ## Using the API
 
-Now that you're familiar with how the utilities API works, learn how to add your own custom classes and modify our default utilities. There are two ways you can do this:
+Now that you're familiar with how the utilities API works, you can modify the default utilities and add your own. This can be done in two ways:
 
-1. If you only need to override our default utilities or add new ones, we'll merge your `$utilities` variable with ours
+1. If you only need to override our default utilities or add new ones, we'll merge your `$utilities` variable with ours.
 2. If you require more fine-grained control, we provide mixins to let you update our default utilities configuration.
 
 You may also want to refer to parts of the utilities configuration in your Sass code, the value of a specific utility especially. We provide getter functions to access those.
 
 ### Adding or overriding utilities
 
-If your code declares a `$utilities` map before importing `bootstrap/scss/utilities`,
-it'll get merged with ours:
-
-- add new keys to create your own utilities
-- override existing utilities by using the same key
+If your code declares a `$utilities` map before importing `bootstrap/scss/utilities`, it'll be merged with our default map. Add new keys to create your own utilities and override existing utilities by using the same key.
 
 ```scss
 $utilities: (
@@ -411,8 +407,7 @@ After importing `bootstrap/scss/utilities`, you can use mixins to:
 
 #### Adding and removing utilities
 
-`utilities-add` and `utilities-remove` mixins let you add and remove utilities from the configuration.
-Adding an existing utility will completely override it.
+`utilities-add` and `utilities-remove` mixins let you add and remove utilities from the configuration. Adding an existing utility will completely override it.
 
 ```scss
 @import "bootstrap/scss/functions";
@@ -437,9 +432,7 @@ Adding an existing utility will completely override it.
 
 #### Updating utility options
 
-`utilities-set-option` and `utilities-set-options` let you configure one or several options of a utility.
-`utilities-set-options` will merge the new options with the existing ones by default,
-but you can provide a third `$merge: false` argument to completely override them.
+`utilities-set-option` and `utilities-set-options` let you configure one or several options of a utility. `utilities-set-options` will merge the new options with the existing ones by default, but you can provide a third `$merge: false` argument to completely override them.
 
 And if the utility does not exist, both mixins will create a new one.
 
@@ -473,9 +466,7 @@ And if the utility does not exist, both mixins will create a new one.
 
 #### Updating utility values
 
-If you want to keep most of the default values for a utility, and just add, remove or update a few,
-replacing the `values` option can be a bit of a burden to maintain.
-`utilities-add-values` and `utilities-remove-values` mixins will help you make these targeted updates.
+If you want to keep most of the default values for a utility, and just add, remove or update a few, replacing the `values` option can be a bit of a burden to maintain. `utilities-add-values` and `utilities-remove-values` mixins will help you make these targeted updates.
 
 ```scss
 @import "bootstrap/scss/functions";
@@ -500,10 +491,7 @@ replacing the `values` option can be a bit of a burden to maintain.
 
 ### Getting utility values and options
 
-The `utilities-get-value` function let your grab a specific value of a utility.
-This can help you run some computations with it, either in Sass or with `calc()`.
-It also lets you access values that can be tweaked by other utilities,
-(like how `bg`, `text` and `border` can be tweaked by `bg-opacity`, `text-opacity` or `border-opacity` respectively).
+The `utilities-get-value` function let your grab a specific value of a utility. This can help you run some computations with it, either in Sass or with `calc()`. It also lets you access values that can be modified by other utilities, (like how `bg`, `text` and `border` can be affected by `bg-opacity`, `text-opacity` or `border-opacity` respectively).
 
 ```scss
 @import "bootstrap/scss/functions";