0
0
mirror of https://github.com/twbs/bootstrap.git synced 2024-12-04 16:24:22 +01:00
Bootstrap/site/content/docs/5.3/utilities/z-index.md
Julien Déramond 01364cb49c
Docs: consistent usage of CSS sections (#38219)
Co-authored-by: Mark Otto <markd.otto@gmail.com>
2023-04-10 17:53:28 +02:00

2.1 KiB

layout title description group toc added
docs Z-index Use our low-level `z-index` utilities to quickly change the stack level of an element or component. utilities true 5.3

Example

Use z-index utilities to stack elements on top of one another. Requires a position value other than static, which can be set with custom styles or using our [position utilities]({{< docsref "/utilities/position/" >}}).

{{< callout >}} We call these "low-level" z-index utilities because of their default values of -1 through 3, which we use for the layout of overlapping components. High-level z-index values are used for overlay components like modals and tooltips. {{< /callout >}}

{{< example class="bd-example-zindex-levels position-relative" >}}

z-3
z-2
z-1
z-0
z-n1
{{< /example >}}

Overlays

Bootstrap overlay components—dropdown, modal, offcanvas, popover, toast, and tooltip—all have their own z-index values to ensure a usable experience with competing "layers" of an interface.

Read about them in the [z-index layout page]({{< docsref "/layout/z-index" >}}).

Component approach

On some components, we use our low-level z-index values to manage repeating elements that overlap one another (like buttons in a button group or items in a list group).

Learn about our [z-index approach]({{< docsref "/extend/approach#z-index-scales" >}}).

CSS

Sass maps

Customize this Sass map to change the available values and generated utilities.

{{< scss-docs name="zindex-levels-map" file="scss/_variables.scss" >}}

Sass utilities API

Position utilities are declared in our utilities API in scss/_utilities.scss. [Learn how to use the utilities API.]({{< docsref "/utilities/api#using-the-api" >}})

{{< scss-docs name="utils-zindex" file="scss/_utilities.scss" >}}