Add blog post about CSS vars in Bootstrap (#275)

* WIP * edits * edit * change date * add link * update social * more
author: Mark Otto <markd.otto@gmail.com> 2022-05-16 23:13:55 +0300
committer: GitHub <noreply@github.com> 2022-05-16 23:13:55 +0300
commit: 9d9e29aee2102f9bdd0e48c06796073281de2f11 (patch)
tree: a591bb8886d26331bbd3bf69b1547a3c28fbf8f2
parent: 16d173007b0b02c1a030626415513b53a88b073a (diff)
11 files changed, 210 insertions, 14 deletions
diff --git a/src/assets/scss/style.scss b/src/assets/scss/style.scss
index 76d2ca87..93f2722f 100644
--- a/src/assets/scss/style.scss
+++ b/src/assets/scss/style.scss
@@ -55,6 +55,10 @@
 .fw-500 { font-weight: 500; }
 .fw-600 { font-weight: 600; }
 
+hr {
+  margin-block: 2rem;
+}
+
 .highlight pre.chroma {
   padding: 1.25rem;
   margin: 0 0 1rem;
@@ -86,19 +90,12 @@ blockquote p:last-child {
 
 // Tables
 table {
-  width: 100%;
-  margin-bottom: 1rem;
-  border-collapse: collapse;
-  border: 1px solid #e5e5e5;
-}
-td,
-th {
-  padding: .25rem .5rem;
-  border: 1px solid #e5e5e5;
-}
-tbody tr:nth-child(odd) td,
-tbody tr:nth-child(odd) th {
-  background-color: #f9f9f9;
+  @extend .table;
+  font-size: .875rem;
+
+  tbody {
+    border-top: 2px solid currentcolor;
+  }
 }
 
 .s-32 {
@@ -184,7 +181,8 @@ tbody tr:nth-child(odd) th {
 }
 
 // Special case the opening paragraph
-.post > p:first-of-type {
+.post > p:first-of-type,
+.post > img:first-child + p {
   font-size: 130%;
   color: $gray-700;
 }
diff --git a/src/content/posts/2022/using-bootstrap-css-vars.md b/src/content/posts/2022/using-bootstrap-css-vars.md
new file mode 100644
index 00000000..1041a652
--- /dev/null
+++ b/src/content/posts/2022/using-bootstrap-css-vars.md
@@ -0,0 +1,185 @@
+---
+author: mdo
+date: "2022-05-16T00:00:00Z"
+title: Using CSS variables in Bootstrap
+keywords:
+  - bootstrap
+  - guide
+banner: "/assets/img/bootstrap-banner.png"
+---
+
+[Bootstrap v5.2.0-beta1](/2022/05/13/bootstrap-5-2-0-beta/) added a slew of CSS custom properties, or CSS variables, across the `:root` level and all our core components. Here's a quick look at how you can utilize them in your projects.
+
+With CSS variables, you can now customize Bootstrap easier than ever, and without the need for a CSS preprocessor. All the power of Sass is still there behind the scenes, but CSS variables adds a ton of power for the future. Use and compose new values, updates styles globally without recompiling, set fallback values, setup new color modes, and more.
+
+Let's dig in.
+
+## CSS variables?
+
+Their official name is custom properties, but they're often referred to as CSS variables thanks to their most immediate use case for setting specific values. Consider reading [the MDN CSS custom properties article](https://developer.mozilla.org/en-US/docs/Web/CSS/Using_CSS_custom_properties#first_steps_with_custom_properties) or [the CSS Tricks guide](https://css-tricks.com/a-complete-guide-to-custom-properties/) if you need a primer.
+
+In a nutshell, CSS variables allow you to name frequently used values. For example, instead of writing `#6f42c1` everywhere, you can set `--purple: #6f42c1`. Then you can use that variable later on with the `var()` function.
+
+```css
+:root {
+  --purple: #6f42c1;
+}
+.custom-element {
+  color: var(--purple);
+}
+```
+
+We use CSS variables in Bootstrap to set many property values globally, across our components, and in some of our utilities.
+
+## Groups of variables
+
+When we talk about CSS variables in Bootstrap, we're referring to three major groups:
+
+- **Root variables —** Globally scoped variables available on the `:root` element (`<html>` usually) and accessible by any element throughout the DOM.
+
+- **Component variables —** Variables scoped specifically to each component, usually on the component's base class, and their modifier classes and Sass mixins.
+
+- **Utility variables —** Used as modifiers within other utility classes.
+
+Regardless of where they are, all of our CSS variables are prefixed with `--bs-`, so you know where they're coming from and how they might be used across codebases that mix Bootstrap's CSS with additional custom styles. You'll also notice that we don't put all our component variables at the root level. This keeps CSS variables scoped to their intended use cases and prevents polluted variables in the global `:root` scope.
+
+It's also worth mentioning two larger efforts that are still to come around CSS variables:
+
+1. Adding CSS variables to all our forms
+2. Adding more nuanced global theme variables and support for color modes like [dark mode](https://github.com/twbs/bootstrap/pull/35857).
+
+These are likely coming in v5.3.0 (our next minor release after v5.2.0 stablizes), so in the mean time, check out the GitHub repo to see how things are shaping up.
+
+## Root variables
+
+![Root variables in web inspector](/assets/img/2022/05/docs-root-vars.png)
+
+Bootstrap has a ton of [root variables](https://getbootstrap.com/docs/5.2/customize/css-variables/#root-variables) and we'll only be adding more in future updates for the aforementioned color mode support. As of this post, we have the following CSS variables on the `:root` element:
+
+- **Colors —** All named colors, gray colors, and theme colors. This also includes all our `$theme-colors` in their `rgb` format.
+
+- **Body font styles —** Everything from `font-size` to `color` and more, all applied to our `<body>` element.
+
+- **Shared properties —** For property-value pairings that we consider theme specific, like link colors and border styles.
+
+Root CSS variables are used extensively across other parts of Bootstrap to allow you to easily override our default styles at a global level. For example, if you wanted to adjust the default `border-radius` and link color for our components, you could override a couple variables instead of writing new selectors.
+
+```scss
+// custom.css
+:root {
+  --bs-border-radius: .5rem;
+  --bs-link-color: #333;
+}
+```
+
+You can even use other root variables to override those values:
+
+```scss
+// custom.css
+:root {
+  --bs-border-radius: var(--bs-border-radius-lg);
+  --bs-link-color: var(--bs-gray-800);
+}
+```
+
+Without CSS variables, you'd have to use a preprocessor like Sass or write new selectors for every instance of these properties across all components. The former is relatively easy, the latter not so much. CSS variables help solve that.
+
+## Component variables
+
+On our components, CSS variables get even more power for customizing. Nearly everything under the Components section in our docs sidebar now has CSS variables available to you:
+
+- [Accordion](https://getbootstrap.com/docs/5.2/components/accordion/)
+- [Alerts](https://getbootstrap.com/docs/5.2/components/alerts/)
+- [Badge](https://getbootstrap.com/docs/5.2/components/badge/)
+- [Breadcrumb](https://getbootstrap.com/docs/5.2/components/breadcrumb/)
+- [Buttons](https://getbootstrap.com/docs/5.2/components/buttons/)
+- [Button group](https://getbootstrap.com/docs/5.2/components/button-group/)
+- [Card](https://getbootstrap.com/docs/5.2/components/card/)
+- [Carousel](https://getbootstrap.com/docs/5.2/components/carousel/)
+- [Collapse](https://getbootstrap.com/docs/5.2/components/collapse/)
+- [Dropdowns](https://getbootstrap.com/docs/5.2/components/dropdowns/)
+- [List group](https://getbootstrap.com/docs/5.2/components/list-group/)
+- [Modal](https://getbootstrap.com/docs/5.2/components/modal/)
+- [Navbar](https://getbootstrap.com/docs/5.2/components/navbar/)
+- [Navs & tabs](https://getbootstrap.com/docs/5.2/components/navs-tabs/)
+- [Offcanvas](https://getbootstrap.com/docs/5.2/components/offcanvas/)
+- [Pagination](https://getbootstrap.com/docs/5.2/components/pagination/)
+- [Placeholders](https://getbootstrap.com/docs/5.2/components/placeholders/)
+- [Popovers](https://getbootstrap.com/docs/5.2/components/popovers/)
+- [Progress](https://getbootstrap.com/docs/5.2/components/progress/)
+- [Spinners](https://getbootstrap.com/docs/5.2/components/spinners/)
+- [Toasts](https://getbootstrap.com/docs/5.2/components/toasts/)
+- [Tooltips](https://getbootstrap.com/docs/5.2/components/tooltips/)
+
+_Scrollspy and close button have no relevant CSS variables, so they're excluded here._
+
+Throughout our documentation you'll find examples of customizing our default components by overriding their CSS variables. One great example comes from our own docs where we write our own button styles to [create a purple button](https://getbootstrap.com/docs/5.2/components/buttons/#variables).
+
+```css
+.btn-bd-primary {
+  --bs-btn-font-weight: 600;
+  --bs-btn-color: var(--bs-white);
+  --bs-btn-bg: var(--bd-violet);
+  --bs-btn-border-color: var(--bd-violet);
+  --bs-btn-border-radius: .5rem;
+  --bs-btn-hover-color: var(--bs-white);
+  --bs-btn-hover-bg: #{shade-color($bd-violet, 10%)};
+  --bs-btn-hover-border-color: #{shade-color($bd-violet, 10%)};
+  --bs-btn-focus-shadow-rgb: var(--bd-violet-rgb);
+  --bs-btn-active-color: var(--bs-btn-hover-color);
+  --bs-btn-active-bg: #{shade-color($bd-violet, 20%)};
+  --bs-btn-active-border-color: #{shade-color($bd-violet, 20%)};
+}
+```
+
+Which looks like this:
+
+![Custom Bootstrap docs button](/assets/img/2022/05/docs-custom-button.png)
+
+Another great example is from [our tooltips](https://getbootstrap.com/docs/5.2/components/tooltips/#custom-tooltips). You can add custom classes to tooltips and popovers in Bootstrap with `data-bs-custom-class="custom-tooltip"`. Then, with one CSS variable, you can change the tooltip background and arrow color.
+
+```css
+.custom-tooltip {
+  --bs-tooltip-bg: var(--bs-primary);
+}
+```
+
+Which looks like this:
+
+![Custom tooltip](/assets/img/2022/05/docs-custom-tooltip.png)
+
+There are dozens of CSS variables in play across our components. All of them are referenced in a new section on the relevant docs page. For example, [here are our modal CSS variables](https://getbootstrap.com/docs/5.2/components/modal/#variables). This is in addition to all the Sass variables, mixins, loops, and maps used for each component.
+
+## Utility variables
+
+Not every utility class uses CSS variables, but the ones that do gain a good amount of power and customization. [Background](https://getbootstrap.com/docs/5.2/utilities/background/), [border](https://getbootstrap.com/docs/5.2/utilities/borders/), and [color](https://getbootstrap.com/docs/5.2/utilities/colors/) utilities all have what we call "local CSS variables" to improve their usefulness. Each of them uses CSS variables to customize the alpha transparency value of `rgba()` colors.
+
+Consider our [background color utilities](https://getbootstrap.com/docs/5.2/utilities/background/), `.bg-*`. By default each utility class has a local variable, `--bs-bg-opacity` with a default value of `1`. To change the background utility alpha value, you can override that value with your own styles, or some new `.bg-opacity-*` utilities.
+
+```html
+<div class="p-3 bg-success bg-opacity-25">
+  ...
+</div>
+```
+
+Here's how `.bg-success` looks with all our `.bg-opacity-*` classes applied:
+
+![Background opacity examples](/assets/img/2022/05/bg-opacity.png)
+
+And the same is available for [border color opacity](https://getbootstrap.com/docs/5.2/utilities/borders/#opacity) (`--bs-border-opacity` and `.border-opacity-*`) and [text color opacity](https://getbootstrap.com/docs/5.2/utilities/colors/#opacity) (`--bs-text-opacity` and `.text-opacity-*`). So many color options are now available with these utilities.
+
+By default, we ship with five values for these various opacity utilities.
+
+| Class names | Alpha value |
+| --- | --- |
+| `.text-opacity-10`<br> `.bg-opacity-10`<br> `.border-opacity-10` | `.1` |
+| `.text-opacity-25`<br> `.bg-opacity-25`<br> `.border-opacity-25` | `.25` |
+| `.text-opacity-50`<br> `.bg-opacity-50`<br> `.border-opacity-50` | `.5` |
+| `.text-opacity-75`<br> `.bg-opacity-75`<br> `.border-opacity-75` | `.75` |
+| `.text-opacity-100`<br> `.bg-opacity-100`<br> `.border-opacity-100` | `1` |
+
+Expect more CSS variables to make their way into our utilities. There's a lot of power in real-time customization, even for what we consider immutable styles.
+
+---
+
+**Ready to get started with Bootstrap?** Checkout the [quick start guide](https://getbootstrap.com/docs/5.2/getting-started/introduction/#quick-start) so you can put these new CSS variables to work in your next project!
diff --git a/src/layouts/_default/home.html b/src/layouts/_default/home.html
index 39cc6778..22edc0a4 100644
--- a/src/layouts/_default/home.html
+++ b/src/layouts/_default/home.html
@@ -19,6 +19,10 @@
           {{- partial "video" (dict "context" . "lazyload" $lazyload) -}}
         {{- end }}
 
+        {{ if .Page.Params.banner -}}
+          {{- partial "banner" (dict "context" .) -}}
+        {{- end }}
+
         {{ .Content }}
       </div>
     {{- end }}
diff --git a/src/layouts/partials/banner.html b/src/layouts/partials/banner.html
new file mode 100644
index 00000000..403306a3
--- /dev/null
+++ b/src/layouts/partials/banner.html
@@ -0,0 +1,5 @@
+{{- /* Accepts 1 parameter, the "context" */ -}}
+
+{{- $image := .context.Page.Params.banner -}}
+
+<img src="{{ $image }}" class="img-fluid rounded-3 mb-4" alt="">
diff --git a/src/layouts/posts/single.html b/src/layouts/posts/single.html
index cc47a3fc..107938e7 100644
--- a/src/layouts/posts/single.html
+++ b/src/layouts/posts/single.html
@@ -8,6 +8,10 @@
       {{- partial "video" (dict "context" .) -}}
     {{- end -}}
 
+    {{- if .Page.Params.banner -}}
+      {{- partial "banner" (dict "context" .) -}}
+    {{- end -}}
+
     {{ .Content }}
   </div>
 
diff --git a/src/static/assets/img/2022/05/bg-opacity.png b/src/static/assets/img/2022/05/bg-opacity.png
new file mode 100644
index 00000000..65eed41e
--- /dev/null
+++ b/src/static/assets/img/2022/05/bg-opacity.png
diff --git a/src/static/assets/img/2022/05/docs-custom-button.png b/src/static/assets/img/2022/05/docs-custom-button.png
new file mode 100644
index 00000000..3d7b1b59
--- /dev/null
+++ b/src/static/assets/img/2022/05/docs-custom-button.png
diff --git a/src/static/assets/img/2022/05/docs-custom-tooltip.png b/src/static/assets/img/2022/05/docs-custom-tooltip.png
new file mode 100644
index 00000000..6de47c2d
--- /dev/null
+++ b/src/static/assets/img/2022/05/docs-custom-tooltip.png
diff --git a/src/static/assets/img/2022/05/docs-root-vars.png b/src/static/assets/img/2022/05/docs-root-vars.png
new file mode 100644
index 00000000..f5e38331
--- /dev/null
+++ b/src/static/assets/img/2022/05/docs-root-vars.png
diff --git a/src/static/assets/img/bootstrap-banner.png b/src/static/assets/img/bootstrap-banner.png
new file mode 100644
index 00000000..dd9a72af
--- /dev/null
+++ b/src/static/assets/img/bootstrap-banner.png
diff --git a/src/static/assets/img/bootstrap-social.png b/src/static/assets/img/bootstrap-social.png
index c7adc6f8..82b59c65 100644
--- a/src/static/assets/img/bootstrap-social.png
+++ b/src/static/assets/img/bootstrap-social.png
author	Mark Otto <markd.otto@gmail.com>	2022-05-16 23:13:55 +0300
committer	GitHub <noreply@github.com>	2022-05-16 23:13:55 +0300
commit	9d9e29aee2102f9bdd0e48c06796073281de2f11 (patch)
tree	a591bb8886d26331bbd3bf69b1547a3c28fbf8f2
parent	16d173007b0b02c1a030626415513b53a88b073a (diff)