mirror of
https://github.com/tenrok/bootstrap.git
synced 2026-06-17 19:21:23 +03:00
Bump version to 5.0.0-alpha1 (#29925)
Also add v4.5.0 in versions and keep README.md pointing to v4.5.0 so that there are no broken stuff.
This commit is contained in:
XhmikosR
@@ -0,0 +1,262 @@
|
||||
---
|
||||
layout: docs
|
||||
title: Utility API
|
||||
description: The utility API is a Sass based tool to generate utility classes.
|
||||
group: utilities
|
||||
aliases: "/docs/5.0/utilities/"
|
||||
toc: true
|
||||
---
|
||||
|
||||
The bootstrap utilities are generated with the utility API which can be used to change or extend Bootstrap's utility classes. If you don't have any idea what Sass maps are, you can consult the [official docs](https://sass-lang.com/documentation/values/maps) to get started.
|
||||
|
||||
The `$utilities` map contains all utilities and is later merged with your custom `$utilities` map if present. The utility map contains a keyed list of utility groups which accept the following options:
|
||||
|
||||
- `property`: Name of the property, this can be a string or an array of strings (needed for eg. horizontal paddings or margins).
|
||||
- `responsive` _(optional)_: Boolean indicating if responsive classes need to be generated. `false` by default.
|
||||
- `rfs` _(optional)_: Variable to enable fluid rescaling. Have a look at the [RFS]({{< docsref "/getting-started/rfs" >}}) page to find out how this works. `false` by default.
|
||||
- `class` _(optional)_: Variable to change the class name if you don't want it to be the same as the property. In case you don't provide the `class` key and `property` key is an array of strings, the class name will be the first element of the `property` array.
|
||||
- `values`: This can be a list of values or a map if you don't want the class name to be the same as the value. If null is used as map key, it isn't rendered.
|
||||
- `print` _(optional)_: Boolean indicating if print classes need to be generated. `false` by default.
|
||||
|
||||
|
||||
## Adding utilities to the utility API
|
||||
|
||||
All utility variables are added to the `$utilities` variable. Custom utility groups can added like this:
|
||||
|
||||
```scss
|
||||
$utilities: (
|
||||
"opacity": (
|
||||
property: opacity,
|
||||
values: (
|
||||
0: 0,
|
||||
25: .25,
|
||||
50: .5,
|
||||
100: 1,
|
||||
)
|
||||
)
|
||||
);
|
||||
```
|
||||
|
||||
Output:
|
||||
|
||||
```css
|
||||
.opacity-0 {
|
||||
opacity: 0;
|
||||
}
|
||||
.opacity-25 {
|
||||
opacity: .25;
|
||||
}
|
||||
.opacity-75 {
|
||||
opacity: .75;
|
||||
}
|
||||
.opacity-100 {
|
||||
opacity: 1;
|
||||
}
|
||||
```
|
||||
|
||||
|
||||
## Changing the class prefix
|
||||
|
||||
With the `class` option, the class prefix can be changed:
|
||||
|
||||
```scss
|
||||
$utilities: (
|
||||
"opacity": (
|
||||
property: opacity,
|
||||
class: o,
|
||||
values: (
|
||||
0: 0,
|
||||
25: .25,
|
||||
50: .5,
|
||||
100: 1,
|
||||
)
|
||||
)
|
||||
);
|
||||
```
|
||||
|
||||
Output:
|
||||
|
||||
```css
|
||||
.o-0 {
|
||||
opacity: 0;
|
||||
}
|
||||
.o-25 {
|
||||
opacity: .25;
|
||||
}
|
||||
.o-75 {
|
||||
opacity: .75;
|
||||
}
|
||||
.o-100 {
|
||||
opacity: 1;
|
||||
}
|
||||
```
|
||||
|
||||
## Responsive utilities
|
||||
|
||||
With the `responsive` option, responsive utility classes can be generated:
|
||||
|
||||
```scss
|
||||
$utilities: (
|
||||
"opacity": (
|
||||
property: opacity,
|
||||
responsive: true,
|
||||
values: (
|
||||
0: 0,
|
||||
25: .25,
|
||||
50: .5,
|
||||
100: 1,
|
||||
)
|
||||
)
|
||||
);
|
||||
```
|
||||
|
||||
Output:
|
||||
|
||||
```css
|
||||
.opacity-0 {
|
||||
opacity: 0;
|
||||
}
|
||||
.opacity-25 {
|
||||
opacity: .25;
|
||||
}
|
||||
.opacity-75 {
|
||||
opacity: .75;
|
||||
}
|
||||
.opacity-100 {
|
||||
opacity: 1;
|
||||
}
|
||||
@media (min-width: 576px) {
|
||||
.opacity-sm-0 {
|
||||
opacity: 0;
|
||||
}
|
||||
.opacity-sm-25 {
|
||||
opacity: .25;
|
||||
}
|
||||
.opacity-sm-75 {
|
||||
opacity: .75;
|
||||
}
|
||||
.opacity-sm-100 {
|
||||
opacity: 1;
|
||||
}
|
||||
}
|
||||
@media (min-width: 768px) {
|
||||
.opacity-md-0 {
|
||||
opacity: 0;
|
||||
}
|
||||
.opacity-md-25 {
|
||||
opacity: .25;
|
||||
}
|
||||
.opacity-md-75 {
|
||||
opacity: .75;
|
||||
}
|
||||
.opacity-md-100 {
|
||||
opacity: 1;
|
||||
}
|
||||
}
|
||||
@media (min-width: 992px) {
|
||||
.opacity-lg-0 {
|
||||
opacity: 0;
|
||||
}
|
||||
.opacity-lg-25 {
|
||||
opacity: .25;
|
||||
}
|
||||
.opacity-lg-75 {
|
||||
opacity: .75;
|
||||
}
|
||||
.opacity-lg-100 {
|
||||
opacity: 1;
|
||||
}
|
||||
}
|
||||
@media (min-width: 1200px) {
|
||||
.opacity-xl-0 {
|
||||
opacity: 0;
|
||||
}
|
||||
.opacity-xl-25 {
|
||||
opacity: .25;
|
||||
}
|
||||
.opacity-xl-75 {
|
||||
opacity: .75;
|
||||
}
|
||||
.opacity-xl-100 {
|
||||
opacity: 1;
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
## Changing utilities
|
||||
|
||||
Overriding excising utilities is possible by using the same key. For example if you want more responsive overflow
|
||||
utility classes you can do this:
|
||||
|
||||
```scss
|
||||
$utilities: (
|
||||
"overflow": (
|
||||
responsive: true,
|
||||
property: overflow,
|
||||
values: visible hidden scroll auto,
|
||||
),
|
||||
);
|
||||
```
|
||||
|
||||
|
||||
## Print utilities
|
||||
|
||||
Enabling the `print` option will **also** generate utility classes for print.
|
||||
|
||||
```scss
|
||||
$utilities: (
|
||||
"opacity": (
|
||||
property: opacity,
|
||||
class: o,
|
||||
print: true,
|
||||
values: (
|
||||
0: 0,
|
||||
25: .25,
|
||||
50: .5,
|
||||
100: 1,
|
||||
)
|
||||
)
|
||||
);
|
||||
```
|
||||
|
||||
Output:
|
||||
|
||||
```css
|
||||
.o-0 {
|
||||
opacity: 0;
|
||||
}
|
||||
.o-25 {
|
||||
opacity: .25;
|
||||
}
|
||||
.o-75 {
|
||||
opacity: .75;
|
||||
}
|
||||
.o-100 {
|
||||
opacity: 1;
|
||||
}
|
||||
|
||||
@media print {
|
||||
.o-print-0 {
|
||||
opacity: 0;
|
||||
}
|
||||
.o-print-25 {
|
||||
opacity: .25;
|
||||
}
|
||||
.o-print-75 {
|
||||
opacity: .75;
|
||||
}
|
||||
.o-print-100 {
|
||||
opacity: 1;
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
## Removing utilities
|
||||
|
||||
Utilities can also be removed by changing the group key to `null`:
|
||||
|
||||
```scss
|
||||
$utilities: (
|
||||
"float": null,
|
||||
);
|
||||
```
|
||||
@@ -0,0 +1,69 @@
|
||||
---
|
||||
layout: docs
|
||||
title: Borders
|
||||
description: Use border utilities to quickly style the border and border-radius of an element. Great for images, buttons, or any other element.
|
||||
group: utilities
|
||||
toc: true
|
||||
---
|
||||
|
||||
## Border
|
||||
|
||||
Use border utilities to add or remove an element's borders. Choose from all borders or one at a time.
|
||||
|
||||
### Additive
|
||||
|
||||
{{< example class="bd-example-border-utils" >}}
|
||||
<span class="border"></span>
|
||||
<span class="border-top"></span>
|
||||
<span class="border-right"></span>
|
||||
<span class="border-bottom"></span>
|
||||
<span class="border-left"></span>
|
||||
{{< /example >}}
|
||||
|
||||
### Subtractive
|
||||
|
||||
{{< example class="bd-example-border-utils bd-example-border-utils-0" >}}
|
||||
<span class="border-0"></span>
|
||||
<span class="border-top-0"></span>
|
||||
<span class="border-right-0"></span>
|
||||
<span class="border-bottom-0"></span>
|
||||
<span class="border-left-0"></span>
|
||||
{{< /example >}}
|
||||
|
||||
## Border color
|
||||
|
||||
Change the border color using utilities built on our theme colors.
|
||||
|
||||
{{< example class="bd-example-border-utils" >}}
|
||||
{{< border.inline >}}
|
||||
{{- range (index $.Site.Data "theme-colors") }}
|
||||
<span class="border border-{{ .name }}"></span>
|
||||
{{- end -}}
|
||||
{{< /border.inline >}}
|
||||
<span class="border border-white"></span>
|
||||
{{< /example >}}
|
||||
|
||||
## Border-radius
|
||||
|
||||
Add classes to an element to easily round its corners.
|
||||
|
||||
{{< example class="bd-example-rounded-utils" >}}
|
||||
{{< placeholder width="75" height="75" class="rounded" title="Example rounded image" >}}
|
||||
{{< placeholder width="75" height="75" class="rounded-top" title="Example top rounded image" >}}
|
||||
{{< placeholder width="75" height="75" class="rounded-right" title="Example right rounded image" >}}
|
||||
{{< placeholder width="75" height="75" class="rounded-bottom" title="Example bottom rounded image" >}}
|
||||
{{< placeholder width="75" height="75" class="rounded-left" title="Example left rounded image" >}}
|
||||
{{< placeholder width="75" height="75" class="rounded-circle" title="Completely round image" >}}
|
||||
{{< placeholder width="150" height="75" class="rounded-pill" title="Rounded pill image" >}}
|
||||
{{< placeholder width="75" height="75" class="rounded-0" title="Example non-rounded image (overrides rounding applied elsewhere)" >}}
|
||||
{{< /example >}}
|
||||
|
||||
|
||||
## Sizes
|
||||
|
||||
Use `.rounded-lg` or `.rounded-sm` for larger or smaller border-radius.
|
||||
|
||||
{{< example class="bd-example-rounded-utils" >}}
|
||||
{{< placeholder width="75" height="75" class="rounded-sm" title="Example small rounded image" >}}
|
||||
{{< placeholder width="75" height="75" class="rounded-lg" title="Example large rounded image" >}}
|
||||
{{< /example >}}
|
||||
@@ -0,0 +1,60 @@
|
||||
---
|
||||
layout: docs
|
||||
title: Colors
|
||||
description: Convey meaning through color with a handful of color utility classes. Includes support for styling links with hover states, too.
|
||||
group: utilities
|
||||
toc: true
|
||||
---
|
||||
|
||||
## Color
|
||||
|
||||
Colorize text with color utilities. If you want to colorize links, you can use the [`.link-*` helper classes]({{< docsref "/helpers/colored-links" >}}) which have `:hover` and `:focus` states.
|
||||
|
||||
{{< example >}}
|
||||
{{< colors.inline >}}
|
||||
{{- range (index $.Site.Data "theme-colors") }}
|
||||
<p class="text-{{ .name }}{{ if eq .name "light" }} bg-dark{{ end }}">.text-{{ .name }}</p>
|
||||
{{- end -}}
|
||||
{{< /colors.inline >}}
|
||||
<p class="text-body">.text-body</p>
|
||||
<p class="text-muted">.text-muted</p>
|
||||
<p class="text-white bg-dark">.text-white</p>
|
||||
<p class="text-black-50">.text-black-50</p>
|
||||
<p class="text-white-50 bg-dark">.text-white-50</p>
|
||||
{{< /example >}}
|
||||
|
||||
## Background color
|
||||
|
||||
Similar to the contextual text color classes, easily set the background of an element to any contextual class. Background utilities **do not set `color`**, so in some cases you'll want to use `.text-*` utilities.
|
||||
|
||||
{{< example >}}
|
||||
{{< colors.inline >}}
|
||||
{{- range (index $.Site.Data "theme-colors") }}
|
||||
<div class="p-3 mb-2 bg-{{ .name }} {{ if or (eq .name "light") (eq .name "warning") }}text-dark{{ else }}text-white{{ end }}">.bg-{{ .name }}</div>
|
||||
{{- end -}}
|
||||
{{< /colors.inline >}}
|
||||
<div class="p-3 mb-2 bg-white text-dark">.bg-white</div>
|
||||
<div class="p-3 mb-2 bg-transparent text-dark">.bg-transparent</div>
|
||||
{{< /example >}}
|
||||
|
||||
## Background gradient
|
||||
|
||||
When `$enable-gradients` is set to `true` (default is `false`), you can use `.bg-gradient-` utility classes. [Learn about our Sass options]({{< docsref "/customize/sass" >}}) to enable these classes and more.
|
||||
|
||||
{{< markdown >}}
|
||||
{{< colors.inline >}}
|
||||
{{- range (index $.Site.Data "theme-colors") }}
|
||||
- `.bg-gradient-{{ .name }}`
|
||||
{{- end -}}
|
||||
{{< /colors.inline >}}
|
||||
{{< /markdown >}}
|
||||
|
||||
{{< callout info >}}
|
||||
#### Dealing with specificity
|
||||
|
||||
Sometimes contextual classes cannot be applied due to the specificity of another selector. In some cases, a sufficient workaround is to wrap your element's content in a `<div>` with the class.
|
||||
{{< /callout >}}
|
||||
|
||||
{{< callout info >}}
|
||||
{{< partial "callout-warning-color-assistive-technologies.md" >}}
|
||||
{{< /callout >}}
|
||||
@@ -0,0 +1,150 @@
|
||||
---
|
||||
layout: docs
|
||||
title: Display property
|
||||
description: Quickly and responsively toggle the display value of components and more with our display utilities. Includes support for some of the more common values, as well as some extras for controlling display when printing.
|
||||
group: utilities
|
||||
toc: true
|
||||
---
|
||||
|
||||
## How it works
|
||||
|
||||
Change the value of the [`display` property](https://developer.mozilla.org/en-US/docs/Web/CSS/display) with our responsive display utility classes. We purposely support only a subset of all possible values for `display`. Classes can be combined for various effects as you need.
|
||||
|
||||
## Notation
|
||||
|
||||
Display utility classes that apply to all [breakpoints]({{< docsref "/layout/breakpoints" >}}), from `xs` to `xxl`, have no breakpoint abbreviation in them. This is because those classes are applied from `min-width: 0;` and up, and thus are not bound by a media query. The remaining breakpoints, however, do include a breakpoint abbreviation.
|
||||
|
||||
As such, the classes are named using the format:
|
||||
|
||||
* `.d-{value}` for `xs`
|
||||
* `.d-{breakpoint}-{value}` for `sm`, `md`, `lg`, `xl`, and `xxl`.
|
||||
|
||||
Where *value* is one of:
|
||||
|
||||
* `none`
|
||||
* `inline`
|
||||
* `inline-block`
|
||||
* `block`
|
||||
* `table`
|
||||
* `table-cell`
|
||||
* `table-row`
|
||||
* `flex`
|
||||
* `inline-flex`
|
||||
|
||||
The display values can be altered by changing the `$displays` variable and recompiling the SCSS.
|
||||
|
||||
The media queries effect screen widths with the given breakpoint *or larger*. For example, `.d-lg-none` sets `display: none;` on both `lg`, `xl`, and `xxl` screens.
|
||||
|
||||
## Examples
|
||||
|
||||
{{< example >}}
|
||||
<div class="d-inline p-2 bg-primary text-white">d-inline</div>
|
||||
<div class="d-inline p-2 bg-dark text-white">d-inline</div>
|
||||
{{< /example >}}
|
||||
|
||||
{{< example >}}
|
||||
<span class="d-block p-2 bg-primary text-white">d-block</span>
|
||||
<span class="d-block p-2 bg-dark text-white">d-block</span>
|
||||
{{< /example >}}
|
||||
|
||||
## Hiding elements
|
||||
|
||||
For faster mobile-friendly development, use responsive display classes for showing and hiding elements by device. Avoid creating entirely different versions of the same site, instead hide elements responsively for each screen size.
|
||||
|
||||
To hide elements simply use the `.d-none` class or one of the `.d-{sm,md,lg,xl,xxl}-none` classes for any responsive screen variation.
|
||||
|
||||
To show an element only on a given interval of screen sizes you can combine one `.d-*-none` class with a `.d-*-*` class, for example `.d-none .d-md-block .d-xl-none .d-xxl-none` will hide the element for all screen sizes except on medium and large devices.
|
||||
|
||||
<table class="table">
|
||||
<thead>
|
||||
<tr>
|
||||
<th>Screen size</th>
|
||||
<th>Class</th>
|
||||
</tr>
|
||||
</thead>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td>Hidden on all</td>
|
||||
<td><code>.d-none</code></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>Hidden only on xs</td>
|
||||
<td><code>.d-none .d-sm-block</code></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>Hidden only on sm</td>
|
||||
<td><code>.d-sm-none .d-md-block</code></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>Hidden only on md</td>
|
||||
<td><code>.d-md-none .d-lg-block</code></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>Hidden only on lg</td>
|
||||
<td><code>.d-lg-none .d-xl-block</code></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>Hidden only on xl</td>
|
||||
<td><code>.d-xl-none</code></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>Hidden only on xxl</td>
|
||||
<td><code>.d-xxl-none</code></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>Visible on all</td>
|
||||
<td><code>.d-block</code></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>Visible only on xs</td>
|
||||
<td><code>.d-block .d-sm-none</code></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>Visible only on sm</td>
|
||||
<td><code>.d-none .d-sm-block .d-md-none</code></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>Visible only on md</td>
|
||||
<td><code>.d-none .d-md-block .d-lg-none</code></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>Visible only on lg</td>
|
||||
<td><code>.d-none .d-lg-block .d-xl-none</code></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>Visible only on xl</td>
|
||||
<td><code>.d-none .d-xl-block .d-xxl-none</code></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>Visible only on xxl</td>
|
||||
<td><code>.d-none .d-xxl-block</code></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
{{< example >}}
|
||||
<div class="d-lg-none">hide on lg and wider screens</div>
|
||||
<div class="d-none d-lg-block">hide on screens smaller than lg</div>
|
||||
{{< /example >}}
|
||||
|
||||
## Display in print
|
||||
|
||||
Change the `display` value of elements when printing with our print display utility classes. Includes support for the same `display` values as our responsive `.d-*` utilities.
|
||||
|
||||
- `.d-print-none`
|
||||
- `.d-print-inline`
|
||||
- `.d-print-inline-block`
|
||||
- `.d-print-block`
|
||||
- `.d-print-table`
|
||||
- `.d-print-table-row`
|
||||
- `.d-print-table-cell`
|
||||
- `.d-print-flex`
|
||||
- `.d-print-inline-flex`
|
||||
|
||||
The print and display classes can be combined.
|
||||
|
||||
{{< example >}}
|
||||
<div class="d-print-none">Screen Only (Hide on print only)</div>
|
||||
<div class="d-none d-print-block">Print Only (Hide on screen only)</div>
|
||||
<div class="d-none d-lg-block d-print-block">Hide up to large on screen, but always show on print</div>
|
||||
{{< /example >}}
|
||||
@@ -0,0 +1,622 @@
|
||||
---
|
||||
layout: docs
|
||||
title: Flex
|
||||
description: Quickly manage the layout, alignment, and sizing of grid columns, navigation, components, and more with a full suite of responsive flexbox utilities. For more complex implementations, custom CSS may be necessary.
|
||||
group: utilities
|
||||
toc: true
|
||||
---
|
||||
|
||||
## Enable flex behaviors
|
||||
|
||||
Apply `display` utilities to create a flexbox container and transform **direct children elements** into flex items. Flex containers and items are able to be modified further with additional flex properties.
|
||||
|
||||
{{< example >}}
|
||||
<div class="d-flex p-2 bd-highlight">I'm a flexbox container!</div>
|
||||
{{< /example >}}
|
||||
|
||||
{{< example >}}
|
||||
<div class="d-inline-flex p-2 bd-highlight">I'm an inline flexbox container!</div>
|
||||
{{< /example >}}
|
||||
|
||||
Responsive variations also exist for `.d-flex` and `.d-inline-flex`.
|
||||
|
||||
{{< markdown >}}
|
||||
{{< flex.inline >}}
|
||||
{{- range $.Site.Data.breakpoints }}
|
||||
- `.d{{ .abbr }}-flex`
|
||||
- `.d{{ .abbr }}-inline-flex`
|
||||
{{- end -}}
|
||||
{{< /flex.inline >}}
|
||||
{{< /markdown >}}
|
||||
|
||||
## Direction
|
||||
|
||||
Set the direction of flex items in a flex container with direction utilities. In most cases you can omit the horizontal class here as the browser default is `row`. However, you may encounter situations where you needed to explicitly set this value (like responsive layouts).
|
||||
|
||||
Use `.flex-row` to set a horizontal direction (the browser default), or `.flex-row-reverse` to start the horizontal direction from the opposite side.
|
||||
|
||||
{{< example >}}
|
||||
<div class="d-flex flex-row bd-highlight mb-3">
|
||||
<div class="p-2 bd-highlight">Flex item 1</div>
|
||||
<div class="p-2 bd-highlight">Flex item 2</div>
|
||||
<div class="p-2 bd-highlight">Flex item 3</div>
|
||||
</div>
|
||||
<div class="d-flex flex-row-reverse bd-highlight">
|
||||
<div class="p-2 bd-highlight">Flex item 1</div>
|
||||
<div class="p-2 bd-highlight">Flex item 2</div>
|
||||
<div class="p-2 bd-highlight">Flex item 3</div>
|
||||
</div>
|
||||
{{< /example >}}
|
||||
|
||||
Use `.flex-column` to set a vertical direction, or `.flex-column-reverse` to start the vertical direction from the opposite side.
|
||||
|
||||
{{< example >}}
|
||||
<div class="d-flex flex-column bd-highlight mb-3">
|
||||
<div class="p-2 bd-highlight">Flex item 1</div>
|
||||
<div class="p-2 bd-highlight">Flex item 2</div>
|
||||
<div class="p-2 bd-highlight">Flex item 3</div>
|
||||
</div>
|
||||
<div class="d-flex flex-column-reverse bd-highlight">
|
||||
<div class="p-2 bd-highlight">Flex item 1</div>
|
||||
<div class="p-2 bd-highlight">Flex item 2</div>
|
||||
<div class="p-2 bd-highlight">Flex item 3</div>
|
||||
</div>
|
||||
{{< /example >}}
|
||||
|
||||
Responsive variations also exist for `flex-direction`.
|
||||
|
||||
{{< markdown >}}
|
||||
{{< flex.inline >}}
|
||||
{{- range $.Site.Data.breakpoints }}
|
||||
- `.flex{{ .abbr }}-row`
|
||||
- `.flex{{ .abbr }}-row-reverse`
|
||||
- `.flex{{ .abbr }}-column`
|
||||
- `.flex{{ .abbr }}-column-reverse`
|
||||
{{- end -}}
|
||||
{{< /flex.inline >}}
|
||||
{{< /markdown >}}
|
||||
|
||||
## Justify content
|
||||
|
||||
Use `justify-content` utilities on flexbox containers to change the alignment of flex items on the main axis (the x-axis to start, y-axis if `flex-direction: column`). Choose from `start` (browser default), `end`, `center`, `between`, or `around`.
|
||||
|
||||
<div class="bd-example">
|
||||
<div class="d-flex justify-content-start bd-highlight mb-3">
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
</div>
|
||||
<div class="d-flex justify-content-end bd-highlight mb-3">
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
</div>
|
||||
<div class="d-flex justify-content-center bd-highlight mb-3">
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
</div>
|
||||
<div class="d-flex justify-content-between bd-highlight mb-3">
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
</div>
|
||||
<div class="d-flex justify-content-around bd-highlight">
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
{{< highlight html >}}
|
||||
<div class="d-flex justify-content-start">...</div>
|
||||
<div class="d-flex justify-content-end">...</div>
|
||||
<div class="d-flex justify-content-center">...</div>
|
||||
<div class="d-flex justify-content-between">...</div>
|
||||
<div class="d-flex justify-content-around">...</div>
|
||||
{{< /highlight >}}
|
||||
|
||||
Responsive variations also exist for `justify-content`.
|
||||
|
||||
{{< markdown >}}
|
||||
{{< flex.inline >}}
|
||||
{{- range $.Site.Data.breakpoints }}
|
||||
- `.justify-content{{ .abbr }}-start`
|
||||
- `.justify-content{{ .abbr }}-end`
|
||||
- `.justify-content{{ .abbr }}-center`
|
||||
- `.justify-content{{ .abbr }}-between`
|
||||
- `.justify-content{{ .abbr }}-around`
|
||||
{{- end -}}
|
||||
{{< /flex.inline >}}
|
||||
{{< /markdown >}}
|
||||
|
||||
## Align items
|
||||
|
||||
Use `align-items` utilities on flexbox containers to change the alignment of flex items on the cross axis (the y-axis to start, x-axis if `flex-direction: column`). Choose from `start`, `end`, `center`, `baseline`, or `stretch` (browser default).
|
||||
|
||||
<div class="bd-example">
|
||||
<div class="d-flex align-items-start bd-highlight mb-3" style="height: 100px">
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
</div>
|
||||
<div class="d-flex align-items-end bd-highlight mb-3" style="height: 100px">
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
</div>
|
||||
<div class="d-flex align-items-center bd-highlight mb-3" style="height: 100px">
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
</div>
|
||||
<div class="d-flex align-items-baseline bd-highlight mb-3" style="height: 100px">
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
</div>
|
||||
<div class="d-flex align-items-stretch bd-highlight" style="height: 100px">
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
{{< highlight html >}}
|
||||
<div class="d-flex align-items-start">...</div>
|
||||
<div class="d-flex align-items-end">...</div>
|
||||
<div class="d-flex align-items-center">...</div>
|
||||
<div class="d-flex align-items-baseline">...</div>
|
||||
<div class="d-flex align-items-stretch">...</div>
|
||||
{{< /highlight >}}
|
||||
|
||||
Responsive variations also exist for `align-items`.
|
||||
|
||||
{{< markdown >}}
|
||||
{{< flex.inline >}}
|
||||
{{- range $.Site.Data.breakpoints }}
|
||||
- `.align-items{{ .abbr }}-start`
|
||||
- `.align-items{{ .abbr }}-end`
|
||||
- `.align-items{{ .abbr }}-center`
|
||||
- `.align-items{{ .abbr }}-baseline`
|
||||
- `.align-items{{ .abbr }}-stretch`
|
||||
{{- end -}}
|
||||
{{< /flex.inline >}}
|
||||
{{< /markdown >}}
|
||||
|
||||
## Align self
|
||||
|
||||
Use `align-self` utilities on flexbox items to individually change their alignment on the cross axis (the y-axis to start, x-axis if `flex-direction: column`). Choose from the same options as `align-items`: `start`, `end`, `center`, `baseline`, or `stretch` (browser default).
|
||||
|
||||
<div class="bd-example">
|
||||
<div class="d-flex bd-highlight mb-3" style="height: 100px">
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="align-self-start p-2 bd-highlight">Aligned flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
</div>
|
||||
<div class="d-flex bd-highlight mb-3" style="height: 100px">
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="align-self-end p-2 bd-highlight">Aligned flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
</div>
|
||||
<div class="d-flex bd-highlight mb-3" style="height: 100px">
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="align-self-center p-2 bd-highlight">Aligned flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
</div>
|
||||
<div class="d-flex bd-highlight mb-3" style="height: 100px">
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="align-self-baseline p-2 bd-highlight">Aligned flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
</div>
|
||||
<div class="d-flex bd-highlight" style="height: 100px">
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="align-self-stretch p-2 bd-highlight">Aligned flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
{{< highlight html >}}
|
||||
<div class="align-self-start">Aligned flex item</div>
|
||||
<div class="align-self-end">Aligned flex item</div>
|
||||
<div class="align-self-center">Aligned flex item</div>
|
||||
<div class="align-self-baseline">Aligned flex item</div>
|
||||
<div class="align-self-stretch">Aligned flex item</div>
|
||||
{{< /highlight >}}
|
||||
|
||||
Responsive variations also exist for `align-self`.
|
||||
|
||||
{{< markdown >}}
|
||||
{{< flex.inline >}}
|
||||
{{- range $.Site.Data.breakpoints }}
|
||||
- `.align-self{{ .abbr }}-start`
|
||||
- `.align-self{{ .abbr }}-end`
|
||||
- `.align-self{{ .abbr }}-center`
|
||||
- `.align-self{{ .abbr }}-baseline`
|
||||
- `.align-self{{ .abbr }}-stretch`
|
||||
{{- end -}}
|
||||
{{< /flex.inline >}}
|
||||
{{< /markdown >}}
|
||||
|
||||
## Fill
|
||||
|
||||
Use the `.flex-fill` class on a series of sibling elements to force them into widths equal to their content (or equal widths if their content does not surpass their border-boxes) while taking up all available horizontal space.
|
||||
|
||||
{{< example >}}
|
||||
<div class="d-flex bd-highlight">
|
||||
<div class="p-2 flex-fill bd-highlight">Flex item with a lot of content</div>
|
||||
<div class="p-2 flex-fill bd-highlight">Flex item</div>
|
||||
<div class="p-2 flex-fill bd-highlight">Flex item</div>
|
||||
</div>
|
||||
{{< /example >}}
|
||||
|
||||
Responsive variations also exist for `flex-fill`.
|
||||
|
||||
{{< markdown >}}
|
||||
{{< flex.inline >}}
|
||||
{{- range $.Site.Data.breakpoints }}
|
||||
- `.flex{{ .abbr }}-fill`
|
||||
{{- end -}}
|
||||
{{< /flex.inline >}}
|
||||
{{< /markdown >}}
|
||||
|
||||
## Grow and shrink
|
||||
|
||||
Use `.flex-grow-*` utilities to toggle a flex item's ability to grow to fill available space. In the example below, the `.flex-grow-1` elements uses all available space it can, while allowing the remaining two flex items their necessary space.
|
||||
|
||||
{{< example >}}
|
||||
<div class="d-flex bd-highlight">
|
||||
<div class="p-2 flex-grow-1 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Third flex item</div>
|
||||
</div>
|
||||
{{< /example >}}
|
||||
|
||||
Use `.flex-shrink-*` utilities to toggle a flex item's ability to shrink if necessary. In the example below, the second flex item with `.flex-shrink-1` is forced to wrap its contents to a new line, "shrinking" to allow more space for the previous flex item with `.w-100`.
|
||||
|
||||
{{< example >}}
|
||||
<div class="d-flex bd-highlight">
|
||||
<div class="p-2 w-100 bd-highlight">Flex item</div>
|
||||
<div class="p-2 flex-shrink-1 bd-highlight">Flex item</div>
|
||||
</div>
|
||||
{{< /example >}}
|
||||
|
||||
Responsive variations also exist for `flex-grow` and `flex-shrink`.
|
||||
|
||||
{{< markdown >}}
|
||||
{{< flex.inline >}}
|
||||
{{- range $.Site.Data.breakpoints }}
|
||||
- `.flex{{ .abbr }}-{grow|shrink}-0`
|
||||
- `.flex{{ .abbr }}-{grow|shrink}-1`
|
||||
{{- end -}}
|
||||
{{< /flex.inline >}}
|
||||
{{< /markdown >}}
|
||||
|
||||
## Auto margins
|
||||
|
||||
Flexbox can do some pretty awesome things when you mix flex alignments with auto margins. Shown below are three examples of controlling flex items via auto margins: default (no auto margin), pushing two items to the right (`.mr-auto`), and pushing two items to the left (`.ml-auto`).
|
||||
|
||||
{{< example >}}
|
||||
<div class="d-flex bd-highlight mb-3">
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
</div>
|
||||
|
||||
<div class="d-flex bd-highlight mb-3">
|
||||
<div class="mr-auto p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
</div>
|
||||
|
||||
<div class="d-flex bd-highlight mb-3">
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="ml-auto p-2 bd-highlight">Flex item</div>
|
||||
</div>
|
||||
{{< /example >}}
|
||||
|
||||
### With align-items
|
||||
|
||||
Vertically move one flex item to the top or bottom of a container by mixing `align-items`, `flex-direction: column`, and `margin-top: auto` or `margin-bottom: auto`.
|
||||
|
||||
{{< example >}}
|
||||
<div class="d-flex align-items-start flex-column bd-highlight mb-3" style="height: 200px;">
|
||||
<div class="mb-auto p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
</div>
|
||||
|
||||
<div class="d-flex align-items-end flex-column bd-highlight mb-3" style="height: 200px;">
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="mt-auto p-2 bd-highlight">Flex item</div>
|
||||
</div>
|
||||
{{< /example >}}
|
||||
|
||||
## Wrap
|
||||
|
||||
Change how flex items wrap in a flex container. Choose from no wrapping at all (the browser default) with `.flex-nowrap`, wrapping with `.flex-wrap`, or reverse wrapping with `.flex-wrap-reverse`.
|
||||
|
||||
<div class="bd-example">
|
||||
<div class="d-flex flex-nowrap bd-highlight" style="width: 8rem;">
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
{{< highlight html >}}
|
||||
<div class="d-flex flex-nowrap">
|
||||
...
|
||||
</div>
|
||||
{{< /highlight >}}
|
||||
|
||||
<div class="bd-example">
|
||||
<div class="d-flex flex-wrap bd-highlight">
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
{{< highlight html >}}
|
||||
<div class="d-flex flex-wrap">
|
||||
...
|
||||
</div>
|
||||
{{< /highlight >}}
|
||||
|
||||
<div class="bd-example">
|
||||
<div class="d-flex flex-wrap-reverse bd-highlight">
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
{{< highlight html >}}
|
||||
<div class="d-flex flex-wrap-reverse">
|
||||
...
|
||||
</div>
|
||||
{{< /highlight >}}
|
||||
|
||||
|
||||
Responsive variations also exist for `flex-wrap`.
|
||||
|
||||
{{< markdown >}}
|
||||
{{< flex.inline >}}
|
||||
{{- range $.Site.Data.breakpoints }}
|
||||
- `.flex{{ .abbr }}-nowrap`
|
||||
- `.flex{{ .abbr }}-wrap`
|
||||
- `.flex{{ .abbr }}-wrap-reverse`
|
||||
{{- end -}}
|
||||
{{< /flex.inline >}}
|
||||
{{< /markdown >}}
|
||||
|
||||
## Order
|
||||
|
||||
Change the _visual_ order of specific flex items with a handful of `order` utilities. We only provide options for making an item first or last, as well as a reset to use the DOM order. As `order` takes any integer value from 0 to 5, add custom CSS for any additional values needed.
|
||||
|
||||
{{< example >}}
|
||||
<div class="d-flex flex-nowrap bd-highlight">
|
||||
<div class="order-3 p-2 bd-highlight">First flex item</div>
|
||||
<div class="order-2 p-2 bd-highlight">Second flex item</div>
|
||||
<div class="order-1 p-2 bd-highlight">Third flex item</div>
|
||||
</div>
|
||||
{{< /example >}}
|
||||
|
||||
Responsive variations also exist for `order`.
|
||||
|
||||
{{< markdown >}}
|
||||
{{< flex.inline >}}
|
||||
{{- range $bp := $.Site.Data.breakpoints -}}
|
||||
{{- range (seq 0 5) }}
|
||||
- `.order{{ $bp.abbr }}-{{ . }}`
|
||||
{{- end -}}
|
||||
{{- end -}}
|
||||
{{< /flex.inline >}}
|
||||
{{< /markdown >}}
|
||||
|
||||
Additionally there are also responsive `.order-first` and `.order-last` classes that change the `order` of an element by applying `order: -1` and `order: 6`, respectively.
|
||||
|
||||
{{< markdown >}}
|
||||
{{< flex.inline >}}
|
||||
{{- range $bp := $.Site.Data.breakpoints -}}
|
||||
{{- range (slice "first" "last") }}
|
||||
- `.order{{ $bp.abbr }}-{{ . }}`
|
||||
{{- end -}}
|
||||
{{- end -}}
|
||||
{{< /flex.inline >}}
|
||||
{{< /markdown >}}
|
||||
|
||||
## Align content
|
||||
|
||||
Use `align-content` utilities on flexbox containers to align flex items *together* on the cross axis. Choose from `start` (browser default), `end`, `center`, `between`, `around`, or `stretch`. To demonstrate these utilities, we've enforced `flex-wrap: wrap` and increased the number of flex items.
|
||||
|
||||
**Heads up!** This property has no effect on single rows of flex items.
|
||||
|
||||
<div class="bd-example">
|
||||
<div class="d-flex align-content-start flex-wrap bd-highlight mb-3" style="height: 200px">
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
{{< highlight html >}}
|
||||
<div class="d-flex align-content-start flex-wrap">
|
||||
...
|
||||
</div>
|
||||
{{< /highlight >}}
|
||||
|
||||
<div class="bd-example">
|
||||
<div class="d-flex align-content-end flex-wrap bd-highlight mb-3" style="height: 200px">
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
{{< highlight html >}}
|
||||
<div class="d-flex align-content-end flex-wrap">...</div>
|
||||
{{< /highlight >}}
|
||||
|
||||
<div class="bd-example">
|
||||
<div class="d-flex align-content-center flex-wrap bd-highlight mb-3" style="height: 200px">
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
{{< highlight html >}}
|
||||
<div class="d-flex align-content-center flex-wrap">...</div>
|
||||
{{< /highlight >}}
|
||||
|
||||
<div class="bd-example">
|
||||
<div class="d-flex align-content-between flex-wrap bd-highlight mb-3" style="height: 200px">
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
{{< highlight html >}}
|
||||
<div class="d-flex align-content-between flex-wrap">...</div>
|
||||
{{< /highlight >}}
|
||||
|
||||
<div class="bd-example">
|
||||
<div class="d-flex align-content-around flex-wrap bd-highlight mb-3" style="height: 200px">
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
{{< highlight html >}}
|
||||
<div class="d-flex align-content-around flex-wrap">...</div>
|
||||
{{< /highlight >}}
|
||||
|
||||
<div class="bd-example">
|
||||
<div class="d-flex align-content-stretch flex-wrap bd-highlight mb-3" style="height: 200px">
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
<div class="p-2 bd-highlight">Flex item</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
{{< highlight html >}}
|
||||
<div class="d-flex align-content-stretch flex-wrap">...</div>
|
||||
{{< /highlight >}}
|
||||
|
||||
Responsive variations also exist for `align-content`.
|
||||
|
||||
{{< markdown >}}
|
||||
{{< flex.inline >}}
|
||||
{{- range $.Site.Data.breakpoints }}
|
||||
- `.align-content{{ .abbr }}-start`
|
||||
- `.align-content{{ .abbr }}-end`
|
||||
- `.align-content{{ .abbr }}-center`
|
||||
- `.align-content{{ .abbr }}-around`
|
||||
- `.align-content{{ .abbr }}-stretch`
|
||||
{{- end -}}
|
||||
{{< /flex.inline >}}
|
||||
{{< /markdown >}}
|
||||
@@ -0,0 +1,40 @@
|
||||
---
|
||||
layout: docs
|
||||
title: Float
|
||||
description: Toggle floats on any element, across any breakpoint, using our responsive float utilities.
|
||||
group: utilities
|
||||
toc: true
|
||||
---
|
||||
|
||||
## Overview
|
||||
|
||||
These utility classes float an element to the left or right, or disable floating, based on the current viewport size using the [CSS `float` property](https://developer.mozilla.org/en-US/docs/Web/CSS/float). `!important` is included to avoid specificity issues. These use the same viewport breakpoints as our grid system. Please be aware float utilities have no effect on flex items.
|
||||
|
||||
{{< example >}}
|
||||
<div class="float-left">Float left on all viewport sizes</div><br>
|
||||
<div class="float-right">Float right on all viewport sizes</div><br>
|
||||
<div class="float-none">Don't float on all viewport sizes</div>
|
||||
{{< /example >}}
|
||||
|
||||
## Responsive
|
||||
|
||||
Responsive variations also exist for each `float` value.
|
||||
|
||||
{{< example >}}
|
||||
<div class="float-sm-left">Float left on viewports sized SM (small) or wider</div><br>
|
||||
<div class="float-md-left">Float left on viewports sized MD (medium) or wider</div><br>
|
||||
<div class="float-lg-left">Float left on viewports sized LG (large) or wider</div><br>
|
||||
<div class="float-xl-left">Float left on viewports sized XL (extra-large) or wider</div><br>
|
||||
{{< /example >}}
|
||||
|
||||
Here are all the support classes:
|
||||
|
||||
{{< markdown >}}
|
||||
{{< float.inline >}}
|
||||
{{- range $.Site.Data.breakpoints }}
|
||||
- `.float{{ .abbr }}-left`
|
||||
- `.float{{ .abbr }}-right`
|
||||
- `.float{{ .abbr }}-none`
|
||||
{{- end -}}
|
||||
{{< /float.inline >}}
|
||||
{{< /markdown >}}
|
||||
@@ -0,0 +1,27 @@
|
||||
---
|
||||
layout: docs
|
||||
title: Interactions
|
||||
description: Utility classes that change how users interact with contents of a website.
|
||||
group: utilities
|
||||
toc: false
|
||||
---
|
||||
|
||||
## Text selection
|
||||
|
||||
Change the way in which the content is selected when the user interacts with it.
|
||||
|
||||
{{< example >}}
|
||||
<p class="user-select-all">This paragraph will be entirely selected when clicked by the user.</p>
|
||||
<p class="user-select-auto">This paragraph has default select behavior.</p>
|
||||
<p class="user-select-none">This paragraph will not be selectable when clicked by the user.</p>
|
||||
{{< /example >}}
|
||||
|
||||
## Pointer events
|
||||
|
||||
Bootstrap provides `pe-none` and `pe-auto` classes to prevent or add element interactions.
|
||||
|
||||
{{< example >}}
|
||||
<p><a href="#" class="pe-none">This link</a> can not be clicked.</p>
|
||||
<p><a href="#" class="pe-auto">This link</a> can be clicked (this is default behaviour).</p>
|
||||
<p class="pe-none"><a href="#">This link</a> can not be clicked because the <code>pointer-events</code> property is inherited from its parent. However, <a href="#" class="pe-auto">this link</a> has a <code>pe-auto</code> class and can be clicked.</p>
|
||||
{{< /example >}}
|
||||
@@ -0,0 +1,24 @@
|
||||
---
|
||||
layout: docs
|
||||
title: Overflow
|
||||
description: Use these shorthand utilities for quickly configuring how content overflows an element.
|
||||
group: utilities
|
||||
---
|
||||
|
||||
Barebones `overflow` functionality is provided for two values by default, and they are not responsive.
|
||||
|
||||
<div class="bd-example d-md-flex">
|
||||
<div class="overflow-auto p-3 mb-3 mb-md-0 mr-md-3 bg-light" style="max-width: 260px; max-height: 100px;">
|
||||
This is an example of using <code>.overflow-auto</code> on an element with set width and height dimensions. By design, this content will vertically scroll.
|
||||
</div>
|
||||
<div class="overflow-hidden p-3 bg-light" style="max-width: 260px; max-height: 100px;">
|
||||
This is an example of using <code>.overflow-hidden</code> on an element with set width and height dimensions.
|
||||
</div>
|
||||
</div>
|
||||
|
||||
{{< highlight html >}}
|
||||
<div class="overflow-auto">...</div>
|
||||
<div class="overflow-hidden">...</div>
|
||||
{{< /highlight >}}
|
||||
|
||||
Using Sass variables, you may customize the overflow utilities by changing the `$overflows` variable in `_variables.scss`.
|
||||
@@ -0,0 +1,19 @@
|
||||
---
|
||||
layout: docs
|
||||
title: Position
|
||||
description: Use these shorthand utilities for quickly configuring the position of an element.
|
||||
group: utilities
|
||||
toc: true
|
||||
---
|
||||
|
||||
## Common values
|
||||
|
||||
Quick positioning classes are available, though they are not responsive.
|
||||
|
||||
{{< highlight html >}}
|
||||
<div class="position-static">...</div>
|
||||
<div class="position-relative">...</div>
|
||||
<div class="position-absolute">...</div>
|
||||
<div class="position-fixed">...</div>
|
||||
<div class="position-sticky">...</div>
|
||||
{{< /highlight >}}
|
||||
@@ -0,0 +1,17 @@
|
||||
---
|
||||
layout: docs
|
||||
title: Shadows
|
||||
description: Add or remove shadows to elements with box-shadow utilities.
|
||||
group: utilities
|
||||
---
|
||||
|
||||
## Examples
|
||||
|
||||
While shadows on components are disabled by default in Bootstrap and can be enabled via `$enable-shadows`, you can also quickly add or remove a shadow with our `box-shadow` utility classes. Includes support for `.shadow-none` and three default sizes (which have associated variables to match).
|
||||
|
||||
{{< example >}}
|
||||
<div class="shadow-none p-3 mb-5 bg-light rounded">No shadow</div>
|
||||
<div class="shadow-sm p-3 mb-5 bg-white rounded">Small shadow</div>
|
||||
<div class="shadow p-3 mb-5 bg-white rounded">Regular shadow</div>
|
||||
<div class="shadow-lg p-3 mb-5 bg-white rounded">Larger shadow</div>
|
||||
{{< /example >}}
|
||||
@@ -0,0 +1,52 @@
|
||||
---
|
||||
layout: docs
|
||||
title: Sizing
|
||||
description: Easily make an element as wide or as tall with our width and height utilities.
|
||||
group: utilities
|
||||
toc: true
|
||||
---
|
||||
|
||||
## Relative to the parent
|
||||
|
||||
Width and height utilities are generated from the utility API in `_utilities.scss`. Includes support for `25%`, `50%`, `75%`, `100%`, and `auto` by default. Modify those values as you need to generate different utilities here.
|
||||
|
||||
{{< example >}}
|
||||
<div class="w-25 p-3" style="background-color: #eee;">Width 25%</div>
|
||||
<div class="w-50 p-3" style="background-color: #eee;">Width 50%</div>
|
||||
<div class="w-75 p-3" style="background-color: #eee;">Width 75%</div>
|
||||
<div class="w-100 p-3" style="background-color: #eee;">Width 100%</div>
|
||||
<div class="w-auto p-3" style="background-color: #eee;">Width auto</div>
|
||||
{{< /example >}}
|
||||
|
||||
{{< example >}}
|
||||
<div style="height: 100px; background-color: rgba(255,0,0,0.1);">
|
||||
<div class="h-25 d-inline-block" style="width: 120px; background-color: rgba(0,0,255,.1)">Height 25%</div>
|
||||
<div class="h-50 d-inline-block" style="width: 120px; background-color: rgba(0,0,255,.1)">Height 50%</div>
|
||||
<div class="h-75 d-inline-block" style="width: 120px; background-color: rgba(0,0,255,.1)">Height 75%</div>
|
||||
<div class="h-100 d-inline-block" style="width: 120px; background-color: rgba(0,0,255,.1)">Height 100%</div>
|
||||
<div class="h-auto d-inline-block" style="width: 120px; background-color: rgba(0,0,255,.1)">Height auto</div>
|
||||
</div>
|
||||
{{< /example >}}
|
||||
|
||||
You can also use `max-width: 100%;` and `max-height: 100%;` utilities as needed.
|
||||
|
||||
{{< example >}}
|
||||
{{< placeholder width="100%" height="100" class="mw-100" text="Max-width 100%" >}}
|
||||
{{< /example >}}
|
||||
|
||||
{{< example >}}
|
||||
<div style="height: 100px; background-color: rgba(255,0,0,.1);">
|
||||
<div class="mh-100" style="width: 100px; height: 200px; background-color: rgba(0,0,255,.1);">Max-height 100%</div>
|
||||
</div>
|
||||
{{< /example >}}
|
||||
|
||||
## Relative to the viewport
|
||||
|
||||
You can also use utilities to set the width and height relative to the viewport.
|
||||
|
||||
{{< highlight html >}}
|
||||
<div class="min-vw-100">Min-width 100vw</div>
|
||||
<div class="min-vh-100">Min-height 100vh</div>
|
||||
<div class="vw-100">Width 100vw</div>
|
||||
<div class="vh-100">Height 100vh</div>
|
||||
{{< /highlight >}}
|
||||
@@ -0,0 +1,95 @@
|
||||
---
|
||||
layout: docs
|
||||
title: Spacing
|
||||
description: Bootstrap includes a wide range of shorthand responsive margin and padding utility classes to modify an element's appearance.
|
||||
group: utilities
|
||||
toc: true
|
||||
---
|
||||
|
||||
## How it works
|
||||
|
||||
Assign responsive-friendly `margin` or `padding` values to an element or a subset of its sides with shorthand classes. Includes support for individual properties, all properties, and vertical and horizontal properties. Classes are built from a default Sass map ranging from `.25rem` to `3rem`.
|
||||
|
||||
## Notation
|
||||
|
||||
Spacing utilities that apply to all breakpoints, from `xs` to `xxl`, have no breakpoint abbreviation in them. This is because those classes are applied from `min-width: 0` and up, and thus are not bound by a media query. The remaining breakpoints, however, do include a breakpoint abbreviation.
|
||||
|
||||
The classes are named using the format `{property}{sides}-{size}` for `xs` and `{property}{sides}-{breakpoint}-{size}` for `sm`, `md`, `lg`, `xl`, and `xxl`.
|
||||
|
||||
Where *property* is one of:
|
||||
|
||||
* `m` - for classes that set `margin`
|
||||
* `p` - for classes that set `padding`
|
||||
|
||||
Where *sides* is one of:
|
||||
|
||||
* `t` - for classes that set `margin-top` or `padding-top`
|
||||
* `b` - for classes that set `margin-bottom` or `padding-bottom`
|
||||
* `l` - for classes that set `margin-left` or `padding-left`
|
||||
* `r` - for classes that set `margin-right` or `padding-right`
|
||||
* `x` - for classes that set both `*-left` and `*-right`
|
||||
* `y` - for classes that set both `*-top` and `*-bottom`
|
||||
* blank - for classes that set a `margin` or `padding` on all 4 sides of the element
|
||||
|
||||
Where *size* is one of:
|
||||
|
||||
* `0` - for classes that eliminate the `margin` or `padding` by setting it to `0`
|
||||
* `1` - (by default) for classes that set the `margin` or `padding` to `$spacer * .25`
|
||||
* `2` - (by default) for classes that set the `margin` or `padding` to `$spacer * .5`
|
||||
* `3` - (by default) for classes that set the `margin` or `padding` to `$spacer`
|
||||
* `4` - (by default) for classes that set the `margin` or `padding` to `$spacer * 1.5`
|
||||
* `5` - (by default) for classes that set the `margin` or `padding` to `$spacer * 3`
|
||||
* `auto` - for classes that set the `margin` to auto
|
||||
|
||||
(You can add more sizes by adding entries to the `$spacers` Sass map variable.)
|
||||
|
||||
## Examples
|
||||
|
||||
Here are some representative examples of these classes:
|
||||
|
||||
{{< highlight scss >}}
|
||||
.mt-0 {
|
||||
margin-top: 0 !important;
|
||||
}
|
||||
|
||||
.ml-1 {
|
||||
margin-left: ($spacer * .25) !important;
|
||||
}
|
||||
|
||||
.px-2 {
|
||||
padding-left: ($spacer * .5) !important;
|
||||
padding-right: ($spacer * .5) !important;
|
||||
}
|
||||
|
||||
.p-3 {
|
||||
padding: $spacer !important;
|
||||
}
|
||||
{{< /highlight >}}
|
||||
|
||||
### Horizontal centering
|
||||
|
||||
Additionally, Bootstrap also includes an `.mx-auto` class for horizontally centering fixed-width block level content—that is, content that has `display: block` and a `width` set—by setting the horizontal margins to `auto`.
|
||||
|
||||
<div class="bd-example">
|
||||
<div class="mx-auto" style="width: 200px; background-color: rgba(86,61,124,.15);">
|
||||
Centered element
|
||||
</div>
|
||||
</div>
|
||||
|
||||
{{< highlight html >}}
|
||||
<div class="mx-auto" style="width: 200px;">
|
||||
Centered element
|
||||
</div>
|
||||
{{< /highlight >}}
|
||||
|
||||
### Negative margin
|
||||
|
||||
In CSS, `margin` properties can utilize negative values (`padding` cannot). These negative margins are **disabled by default**, but can be enabled in Sass by setting `$enable-negative-margins: true`.
|
||||
|
||||
The syntax is nearly the same as the default, positive margin utilities, but with the addition of `n` before the requested size. Here's an example class that's the opposite of `.mt-1`:
|
||||
|
||||
{{< highlight scss >}}
|
||||
.mt-n1 {
|
||||
margin-top: -0.25rem !important;
|
||||
}
|
||||
{{< /highlight >}}
|
||||
@@ -0,0 +1,117 @@
|
||||
---
|
||||
layout: docs
|
||||
title: Text
|
||||
description: Documentation and examples for common text utilities to control alignment, wrapping, weight, and more.
|
||||
group: utilities
|
||||
toc: true
|
||||
---
|
||||
|
||||
## Text alignment
|
||||
|
||||
Easily realign text to components with text alignment classes. For left, right, and center alignment, responsive classes are available that use the same viewport width breakpoints as the grid system.
|
||||
|
||||
{{< example >}}
|
||||
<p class="text-left">Left aligned text on all viewport sizes.</p>
|
||||
<p class="text-center">Center aligned text on all viewport sizes.</p>
|
||||
<p class="text-right">Right aligned text on all viewport sizes.</p>
|
||||
|
||||
<p class="text-sm-left">Left aligned text on viewports sized SM (small) or wider.</p>
|
||||
<p class="text-md-left">Left aligned text on viewports sized MD (medium) or wider.</p>
|
||||
<p class="text-lg-left">Left aligned text on viewports sized LG (large) or wider.</p>
|
||||
<p class="text-xl-left">Left aligned text on viewports sized XL (extra-large) or wider.</p>
|
||||
{{< /example >}}
|
||||
|
||||
{{< callout info >}}
|
||||
Note that we don't provide utility classes for justified text. While, aesthetically, justified text might look more appealing, it does make word-spacing more random and therefore harder to read.
|
||||
{{< /callout >}}
|
||||
|
||||
## Text wrapping and overflow
|
||||
|
||||
Wrap text with a `.text-wrap` class.
|
||||
|
||||
{{< example >}}
|
||||
<div class="badge bg-primary text-wrap" style="width: 6rem;">
|
||||
This text should wrap.
|
||||
</div>
|
||||
{{< /example >}}
|
||||
|
||||
Prevent text from wrapping with a `.text-nowrap` class.
|
||||
|
||||
{{< example >}}
|
||||
<div class="text-nowrap bd-highlight" style="width: 8rem;">
|
||||
This text should overflow the parent.
|
||||
</div>
|
||||
{{< /example >}}
|
||||
|
||||
## Word break
|
||||
|
||||
Prevent long strings of text from breaking your components' layout by using `.text-break` to set `word-wrap: break-word`. We use `word-wrap` instead of the more common `overflow-wrap` for wider browser support.
|
||||
|
||||
{{< example >}}
|
||||
<p class="text-break">mmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmm</p>
|
||||
{{< /example >}}
|
||||
|
||||
## Text transform
|
||||
|
||||
Transform text in components with text capitalization classes.
|
||||
|
||||
{{< example >}}
|
||||
<p class="text-lowercase">Lowercased text.</p>
|
||||
<p class="text-uppercase">Uppercased text.</p>
|
||||
<p class="text-capitalize">CapiTaliZed text.</p>
|
||||
{{< /example >}}
|
||||
|
||||
Note how `.text-capitalize` only changes the first letter of each word, leaving the case of any other letters unaffected.
|
||||
|
||||
## Font weight and italics
|
||||
|
||||
Quickly change the weight (boldness) of text or italicize text.
|
||||
|
||||
{{< example >}}
|
||||
<p class="font-weight-bold">Bold text.</p>
|
||||
<p class="font-weight-bolder">Bolder weight text (relative to the parent element).</p>
|
||||
<p class="font-weight-normal">Normal weight text.</p>
|
||||
<p class="font-weight-light">Light weight text.</p>
|
||||
<p class="font-weight-lighter">Lighter weight text (relative to the parent element).</p>
|
||||
<p class="font-italic">Italic text.</p>
|
||||
<p class="font-normal">Text without font style</p>
|
||||
{{< /example >}}
|
||||
|
||||
## Line height
|
||||
|
||||
Change the line height with `.lh-*` utilities.
|
||||
|
||||
{{< example >}}
|
||||
<p class="lh-1">Vivamus sagittis lacus vel augue laoreet rutrum faucibus dolor auctor. Donec sed odio dui. Cras mattis pannenkoek purus sit amet fermentum. Praesent commodo cursus magna, vel scelerisque nisl consectetur et. Nullam id dolor id nibh ultricies vehicula ut id elit. Cras mattis consectetur purus sit amet fermentum.</p>
|
||||
<p class="lh-sm">Vivamus sagittis lacus vel augue laoreet rutrum faucibus dolor auctor. Donec sed odio dui. Cras mattis pannenkoek purus sit amet fermentum. Praesent commodo cursus magna, vel scelerisque nisl consectetur et. Nullam id dolor id nibh ultricies vehicula ut id elit. Cras mattis consectetur purus sit amet fermentum.</p>
|
||||
<p class="lh-base">Vivamus sagittis lacus vel augue laoreet rutrum faucibus dolor auctor. Donec sed odio dui. Cras mattis pannenkoek purus sit amet fermentum. Praesent commodo cursus magna, vel scelerisque nisl consectetur et. Nullam id dolor id nibh ultricies vehicula ut id elit. Cras mattis consectetur purus sit amet fermentum.</p>
|
||||
<p class="lh-lg">Vivamus sagittis lacus vel augue laoreet rutrum faucibus dolor auctor. Donec sed odio dui. Cras mattis pannenkoek purus sit amet fermentum. Praesent commodo cursus magna, vel scelerisque nisl consectetur et. Nullam id dolor id nibh ultricies vehicula ut id elit. Cras mattis consectetur purus sit amet fermentum.</p>
|
||||
{{< /example >}}
|
||||
|
||||
## Monospace
|
||||
|
||||
Change a selection to our monospace font stack with `.font-monospace`.
|
||||
|
||||
{{< example >}}
|
||||
<p class="font-monospace">This is in monospace</p>
|
||||
{{< /example >}}
|
||||
|
||||
## Reset color
|
||||
|
||||
Reset a text or link's color with `.text-reset`, so that it inherits the color from its parent.
|
||||
|
||||
{{< example >}}
|
||||
<p class="text-muted">
|
||||
Muted text with a <a href="#" class="text-reset">reset link</a>.
|
||||
</p>
|
||||
{{< /example >}}
|
||||
|
||||
## Text decoration
|
||||
|
||||
Decorate text in components with text decoration classes.
|
||||
|
||||
{{< example >}}
|
||||
<p class="text-decoration-underline">This text has a line underneath it.</p>
|
||||
<p class="text-decoration-line-through">This text has a line going through it.</p>
|
||||
<a href="#" class="text-decoration-none">This link has its text decoration removed</a>
|
||||
{{< /example >}}
|
||||
@@ -0,0 +1,40 @@
|
||||
---
|
||||
layout: docs
|
||||
title: Vertical alignment
|
||||
description: Easily change the vertical alignment of inline, inline-block, inline-table, and table cell elements.
|
||||
group: utilities
|
||||
---
|
||||
|
||||
Change the alignment of elements with the [`vertical-alignment`](https://developer.mozilla.org/en-US/docs/Web/CSS/vertical-align) utilities. Please note that vertical-align only affects inline, inline-block, inline-table, and table cell elements.
|
||||
|
||||
Choose from `.align-baseline`, `.align-top`, `.align-middle`, `.align-bottom`, `.align-text-bottom`, and `.align-text-top` as needed.
|
||||
|
||||
To vertically center non-inline content (like `<div>`s and more), use our [flex box utilities]({{< docsref "/utilities/flex#auto-margins" >}}).
|
||||
|
||||
With inline elements:
|
||||
|
||||
{{< example >}}
|
||||
<span class="align-baseline">baseline</span>
|
||||
<span class="align-top">top</span>
|
||||
<span class="align-middle">middle</span>
|
||||
<span class="align-bottom">bottom</span>
|
||||
<span class="align-text-top">text-top</span>
|
||||
<span class="align-text-bottom">text-bottom</span>
|
||||
{{< /example >}}
|
||||
|
||||
With table cells:
|
||||
|
||||
{{< example >}}
|
||||
<table style="height: 100px;">
|
||||
<tbody>
|
||||
<tr>
|
||||
<td class="align-baseline">baseline</td>
|
||||
<td class="align-top">top</td>
|
||||
<td class="align-middle">middle</td>
|
||||
<td class="align-bottom">bottom</td>
|
||||
<td class="align-text-top">text-top</td>
|
||||
<td class="align-text-bottom">text-bottom</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
{{< /example >}}
|
||||
@@ -0,0 +1,25 @@
|
||||
---
|
||||
layout: docs
|
||||
title: Visibility
|
||||
description: Control the visibility, without modifying the display, of elements with visibility utilities.
|
||||
group: utilities
|
||||
---
|
||||
|
||||
Set the `visibility` of elements with our visibility utilities. These utility classes do not modify the `display` value at all and do not affect layout – `.invisible` elements still take up space in the page. Content will be hidden both visually and for assistive technology/screen reader users.
|
||||
|
||||
Apply `.visible` or `.invisible` as needed.
|
||||
|
||||
{{< highlight html >}}
|
||||
<div class="visible">...</div>
|
||||
<div class="invisible">...</div>
|
||||
{{< /highlight >}}
|
||||
|
||||
{{< highlight scss >}}
|
||||
// Class
|
||||
.visible {
|
||||
visibility: visible !important;
|
||||
}
|
||||
.invisible {
|
||||
visibility: hidden !important;
|
||||
}
|
||||
{{< /highlight >}}
|
||||
Reference in New Issue
Block a user