From a3bc607c1080df2d0bbca03c613aa9e992acb722 Mon Sep 17 00:00:00 2001 From: Pierre-Denis Vanduynslager Date: Mon, 16 Jan 2017 00:35:18 -0500 Subject: Remove unused scss variables (#21579) * Remove unused scss variables * Remove unnecessary space * Remove $zindex-navbar from docs * Re-add $progress-box-shadow --- docs/layout/overview.md | 1 - 1 file changed, 1 deletion(-) (limited to 'docs/layout/overview.md') diff --git a/docs/layout/overview.md b/docs/layout/overview.md index 736b9ed12..04aa2c9ad 100644 --- a/docs/layout/overview.md +++ b/docs/layout/overview.md @@ -169,7 +169,6 @@ We don't encourage customization of these values; should you change one, you lik ```scss $zindex-dropdown-backdrop: 990 !default; -$zindex-navbar: 1000 !default; $zindex-dropdown: 1000 !default; $zindex-fixed: 1030 !default; $zindex-sticky: 1030 !default; -- cgit v1.2.3 From fa2731b6264ad44c6d2600b7a4efab0ddaca7a06 Mon Sep 17 00:00:00 2001 From: Mark Otto Date: Sat, 27 May 2017 22:12:00 -0700 Subject: update layout pages --- docs/layout/overview.md | 8 +------- 1 file changed, 1 insertion(+), 7 deletions(-) (limited to 'docs/layout/overview.md') diff --git a/docs/layout/overview.md b/docs/layout/overview.md index 04aa2c9ad..b167bbc2e 100644 --- a/docs/layout/overview.md +++ b/docs/layout/overview.md @@ -4,15 +4,9 @@ title: Overview description: Components and options for laying out your Bootstrap project, including wrapping containers, a powerful grid system, a flexible media object, and responsive utility classes. group: layout redirect_from: "/layout/" +toc: true --- -Bootstrap includes several components and options for laying out your project, including wrapping containers, a powerful flexbox grid system, a flexible media object, and responsive utility classes. - -## Contents - -* Will be replaced with the ToC, excluding the "Contents" header -{:toc} - ## 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). -- cgit v1.2.3 From 3e76d6565603fafa2c85ad81d7b6345c4e279c72 Mon Sep 17 00:00:00 2001 From: Mark Otto Date: Sun, 28 May 2017 22:50:57 -0700 Subject: Rearrange all the docs to allow for a docs/major.minor/ setup --- docs/layout/overview.md | 175 ------------------------------------------------ 1 file changed, 175 deletions(-) delete mode 100644 docs/layout/overview.md (limited to 'docs/layout/overview.md') diff --git a/docs/layout/overview.md b/docs/layout/overview.md deleted file mode 100644 index b167bbc2e..000000000 --- a/docs/layout/overview.md +++ /dev/null @@ -1,175 +0,0 @@ ---- -layout: docs -title: Overview -description: Components and options for laying out your Bootstrap project, including wrapping containers, a powerful grid system, a flexible media object, and responsive utility classes. -group: layout -redirect_from: "/layout/" -toc: 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](https://developer.mozilla.org/en-US/docs/Web/CSS/Media_Queries/Using_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. - -```scss -$zindex-dropdown-backdrop: 990 !default; -$zindex-dropdown: 1000 !default; -$zindex-fixed: 1030 !default; -$zindex-sticky: 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-index`s, while navigation and popovers utilize higher `z-index`s to ensure they overlay surrounding content. -- cgit v1.2.3