0
0
mirror of https://github.com/twbs/bootstrap.git synced 2025-01-05 23:46:20 +01:00
Bootstrap/site/docs/4.1/utilities/sizing.md
Patrick H. Lauke c031584bcd
SVG accessibility fixes (#27826)
* 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
2018-12-13 13:09:47 +00:00

2.4 KiB

layout title description group toc
docs Sizing Easily make an element as wide or as tall with our width and height utilities. utilities 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 %}

Width 25%
Width 50%
Width 75%
Width 100%
Width auto
{% endcapture %} {% include example.html content=example %}

{% capture example %}

Height 25%
Height 50%
Height 75%
Height 100%
Height auto
{% 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 %}

Max-height 100%
{% 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 %}

Min-width 100vw
Min-height 100vh
Width 100vw
Height 100vh
{% endhighlight %}