diff options
Diffstat (limited to 'site/docs/4.2/utilities/sizing.md')
-rw-r--r-- | site/docs/4.2/utilities/sizing.md | 56 |
1 files changed, 56 insertions, 0 deletions
diff --git a/site/docs/4.2/utilities/sizing.md b/site/docs/4.2/utilities/sizing.md new file mode 100644 index 0000000000..1b0acf07ac --- /dev/null +++ b/site/docs/4.2/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 %} |