From ebe405a01b721b667a37ae5c249077f4cdb3b8bd Mon Sep 17 00:00:00 2001 From: Mark Otto Date: Fri, 3 Mar 2017 12:57:16 -0800 Subject: Start rearranging the docs for a utilities update MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit — Rename display docs page — Move print display utils to display utils page — Drop remaining of responsive utils page as it's being replaced with display utils — Update nav to reflect changes --- docs/layout/utilities-for-layout.md | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) create mode 100644 docs/layout/utilities-for-layout.md (limited to 'docs/layout/utilities-for-layout.md') diff --git a/docs/layout/utilities-for-layout.md b/docs/layout/utilities-for-layout.md new file mode 100644 index 000000000..50f4ce395 --- /dev/null +++ b/docs/layout/utilities-for-layout.md @@ -0,0 +1,21 @@ +--- +layout: docs +title: Utilities for layout +description: Use any of our dozens of responsive utility classes for showing, hiding, aligning, and spacing content. +group: layout +--- + +For faster mobile-friendly and responsive development, Bootstrap includes dozens of utility classes for showing, hiding, aligning, and spacing content. Below is a primer on what's included in Bootstrap and how these utilities can help you with layout. + +## Contents + +* Will be replaced with the ToC, excluding the "Contents" header +{:toc} + +## Changing `display` + +## Flexbox options + +## Margin and padding + +## Toggle `visibility` -- cgit v1.2.3 From a607ead34c62007842f8825068367ab95812e04c Mon Sep 17 00:00:00 2001 From: Mark Otto Date: Sun, 5 Mar 2017 13:03:35 -0600 Subject: fill in docs for layout utils page --- docs/layout/utilities-for-layout.md | 10 ++++++++++ 1 file changed, 10 insertions(+) (limited to 'docs/layout/utilities-for-layout.md') diff --git a/docs/layout/utilities-for-layout.md b/docs/layout/utilities-for-layout.md index 50f4ce395..881f3326d 100644 --- a/docs/layout/utilities-for-layout.md +++ b/docs/layout/utilities-for-layout.md @@ -14,8 +14,18 @@ For faster mobile-friendly and responsive development, Bootstrap includes dozens ## Changing `display` +Use our `display` utilities for responsively toggling common values of the `display` property. Mix it with our grid system, content, or components to show or hide them across specific viewports. + ## Flexbox options +Bootstrap 4 is built with flexbox, but not every element's `display` has been changed to `display: flex` as this would add many unnecessary overrides and unexpectedly change key browser behaviors. Most of [our components](/components/) are built with flexbox enabled. + +Should you need to add `display: flex` to an element, do so with `.d-flex` or one of the responsive variants (e.g., `.d-sm-flex`). You'll need this class or `display` value to allow the use of our extra [flexbox utilities](/utilities/flexbox/) for sizing, alignment, spacing, and more. + ## Margin and padding +Use the `margin` and `padding` [spacing utilities](/utilities/spacing/) to control how elements and components are spaced and sized. Bootstrap 4 includes a five-level scale for spacing utilities, based on a `1rem` value default `$spacer` variable. Choose values for all viewports (e.g., `.mr-3` for `margin-right: 1rem`), or pick responsive variants to target specific viewports (e.g., `.mr-md-3` for `margin-right: 1rem` starting at the `md` breakpoint). + ## Toggle `visibility` + +When toggling `display` isn't needed, you can toggle the `visibility` of an element with our [visibility utilities](/utilities/visibility/). -- cgit v1.2.3 From ac3a2fe9bf5bbfb2d0948da260d5353a03cc5b03 Mon Sep 17 00:00:00 2001 From: Mark Otto Date: Sun, 5 Mar 2017 13:04:48 -0600 Subject: add more --- docs/layout/utilities-for-layout.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'docs/layout/utilities-for-layout.md') diff --git a/docs/layout/utilities-for-layout.md b/docs/layout/utilities-for-layout.md index 881f3326d..12ba7006c 100644 --- a/docs/layout/utilities-for-layout.md +++ b/docs/layout/utilities-for-layout.md @@ -28,4 +28,4 @@ Use the `margin` and `padding` [spacing utilities](/utilities/spacing/) to contr ## Toggle `visibility` -When toggling `display` isn't needed, you can toggle the `visibility` of an element with our [visibility utilities](/utilities/visibility/). +When toggling `display` isn't needed, you can toggle the `visibility` of an element with our [visibility utilities](/utilities/visibility/). Invisible elements will still affect the layout of the page, but are visually hidden from visitors. -- cgit v1.2.3