0
0
mirror of https://github.com/twbs/bootstrap.git synced 2024-12-10 22:24:19 +01:00
Bootstrap/docs/4.0/layout/overview.md
rmacklin 9e6dabbb10 Reduce z-indexes in button-group, input-group, list-group, and pagination to the minimum necessary (#24315)
These were using `z-index: 2` to "Place active items above their
siblings for proper border styling". However, using `z-index: 1` is
sufficient for accomplishing that goal.

In input-group, there were also three `z-index: 3` rules for the
hover/focus/active states. I reduced these to `z-index: 2` since they
just needed to be "one more than normal" (i.e. one more than what is now
`z-index: 1` after my changes).

These changes can be verified by viewing the documentation pages for
Button group, Input group, List group, and Pagination before and after
this commit and observing that the active elements are still "above"
their siblings, so their borders look correct.
2017-10-20 10:01:29 +03:00

6.2 KiB

layout title description group redirect_from toc
docs Overview Components and options for laying out your Bootstrap project, including wrapping containers, a powerful grid system, a flexible media object, and responsive utility classes. layout /docs/4.0/layout/ true

Containers

Containers are the most basic layout element in Bootstrap and are required when using our default grid system. Choose from a responsive, fixed-width container (meaning its max-width changes at each breakpoint) or fluid-width (meaning it's 100% wide all the time).

While containers can be nested, most layouts do not require a nested container.

{% highlight html %}

{% endhighlight %}

Use .container-fluid for a full width container, spanning the entire width of the viewport.

{% highlight html %}

...
{% endhighlight %}

Responsive breakpoints

Since Bootstrap is developed to be mobile first, we use a handful of media queries to create sensible breakpoints for our layouts and interfaces. These breakpoints are mostly based on minimum viewport widths and allow us to scale up elements as the viewport changes.

Bootstrap primarily uses the following media query ranges—or breakpoints—in our source Sass files for our layout, grid system, and components.

{% highlight scss %} // Extra small devices (portrait phones, less than 576px) // No media query since this is the default in Bootstrap

// Small devices (landscape phones, 576px and up) @media (min-width: 576px) { ... }

// Medium devices (tablets, 768px and up) @media (min-width: 768px) { ... }

// Large devices (desktops, 992px and up) @media (min-width: 992px) { ... }

// Extra large devices (large desktops, 1200px and up) @media (min-width: 1200px) { ... } {% endhighlight %}

Since we write our source CSS in Sass, all our media queries are available via Sass mixins:

{% highlight scss %} @include media-breakpoint-up(xs) { ... } @include media-breakpoint-up(sm) { ... } @include media-breakpoint-up(md) { ... } @include media-breakpoint-up(lg) { ... } @include media-breakpoint-up(xl) { ... }

// Example usage: @include media-breakpoint-up(sm) { .some-class { display: block; } } {% endhighlight %}

We occasionally use media queries that go in the other direction (the given screen size or smaller):

{% highlight scss %} // Extra small devices (portrait phones, less than 576px) @media (max-width: 575px) { ... }

// Small devices (landscape phones, less than 768px) @media (max-width: 767px) { ... }

// Medium devices (tablets, less than 992px) @media (max-width: 991px) { ... }

// Large devices (desktops, less than 1200px) @media (max-width: 1199px) { ... }

// Extra large devices (large desktops) // No media query since the extra-large breakpoint has no upper bound on its width {% endhighlight %}

Once again, these media queries are also available via Sass mixins:

{% highlight scss %} @include media-breakpoint-down(xs) { ... } @include media-breakpoint-down(sm) { ... } @include media-breakpoint-down(md) { ... } @include media-breakpoint-down(lg) { ... } {% endhighlight %}

There are also media queries and mixins for targeting a single segment of screen sizes using the minimum and maximum breakpoint widths.

{% highlight scss %} // Extra small devices (portrait phones, less than 576px) @media (max-width: 575px) { ... }

// Small devices (landscape phones, 576px and up) @media (min-width: 576px) and (max-width: 767px) { ... }

// Medium devices (tablets, 768px and up) @media (min-width: 768px) and (max-width: 991px) { ... }

// Large devices (desktops, 992px and up) @media (min-width: 992px) and (max-width: 1199px) { ... }

// Extra large devices (large desktops, 1200px and up) @media (min-width: 1200px) { ... } {% endhighlight %}

These media queries are also available via Sass mixins:

{% highlight scss %} @include media-breakpoint-only(xs) { ... } @include media-breakpoint-only(sm) { ... } @include media-breakpoint-only(md) { ... } @include media-breakpoint-only(lg) { ... } @include media-breakpoint-only(xl) { ... } {% endhighlight %}

Similarly, media queries may span multiple breakpoint widths:

{% highlight scss %} // Example // Apply styles starting from medium devices and up to extra large devices @media (min-width: 768px) and (max-width: 1199px) { ... } {% endhighlight %}

The Sass mixin for targeting the same screen size range would be:

{% highlight scss %} @include media-breakpoint-between(md, xl) { ... } {% endhighlight %}

Z-index

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.

We don't encourage customization of these values; should you change one, you likely need to change them all.

$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;

Background elements—like the backdrops that allow click-dismissing—tend to reside on a lower z-indexs, while navigation and popovers utilize higher z-indexs to ensure they overlay surrounding content.

Additionally, the button-group, input-group, list-group, and pagination components make use of setting z-index to 1 or 2 in order to ensure that the borders of the active element correctly appear "above" their sibling elements.