From 634344c003b4cf26f38d24993c54fc880bbd1e2f Mon Sep 17 00:00:00 2001 From: Mark Otto Date: Sun, 21 Jul 2019 17:38:36 -0700 Subject: v4/v5: Add responsive containers (#29095) * create responsive containers provide more flexibility and allow the user to determine when containers switch from fluid to fixed width. * fix the base container code this commit fixes the non-media portion of the generated CSS. I learned about the `@extends` directive and was able to put it to good use. I create a new temporary map that contains all the main `$container-max-widths` and join it to our 2 special cases of 'xs' and 'fluid'. Then we loop through that and, with the appropriate infixes, extend our placeholder * formatting for style forgot to run my tests before the last push, i think these are better. * finish incomplete comment * fix the responsive containers using the `@extend` directive I was able to clean up this code * fix responsive containers in the navbar mostly we just look through all of our breakpoints so we can include all of the responsive container classes in the tweaks we have to do for the navbar (redeclaring flex properties, don't double up on padding, etc) * Simplify container extends * Simplify navbar containers * Rearrange, add comments, ensure everything is nested in $enable-grid-classes * Reduce new CSS by using attribute selector We avoid using `@extend` whenever possible, and this is more readable * Update _grid.scss * Update _navbar.scss * Add docs for responsive containers, redesign the container layout page * Add to the Grid example --- site/content/docs/4.3/examples/grid/grid.css | 7 +++++ site/content/docs/4.3/examples/grid/index.html | 10 +++++++ site/content/docs/4.3/layout/overview.md | 39 +++++++++++++++++++------- 3 files changed, 46 insertions(+), 10 deletions(-) (limited to 'site/content/docs') diff --git a/site/content/docs/4.3/examples/grid/grid.css b/site/content/docs/4.3/examples/grid/grid.css index e726996d3..8032c31c3 100644 --- a/site/content/docs/4.3/examples/grid/grid.css +++ b/site/content/docs/4.3/examples/grid/grid.css @@ -4,3 +4,10 @@ background-color: rgba(86, 61, 124, .15); border: 1px solid rgba(86, 61, 124, .2); } + +.themed-container { + padding: 15px; + margin-bottom: 30px; + background-color: rgba(0, 123, 255, .15); + border: 1px solid rgba(0, 123, 255, .2); +} diff --git a/site/content/docs/4.3/examples/grid/index.html b/site/content/docs/4.3/examples/grid/index.html index 230fd6a57..24289cea5 100644 --- a/site/content/docs/4.3/examples/grid/index.html +++ b/site/content/docs/4.3/examples/grid/index.html @@ -125,3 +125,13 @@ include_js: false + +
+

Responsive containers

+

Additional classes added in Bootstrap v4.4 allow containers that are 100% wide until a particular breakpoint.

+
+ +
.container-sm
+
.container-md
+
.container-lg
+
.container-xl
diff --git a/site/content/docs/4.3/layout/overview.md b/site/content/docs/4.3/layout/overview.md index dd2f34691..79b799ca0 100644 --- a/site/content/docs/4.3/layout/overview.md +++ b/site/content/docs/4.3/layout/overview.md @@ -9,15 +9,15 @@ 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). +Containers are the most basic layout element in Bootstrap and are **required when using our default grid system**. While containers *can* be nested, most layouts do not require a nested container. -While containers *can* be nested, most layouts do not require a nested container. +### All-in-one + +Our default `.container` class is a responsive, fixed-width container, meaning its `max-width` changes at each breakpoint.
-
-
-
-
+
+ .container
@@ -27,13 +27,13 @@ While containers *can* be nested, most layouts do not require a nested container
{{< /highlight >}} +### Fluid + Use `.container-fluid` for a full width container, spanning the entire width of the viewport.
-
-
-
-
+
+ .container-fluid
@@ -43,6 +43,25 @@ Use `.container-fluid` for a full width container, spanning the entire width of
{{< /highlight >}} +### Responsive + +Responsive containers are new in Bootstrap v4.4. They allow you to specify a class that is 100% wide until particular breakpoint is reached and a `max-width` is applied. For example, `.container-sm` is 100% wide to start until the `sm` breakpoint is reached, where it will remain through the higher breakpoints. + +
+
+ .container-sm (100% wide until breakpoint) +
+
+ .container-sm (With max-width at breakpoint) +
+
+ +{{< highlight html >}} +
100% wide until small breakpoint
+
100% wide until medium breakpoint
+
100% wide until large breakpoint
+
100% wide until extra large breakpoint
+{{< /highlight >}} ## Responsive breakpoints -- cgit v1.2.3