mirror of
https://github.com/twbs/bootstrap.git
synced 2025-01-09 02:46:15 +01:00
c031584bcd
* SVG accessibility fixes - add `focusable="false"` to all SVGs, to stop IE from including the `<svg>` in its default focus cycle - completely hide decorative SVGs using `aria-hidden="true"` - add `role="img"` to meaningful/"content" SVGs, ensure they have an appropriate `<title>` and/or `aria-label` - simplify placeholder default title * Simplify usage of placeholder.svg in the docs - in most cases, no need for separate/redundant text and title (now that we make text itself part of the alternative text explicitly) - no need (expect in rare cirumstances) to describe the placeholder image (unless the look of the image is important/the actual content, as is the case with the image thumbnail class) * Simplify example.html rewriting of <svg> to <img> code sample - as the `alt` for the placeholder isn't really important, just add an ellipsis instead (otherwise, to be correct, we'd have to construct the whole "title+text" construct like we do now in the placeholder.svg itself * Change svgo configuration to retain role attribute and add/force focusable=false - regarding `focusable=false`, see https://github.com/svg/svgo/issues/1011 (which would be the "proper" SVGO fix) and the (hacky) solution https://github.com/svg/svgo/pull/817
57 lines
2.4 KiB
Markdown
57 lines
2.4 KiB
Markdown
---
|
|
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 %}
|