diff options
Diffstat (limited to 'vendor/twbs/bootstrap/site/docs/4.4/utilities')
19 files changed, 1587 insertions, 0 deletions
diff --git a/vendor/twbs/bootstrap/site/docs/4.4/utilities/borders.md b/vendor/twbs/bootstrap/site/docs/4.4/utilities/borders.md new file mode 100644 index 000000000..405e75a2e --- /dev/null +++ b/vendor/twbs/bootstrap/site/docs/4.4/utilities/borders.md @@ -0,0 +1,91 @@ +--- +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 +redirect_from: "/docs/4.4/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 + +<div class="bd-example-border-utils"> +{% capture example %} +<span class="border"></span> +<span class="border-top"></span> +<span class="border-right"></span> +<span class="border-bottom"></span> +<span class="border-left"></span> +{% endcapture %} +{% include example.html content=example %} +</div> + +### Subtractive + +<div class="bd-example-border-utils bd-example-border-utils-0"> +{% capture example %} +<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> +{% endcapture %} +{% include example.html content=example %} +</div> + +## Border color + +Change the border color using utilities built on our theme colors. + +<div class="bd-example-border-utils"> +{% capture example %} +{% for color in site.data.theme-colors %} +<span class="border border-{{ color.name }}"></span>{% endfor %} +<span class="border border-white"></span> +{% endcapture %} +{% include example.html content=example %} +</div> + +## Border-radius + +Add classes to an element to easily round its corners. + +<div class="bd-example bd-example-images"> + {%- include icons/placeholder.svg width="75" height="75" class="rounded" title="Example rounded image" -%} + {%- include icons/placeholder.svg width="75" height="75" class="rounded-top" title="Example top rounded image" -%} + {%- include icons/placeholder.svg width="75" height="75" class="rounded-right" title="Example right rounded image" -%} + {%- include icons/placeholder.svg width="75" height="75" class="rounded-bottom" title="Example bottom rounded image" -%} + {%- include icons/placeholder.svg width="75" height="75" class="rounded-left" title="Example left rounded image" -%} + {%- include icons/placeholder.svg width="75" height="75" class="rounded-circle" title="Completely round image" -%} + {%- include icons/placeholder.svg width="150" height="75" class="rounded-pill" title="Rounded pill image" -%} + {%- include icons/placeholder.svg width="75" height="75" class="rounded-0" title="Example non-rounded image (overrides rounding applied elsewhere)" -%} +</div> + +{% highlight html %} +<img src="..." alt="..." class="rounded"> +<img src="..." alt="..." class="rounded-top"> +<img src="..." alt="..." class="rounded-right"> +<img src="..." alt="..." class="rounded-bottom"> +<img src="..." alt="..." class="rounded-left"> +<img src="..." alt="..." class="rounded-circle"> +<img src="..." alt="..." class="rounded-pill"> +<img src="..." alt="..." class="rounded-0"> +{% endhighlight %} + +## Sizes + +Use `.rounded-lg` or `.rounded-sm` for larger or smaller border-radius. + +<div class="bd-example bd-example-images"> + {%- include icons/placeholder.svg width="75" height="75" class="rounded-sm" title="Example small rounded image" -%} + {%- include icons/placeholder.svg width="75" height="75" class="rounded-lg" title="Example large rounded image" -%} +</div> + +{% highlight html %} +<img src="..." alt="..." class="rounded-sm"> +<img src="..." alt="..." class="rounded-lg"> +{% endhighlight %} diff --git a/vendor/twbs/bootstrap/site/docs/4.4/utilities/clearfix.md b/vendor/twbs/bootstrap/site/docs/4.4/utilities/clearfix.md new file mode 100644 index 000000000..dcf93e9bb --- /dev/null +++ b/vendor/twbs/bootstrap/site/docs/4.4/utilities/clearfix.md @@ -0,0 +1,38 @@ +--- +layout: docs +title: Clearfix +description: Quickly and easily clear floated content within a container by adding a clearfix utility. +group: utilities +--- + +Easily clear `float`s by adding `.clearfix` **to the parent element**. Can also be used as a mixin. + +{% highlight html %} +<div class="clearfix">...</div> +{% endhighlight %} + +{% highlight scss %} +// Mixin itself +@mixin clearfix() { + &::after { + display: block; + content: ""; + clear: both; + } +} + +// Usage as a mixin +.element { + @include clearfix; +} +{% endhighlight %} + +The following example shows how the clearfix can be used. Without the clearfix the wrapping div would not span around the buttons which would cause a broken layout. + +{% capture example %} +<div class="bg-info clearfix"> + <button type="button" class="btn btn-secondary float-left">Example Button floated left</button> + <button type="button" class="btn btn-secondary float-right">Example Button floated right</button> +</div> +{% endcapture %} +{% include example.html content=example %} diff --git a/vendor/twbs/bootstrap/site/docs/4.4/utilities/close-icon.md b/vendor/twbs/bootstrap/site/docs/4.4/utilities/close-icon.md new file mode 100644 index 000000000..3a8cb3c44 --- /dev/null +++ b/vendor/twbs/bootstrap/site/docs/4.4/utilities/close-icon.md @@ -0,0 +1,15 @@ +--- +layout: docs +title: Close icon +description: Use a generic close icon for dismissing content like modals and alerts. +group: utilities +--- + +**Be sure to include text for screen readers**, as we've done with `aria-label`. + +{% capture example %} +<button type="button" class="close" aria-label="Close"> + <span aria-hidden="true">×</span> +</button> +{% endcapture %} +{% include example.html content=example %} diff --git a/vendor/twbs/bootstrap/site/docs/4.4/utilities/colors.md b/vendor/twbs/bootstrap/site/docs/4.4/utilities/colors.md new file mode 100644 index 000000000..55699adb8 --- /dev/null +++ b/vendor/twbs/bootstrap/site/docs/4.4/utilities/colors.md @@ -0,0 +1,58 @@ +--- +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 + +{% capture example %} +{% for color in site.data.theme-colors %} +<p class="text-{{ color.name }}{% if color.name == "light" %} bg-dark{% endif %}">.text-{{ color.name }}</p>{% endfor %} +<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> +{% endcapture %} +{% include example.html content=example %} + +Contextual text classes also work well on anchors with the provided hover and focus states. **Note that the `.text-white` and `.text-muted` class has no additional link styling beyond underline.** + +{% capture example %} +{% for color in site.data.theme-colors %} +<p><a href="#" class="text-{{ color.name }}{% if color.name == "light" %} bg-dark{% endif %}">{{ color.name | capitalize }} link</a></p>{% endfor %} +<p><a href="#" class="text-muted">Muted link</a></p> +<p><a href="#" class="text-white bg-dark">White link</a></p> +{% endcapture %} +{% include example.html content=example %} + +## Background color + +Similar to the contextual text color classes, easily set the background of an element to any contextual class. Anchor components will darken on hover, just like the text classes. Background utilities **do not set `color`**, so in some cases you'll want to use `.text-*` utilities. + +{% capture example %} +{% for color in site.data.theme-colors %} +<div class="p-3 mb-2 bg-{{ color.name }} {% if color.name == "light" or color.name == "warning" %}text-dark{% else %}text-white{% endif %}">.bg-{{ color.name }}</div>{% endfor %} +<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> +{% endcapture %} +{% include example.html content=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]({{ site.baseurl }}/docs/{{ site.docs_version }}/getting-started/theming/#sass-options) to enable these classes and more. + +{% for color in site.data.theme-colors %} +- `.bg-gradient-{{ color.name }}`{% endfor %} + +{% capture callout %} +#### 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. +{% endcapture %} +{% include callout.html content=callout type="info" %} + +{% include callout-warning-color-assistive-technologies.md %} diff --git a/vendor/twbs/bootstrap/site/docs/4.4/utilities/display.md b/vendor/twbs/bootstrap/site/docs/4.4/utilities/display.md new file mode 100644 index 000000000..3b53460ee --- /dev/null +++ b/vendor/twbs/bootstrap/site/docs/4.4/utilities/display.md @@ -0,0 +1,102 @@ +--- +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]({{ site.baseurl }}/docs/{{ site.docs_version }}/layout/overview/#responsive-breakpoints), from `xs` to `xl`, 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`, and `xl`. + +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` and `xl` screens. + +## Examples + +{% capture 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> +{% endcapture %} +{% include example.html content=example %} + +{% capture 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> +{% endcapture %} +{% include example.html content=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}-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` will hide the element for all screen sizes except on medium and large devices. + +| Screen Size | Class | +| --- | --- | +| Hidden on all | `.d-none` | +| Hidden only on xs | `.d-none .d-sm-block` | +| Hidden only on sm | `.d-sm-none .d-md-block` | +| Hidden only on md | `.d-md-none .d-lg-block` | +| Hidden only on lg | `.d-lg-none .d-xl-block` | +| Hidden only on xl | `.d-xl-none` | +| Visible on all | `.d-block` | +| Visible only on xs | `.d-block .d-sm-none` | +| Visible only on sm | `.d-none .d-sm-block .d-md-none` | +| Visible only on md | `.d-none .d-md-block .d-lg-none` | +| Visible only on lg | `.d-none .d-lg-block .d-xl-none` | +| Visible only on xl | `.d-none .d-xl-block` | + +{% capture 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> +{% endcapture %} +{% include example.html content=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. + +{% capture 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> +{% endcapture %} +{% include example.html content=example %} diff --git a/vendor/twbs/bootstrap/site/docs/4.4/utilities/embed.md b/vendor/twbs/bootstrap/site/docs/4.4/utilities/embed.md new file mode 100644 index 000000000..1f6868074 --- /dev/null +++ b/vendor/twbs/bootstrap/site/docs/4.4/utilities/embed.md @@ -0,0 +1,61 @@ +--- +layout: docs +title: Embeds +description: Create responsive video or slideshow embeds based on the width of the parent by creating an intrinsic ratio that scales on any device. +group: utilities +toc: true +--- + +## About + +Rules are directly applied to `<iframe>`, `<embed>`, `<video>`, and `<object>` elements; optionally use an explicit descendant class `.embed-responsive-item` when you want to match the styling for other attributes. + +**Pro-Tip!** You don't need to include `frameborder="0"` in your `<iframe>`s as we override that for you. + +## Example + +Wrap any embed like an `<iframe>` in a parent element with `.embed-responsive` and an aspect ratio. The `.embed-responsive-item` isn't strictly required, but we encourage it. + +{% capture example %} +<div class="embed-responsive embed-responsive-16by9"> + <iframe class="embed-responsive-item" src="https://www.youtube.com/embed/zpOULjyy-n8?rel=0" allowfullscreen></iframe> +</div> +{% endcapture %} +{% include example.html content=example %} + +## Aspect ratios + +Aspect ratios can be customized with modifier classes. By default the following ratio classes are provided: + +{% highlight html %} +<!-- 21:9 aspect ratio --> +<div class="embed-responsive embed-responsive-21by9"> + <iframe class="embed-responsive-item" src="..."></iframe> +</div> + +<!-- 16:9 aspect ratio --> +<div class="embed-responsive embed-responsive-16by9"> + <iframe class="embed-responsive-item" src="..."></iframe> +</div> + +<!-- 4:3 aspect ratio --> +<div class="embed-responsive embed-responsive-4by3"> + <iframe class="embed-responsive-item" src="..."></iframe> +</div> + +<!-- 1:1 aspect ratio --> +<div class="embed-responsive embed-responsive-1by1"> + <iframe class="embed-responsive-item" src="..."></iframe> +</div> +{% endhighlight %} + +Within `_variables.scss`, you can change the aspect ratios you want to use. Here's an example of the `$embed-responsive-aspect-ratios` list: + +{% highlight scss %} +$embed-responsive-aspect-ratios: ( + (21 9), + (16 9), + (4 3), + (1 1) +) !default; +{% endhighlight %} diff --git a/vendor/twbs/bootstrap/site/docs/4.4/utilities/flex.md b/vendor/twbs/bootstrap/site/docs/4.4/utilities/flex.md new file mode 100644 index 000000000..acaa2a51b --- /dev/null +++ b/vendor/twbs/bootstrap/site/docs/4.4/utilities/flex.md @@ -0,0 +1,570 @@ +--- +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. + +{% capture example %} +<div class="d-flex p-2 bd-highlight">I'm a flexbox container!</div> +{% endcapture %} +{% include example.html content=example %} + +{% capture example %} +<div class="d-inline-flex p-2 bd-highlight">I'm an inline flexbox container!</div> +{% endcapture %} +{% include example.html content=example %} + +Responsive variations also exist for `.d-flex` and `.d-inline-flex`. + +{% for bp in site.data.breakpoints %} +- `.d{{ bp.abbr }}-flex` +- `.d{{ bp.abbr }}-inline-flex`{% endfor %} + +## 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. + +{% capture 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> +{% endcapture %} +{% include example.html content=example %} + +Use `.flex-column` to set a vertical direction, or `.flex-column-reverse` to start the vertical direction from the opposite side. + +{% capture 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> +{% endcapture %} +{% include example.html content=example %} + +Responsive variations also exist for `flex-direction`. + +{% for bp in site.data.breakpoints %} +- `.flex{{ bp.abbr }}-row` +- `.flex{{ bp.abbr }}-row-reverse` +- `.flex{{ bp.abbr }}-column` +- `.flex{{ bp.abbr }}-column-reverse`{% endfor %} + +## 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> +{% endhighlight %} + +Responsive variations also exist for `justify-content`. + +{% for bp in site.data.breakpoints %} +- `.justify-content{{ bp.abbr }}-start` +- `.justify-content{{ bp.abbr }}-end` +- `.justify-content{{ bp.abbr }}-center` +- `.justify-content{{ bp.abbr }}-between` +- `.justify-content{{ bp.abbr }}-around`{% endfor %} + +## 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> +{% endhighlight %} + +Responsive variations also exist for `align-items`. + +{% for bp in site.data.breakpoints %} +- `.align-items{{ bp.abbr }}-start` +- `.align-items{{ bp.abbr }}-end` +- `.align-items{{ bp.abbr }}-center` +- `.align-items{{ bp.abbr }}-baseline` +- `.align-items{{ bp.abbr }}-stretch`{% endfor %} + +## 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> +{% endhighlight %} + +Responsive variations also exist for `align-self`. + +{% for bp in site.data.breakpoints %} +- `.align-self{{ bp.abbr }}-start` +- `.align-self{{ bp.abbr }}-end` +- `.align-self{{ bp.abbr }}-center` +- `.align-self{{ bp.abbr }}-baseline` +- `.align-self{{ bp.abbr }}-stretch`{% endfor %} + +## 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. + +{% capture 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> +{% endcapture %} +{% include example.html content=example %} + +Responsive variations also exist for `flex-fill`. + +{% for bp in site.data.breakpoints %} +- `.flex{{ bp.abbr }}-fill`{% endfor %} + +## 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. + +{% capture 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> +{% endcapture %} +{% include example.html content=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 it's contents to a new line, "shrinking" to allow more space for the previous flex item with `.w-100`. + +{% capture 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> +{% endcapture %} +{% include example.html content=example %} + +Responsive variations also exist for `flex-grow` and `flex-shrink`. + +{% for bp in site.data.breakpoints %} +- `.flex{{ bp.abbr }}-{grow|shrink}-0` +- `.flex{{ bp.abbr }}-{grow|shrink}-1`{% endfor %} + +## 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`). + +**Unfortunately, IE10 and IE11 do not properly support auto margins on flex items whose parent has a non-default `justify-content` value.** [See this StackOverflow answer](https://stackoverflow.com/a/37535548) for more details. + +{% capture 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> +{% endcapture %} +{% include example.html content=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`. + +{% capture 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> +{% endcapture %} +{% include example.html content=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> +{% endhighlight %} + +<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> +{% endhighlight %} + +<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> +{% endhighlight %} + + +Responsive variations also exist for `flex-wrap`. + +{% for bp in site.data.breakpoints %} +- `.flex{{ bp.abbr }}-nowrap` +- `.flex{{ bp.abbr }}-wrap` +- `.flex{{ bp.abbr }}-wrap-reverse`{% endfor %} + +## 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 (e.g., `5`), add custom CSS for any additional values needed. + +{% capture 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> +{% endcapture %} +{% include example.html content=example %} + +Responsive variations also exist for `order`. + +{% for bp in site.data.breakpoints %}{% for i in (0..12) %} +- `.order{{ bp.abbr }}-{{ i }}`{% endfor %}{% endfor %} + +## 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> +{% endhighlight %} + +<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> +{% endhighlight %} + +<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> +{% endhighlight %} + +<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> +{% endhighlight %} + +<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> +{% endhighlight %} + +<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> +{% endhighlight %} + +Responsive variations also exist for `align-content`. + +{% for bp in site.data.breakpoints %} +- `.align-content{{ bp.abbr }}-start` +- `.align-content{{ bp.abbr }}-end` +- `.align-content{{ bp.abbr }}-center` +- `.align-content{{ bp.abbr }}-around` +- `.align-content{{ bp.abbr }}-stretch`{% endfor %} diff --git a/vendor/twbs/bootstrap/site/docs/4.4/utilities/float.md b/vendor/twbs/bootstrap/site/docs/4.4/utilities/float.md new file mode 100644 index 000000000..977beaeaf --- /dev/null +++ b/vendor/twbs/bootstrap/site/docs/4.4/utilities/float.md @@ -0,0 +1,57 @@ +--- +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. + +## Classes + +Toggle a float with a class: + +{% capture 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> +{% endcapture %} +{% include example.html content=example %} + +## Mixins + +Or by Sass mixin: + +{% highlight scss %} +.element { + @include float-left; +} +.another-element { + @include float-right; +} +.one-more { + @include float-none; +} +{% endhighlight %} + +## Responsive + +Responsive variations also exist for each `float` value. + +{% capture 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> +{% endcapture %} +{% include example.html content=example %} + +Here are all the support classes; + +{% for bp in site.data.breakpoints %} +- `.float{{ bp.abbr }}-left` +- `.float{{ bp.abbr }}-right` +- `.float{{ bp.abbr }}-none`{% endfor %} diff --git a/vendor/twbs/bootstrap/site/docs/4.4/utilities/image-replacement.md b/vendor/twbs/bootstrap/site/docs/4.4/utilities/image-replacement.md new file mode 100644 index 000000000..4c7decac5 --- /dev/null +++ b/vendor/twbs/bootstrap/site/docs/4.4/utilities/image-replacement.md @@ -0,0 +1,36 @@ +--- +layout: docs +title: Image replacement +description: Swap text for background images with the image replacement class. +group: utilities +--- + +{% capture callout %} +##### Warning + +The `text-hide()` class and mixin has been deprecated as of v4.1. It will be removed entirely in v5. +{% endcapture %} +{% include callout.html content=callout type="warning" %} + +Utilize the `.text-hide` class or mixin to help replace an element's text content with a background image. + +{% highlight html %} +<h1 class="text-hide">Custom heading</h1> +{% endhighlight %} + +{% highlight scss %} +// Usage as a mixin +.heading { + @include text-hide; +} +{% endhighlight %} + +Use the `.text-hide` class to maintain the accessibility and SEO benefits of heading tags, but want to utilize a `background-image` instead of text. + +<div class="bd-example"> + <h1 class="text-hide" style="background-image: url('{{ site.baseurl }}/docs/{{ site.docs_version }}/assets/brand/bootstrap-solid.svg'); width: 50px; height: 50px;">Bootstrap</h1> +</div> + +{% highlight html %} +<h1 class="text-hide" style="background-image: url('...');">Bootstrap</h1> +{% endhighlight %} diff --git a/vendor/twbs/bootstrap/site/docs/4.4/utilities/overflow.md b/vendor/twbs/bootstrap/site/docs/4.4/utilities/overflow.md new file mode 100644 index 000000000..2877c85b7 --- /dev/null +++ b/vendor/twbs/bootstrap/site/docs/4.4/utilities/overflow.md @@ -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> +{% endhighlight %} + +Using Sass variables, you may customize the overflow utilities by changing the `$overflows` variable in `_variables.scss`. diff --git a/vendor/twbs/bootstrap/site/docs/4.4/utilities/position.md b/vendor/twbs/bootstrap/site/docs/4.4/utilities/position.md new file mode 100644 index 000000000..c819df080 --- /dev/null +++ b/vendor/twbs/bootstrap/site/docs/4.4/utilities/position.md @@ -0,0 +1,45 @@ +--- +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> +{% endhighlight %} + +## Fixed top + +Position an element at the top of the viewport, from edge to edge. Be sure you understand the ramifications of fixed position in your project; you may need to add additional CSS. + +{% highlight html %} +<div class="fixed-top">...</div> +{% endhighlight %} + +## Fixed bottom + +Position an element at the bottom of the viewport, from edge to edge. Be sure you understand the ramifications of fixed position in your project; you may need to add additional CSS. + +{% highlight html %} +<div class="fixed-bottom">...</div> +{% endhighlight %} + +## Sticky top + +Position an element at the top of the viewport, from edge to edge, but only after you scroll past it. The `.sticky-top` utility uses CSS's `position: sticky`, which isn't fully supported in all browsers. + +**IE11 and IE10 will render `position: sticky` as `position: relative`.** As such, we wrap the styles in a `@supports` query, limiting the stickiness to only browsers that can render it properly. + +{% highlight html %} +<div class="sticky-top">...</div> +{% endhighlight %} diff --git a/vendor/twbs/bootstrap/site/docs/4.4/utilities/screen-readers.md b/vendor/twbs/bootstrap/site/docs/4.4/utilities/screen-readers.md new file mode 100644 index 000000000..c38ba3e65 --- /dev/null +++ b/vendor/twbs/bootstrap/site/docs/4.4/utilities/screen-readers.md @@ -0,0 +1,25 @@ +--- +layout: docs +title: Screen readers +description: Use screen reader utilities to hide elements on all devices except screen readers. +group: utilities +--- + +Hide an element to all devices **except screen readers** with `.sr-only`. Combine `.sr-only` with `.sr-only-focusable` to show the element again when it's focused (e.g. by a keyboard-only user). Can also be used as mixins. + +{%- comment -%} +Necessary for following [accessibility best practices]({{ site.baseurl }}/docs/{{ site.docs_version }}/getting-started/#accessibility). +{%- endcomment -%} + +{% capture example %} +<a class="sr-only sr-only-focusable" href="#content">Skip to main content</a> +{% endcapture %} +{% include example.html content=example %} + +{% highlight scss %} +// Usage as a mixin +.skip-navigation { + @include sr-only; + @include sr-only-focusable; +} +{% endhighlight %} diff --git a/vendor/twbs/bootstrap/site/docs/4.4/utilities/shadows.md b/vendor/twbs/bootstrap/site/docs/4.4/utilities/shadows.md new file mode 100644 index 000000000..9c3e58044 --- /dev/null +++ b/vendor/twbs/bootstrap/site/docs/4.4/utilities/shadows.md @@ -0,0 +1,18 @@ +--- +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). + +{% capture 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> +{% endcapture %} +{% include example.html content=example %} diff --git a/vendor/twbs/bootstrap/site/docs/4.4/utilities/sizing.md b/vendor/twbs/bootstrap/site/docs/4.4/utilities/sizing.md new file mode 100644 index 000000000..1b0acf07a --- /dev/null +++ b/vendor/twbs/bootstrap/site/docs/4.4/utilities/sizing.md @@ -0,0 +1,56 @@ +--- +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 `$sizes` Sass map in `_variables.scss`. Includes support for `25%`, `50%`, `75%`, `100%`, and `auto` by default. Modify those values as you need to generate different utilities here. + +{% capture 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> +{% endcapture %} +{% include example.html content=example %} + +{% capture 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> +{% endcapture %} +{% include example.html content=example %} + +You can also use `max-width: 100%;` and `max-height: 100%;` utilities as needed. + +{% capture example %} +{% include icons/placeholder.svg width="100%" height="100" class="mw-100" text="Max-width 100%" %} +{% endcapture %} +{% include example.html content=example %} + +{% capture example %} +<div style="height: 100px; background-color: rgba(255,0,0,0.1);"> + <div class="mh-100" style="width: 100px; height: 200px; background-color: rgba(0,0,255,0.1);">Max-height 100%</div> +</div> +{% endcapture %} +{% include example.html content=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> +{% endhighlight %} diff --git a/vendor/twbs/bootstrap/site/docs/4.4/utilities/spacing.md b/vendor/twbs/bootstrap/site/docs/4.4/utilities/spacing.md new file mode 100644 index 000000000..09e17e044 --- /dev/null +++ b/vendor/twbs/bootstrap/site/docs/4.4/utilities/spacing.md @@ -0,0 +1,105 @@ +--- +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 `xl`, 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`, and `xl`. + +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; +} +{% endhighlight %} + +### 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> +{% endhighlight %} + +### Negative margin + +In CSS, `margin` properties can utilize negative values (`padding` cannot). As of 4.2, we've added negative margin utilities for every non-zero integer size listed above (e.g., `1`, `2`, `3`, `4`, `5`). These utilities are ideal for customizing grid column gutters across breakpoints. + +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; +} +{% endhighlight %} + +Here's an example of customizing the Bootstrap grid at the medium (`md`) breakpoint and above. We've increased the `.col` padding with `.px-md-5` and then counteracted that with `.mx-md-n5` on the parent `.row`. + +{% capture example %} +<div class="row mx-md-n5"> + <div class="col px-md-5"><div class="p-3 border bg-light">Custom column padding</div></div> + <div class="col px-md-5"><div class="p-3 border bg-light">Custom column padding</div></div> +</div> +{% endcapture %} +{% include example.html content=example %} diff --git a/vendor/twbs/bootstrap/site/docs/4.4/utilities/stretched-link.md b/vendor/twbs/bootstrap/site/docs/4.4/utilities/stretched-link.md new file mode 100644 index 000000000..1d4d2ad31 --- /dev/null +++ b/vendor/twbs/bootstrap/site/docs/4.4/utilities/stretched-link.md @@ -0,0 +1,80 @@ +--- +layout: docs +title: Stretched link +description: Make any HTML element or Bootstrap component clickable by "stretching" a nested link via CSS. +group: utilities +--- + +Add `.stretched-link` to a link to make its [containing block](https://developer.mozilla.org/en-US/docs/Web/CSS/Containing_block) clickable via a `::after` pseudo element. In most cases, this means that an element with `position: relative;` that contains a link with the `.stretched-link` class is clickable. + +Cards have `position: relative` by default in Bootstrap, so in this case you can safely add the `.stretched-link` class to a link in the card without any other HTML changes. + +Multiple links and tap targets are not recommended with stretched links. However, some `position` and `z-index` styles can help should this be required. + +{% capture example %} +<div class="card" style="width: 18rem;"> + {% include icons/placeholder.svg width="100%" height="180" class="card-img-top" text=" " title="Card image cap" %} + <div class="card-body"> + <h5 class="card-title">Card with stretched link</h5> + <p class="card-text">Some quick example text to build on the card title and make up the bulk of the card's content.</p> + <a href="#" class="btn btn-primary stretched-link">Go somewhere</a> + </div> +</div> +{% endcapture %} +{% include example.html content=example %} + +Media objects do not have `position: relative` by default, so we need to add the `.position-relative` here to prevent the link from stretching outside the media object. + +{% capture example %} +<div class="media position-relative"> + {% include icons/placeholder.svg width="144" height="144" class="mr-3" text=" " title="Generic placeholder image" %} + <div class="media-body"> + <h5 class="mt-0">Media with stretched link</h5> + <p>Cras sit amet nibh libero, in gravida nulla. Nulla vel metus scelerisque ante sollicitudin. Cras purus odio, vestibulum in vulputate at, tempus viverra turpis. Fusce condimentum nunc ac nisi vulputate fringilla. Donec lacinia congue felis in faucibus.</p> + <a href="#" class="stretched-link">Go somewhere</a> + </div> +</div> +{% endcapture %} +{% include example.html content=example %} + +Columns are `position: relative` by default, so clickable columns only require the `.stretched-link` class on a link. However, stretching a link over an entire `.row` requires `.position-static` on the column and `.position-relative` on the row. + +{% capture example %} +<div class="row no-gutters bg-light position-relative"> + <div class="col-md-6 mb-md-0 p-md-4"> + {% include icons/placeholder.svg width="100%" height="200" class="w-100" text=" " title="Generic placeholder image" %} + </div> + <div class="col-md-6 position-static p-4 pl-md-0"> + <h5 class="mt-0">Columns with stretched link</h5> + <p>Cras sit amet nibh libero, in gravida nulla. Nulla vel metus scelerisque ante sollicitudin. Cras purus odio, vestibulum in vulputate at, tempus viverra turpis. Fusce condimentum nunc ac nisi vulputate fringilla. Donec lacinia congue felis in faucibus.</p> + <a href="#" class="stretched-link">Go somewhere</a> + </div> +</div> +{% endcapture %} +{% include example.html content=example %} + +## Identifying the containing block + +If the stretched link doesn't seem to work, the [containing block](https://developer.mozilla.org/en-US/docs/Web/CSS/Containing_block#Identifying_the_containing_block) will probably be the cause. The following CSS properties will make an element the containing block: + +- A `position` value other than `static` +- A `transform` or `perspective` value other than `none` +- A `will-change` value of `transform` or `perspective` +- A `filter` value other than `none` or a `will-change` value of `filter` (only works on Firefox) + +{% capture example %} +<div class="card" style="width: 18rem;"> + {% include icons/placeholder.svg width="100%" height="180" class="card-img-top" text=" " title="Card image cap" %} + <div class="card-body"> + <h5 class="card-title">Card with stretched links</h5> + <p class="card-text">Some quick example text to build on the card title and make up the bulk of the card's content.</p> + <p class="card-text"> + <a href="#" class="stretched-link text-danger" style="position: relative;">Stretched link will not work here, because <code>position: relative</code> is added to the link</a> + </p> + <p class="card-text bg-light" style="transform: rotate(0);"> + This <a href="#" class="text-warning stretched-link">stretched link</a> will only be spread over the <code>p</code>-tag, because a transform is applied to it. + </p> + </div> +</div> +{% endcapture %} +{% include example.html content=example %} diff --git a/vendor/twbs/bootstrap/site/docs/4.4/utilities/text.md b/vendor/twbs/bootstrap/site/docs/4.4/utilities/text.md new file mode 100644 index 000000000..d25564a18 --- /dev/null +++ b/vendor/twbs/bootstrap/site/docs/4.4/utilities/text.md @@ -0,0 +1,132 @@ +--- +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. + +{% capture example %} +<p class="text-justify">Ambitioni dedisse scripsisse iudicaretur. Cras mattis iudicium purus sit amet fermentum. Donec sed odio operae, eu vulputate felis rhoncus. Praeterea iter est quasdam res quas ex communi. At nos hinc posthac, sitientis piros Afros. Petierunt uti sibi concilium totius Galliae in diem certam indicere. Cras mattis iudicium purus sit amet fermentum.</p> +{% endcapture %} +{% include example.html content=example %} + +For left, right, and center alignment, responsive classes are available that use the same viewport width breakpoints as the grid system. + +{% capture 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> +{% endcapture %} +{% include example.html content=example %} + +## Text wrapping and overflow + +Wrap text with a `.text-wrap` class. + +{% capture example %} +<div class="badge badge-primary text-wrap" style="width: 6rem;"> + This text should wrap. +</div> +{% endcapture %} +{% include example.html content=example %} + +Prevent text from wrapping with a `.text-nowrap` class. + +{% capture example %} +<div class="text-nowrap bd-highlight" style="width: 8rem;"> + This text should overflow the parent. +</div> +{% endcapture %} +{% include example.html content=example %} + +For longer content, you can add a `.text-truncate` class to truncate the text with an ellipsis. **Requires `display: inline-block` or `display: block`.** + +{% capture example %} +<!-- Block level --> +<div class="row"> + <div class="col-2 text-truncate"> + Praeterea iter est quasdam res quas ex communi. + </div> +</div> + +<!-- Inline level --> +<span class="d-inline-block text-truncate" style="max-width: 150px;"> + Praeterea iter est quasdam res quas ex communi. +</span> +{% endcapture %} +{% include example.html content=example %} + +## Word break + +Prevent long strings of text from breaking your components' layout by using `.text-break` to set `overflow-wrap: break-word` (and `word-break: break-word` for IE & Edge compatibility). + +{% capture example %} +<p class="text-break">mmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmm</p> +{% endcapture %} +{% include example.html content=example %} + +## Text transform + +Transform text in components with text capitalization classes. + +{% capture example %} +<p class="text-lowercase">Lowercased text.</p> +<p class="text-uppercase">Uppercased text.</p> +<p class="text-capitalize">CapiTaliZed text.</p> +{% endcapture %} +{% include example.html content=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. + +{% capture 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> +{% endcapture %} +{% include example.html content=example %} + +## Monospace + +Change a selection to our monospace font stack with `.text-monospace`. + +{% capture example %} +<p class="text-monospace">This is in monospace</p> +{% endcapture %} +{% include example.html content=example %} + +## Reset color + +Reset a text or link's color with `.text-reset`, so that it inherits the color from its parent. + +{% capture example %} +<p class="text-muted"> + Muted text with a <a href="#" class="text-reset">reset link</a>. +</p> +{% endcapture %} +{% include example.html content=example %} + +## Text decoration + +Remove a text decoration with a `.text-decoration-none` class. + +{% capture example %} +<a href="#" class="text-decoration-none">Non-underlined link</a> +{% endcapture %} +{% include example.html content=example %} diff --git a/vendor/twbs/bootstrap/site/docs/4.4/utilities/vertical-align.md b/vendor/twbs/bootstrap/site/docs/4.4/utilities/vertical-align.md new file mode 100644 index 000000000..bc4f0b950 --- /dev/null +++ b/vendor/twbs/bootstrap/site/docs/4.4/utilities/vertical-align.md @@ -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. + +With inline elements: + +{% capture 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> +{% endcapture %} +{% include example.html content=example %} + +With table cells: + +{% capture 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> +{% endcapture %} +{% include example.html content=example %} diff --git a/vendor/twbs/bootstrap/site/docs/4.4/utilities/visibility.md b/vendor/twbs/bootstrap/site/docs/4.4/utilities/visibility.md new file mode 100644 index 000000000..bbfc0cbbc --- /dev/null +++ b/vendor/twbs/bootstrap/site/docs/4.4/utilities/visibility.md @@ -0,0 +1,34 @@ +--- +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> +{% endhighlight %} + +{% highlight scss %} +// Class +.visible { + visibility: visible !important; +} +.invisible { + visibility: hidden !important; +} + +// Usage as a mixin +// Warning: The `invisible()` mixin has been deprecated as of v4.3.0. It will be removed entirely in v5. +.element { + @include invisible(visible); +} +.element { + @include invisible(hidden); +} +{% endhighlight %} |