From 33a4e8ff9b7ef7ec00e769d7a70d3634c19b08df Mon Sep 17 00:00:00 2001
From: Mark Otto <markdotto@gmail.com>
Date: Thu, 2 Apr 2020 11:44:07 -0700
Subject: Rewrite grid docs to account for new grid tier

- Breaks grid content across multiple pages
- Updates mentions of grid tiers from five to six
- Rewrites how it works sections to reference new options and tiers
---
 site/content/docs/4.3/layout/z-index.md | 24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)
 create mode 100644 site/content/docs/4.3/layout/z-index.md

(limited to 'site/content/docs/4.3/layout/z-index.md')

diff --git a/site/content/docs/4.3/layout/z-index.md b/site/content/docs/4.3/layout/z-index.md
new file mode 100644
index 000000000..d1820a4e3
--- /dev/null
+++ b/site/content/docs/4.3/layout/z-index.md
@@ -0,0 +1,24 @@
+---
+layout: docs
+title: Z-index
+description: While not a part of Bootstrap's grid system, z-indexes play an important part in how our components overlay and interact with one another.
+group: layout
+---
+
+Several Bootstrap components utilize `z-index`, the CSS property that helps control layout by providing a third axis to arrange content. We utilize a default z-index scale in Bootstrap that's been designed to properly layer navigation, tooltips and popovers, modals, and more.
+
+These higher values start at an arbitrary number, high and specific enough to ideally avoid conflicts. We need a standard set of these across our layered components—tooltips, popovers, navbars, dropdowns, modals—so we can be reasonably consistent in the behaviors. There's no reason we couldn't have used `100`+ or `500`+.
+
+We don't encourage customization of these individual values; should you change one, you likely need to change them all.
+
+{{< highlight scss >}}
+$zindex-dropdown:          1000 !default;
+$zindex-sticky:            1020 !default;
+$zindex-fixed:             1030 !default;
+$zindex-modal-backdrop:    1040 !default;
+$zindex-modal:             1050 !default;
+$zindex-popover:           1060 !default;
+$zindex-tooltip:           1070 !default;
+{{< /highlight >}}
+
+To handle overlapping borders within components (e.g., buttons and inputs in input groups), we use low single digit `z-index` values of `1`, `2`, and `3` for default, hover, and active states. On hover/focus/active, we bring a particular element to the forefront with a higher `z-index` value to show their border over the sibling elements.
-- 
cgit v1.2.3