mirror of
https://github.com/twbs/bootstrap.git
synced 2024-12-14 02:24:00 +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
29 lines
1.3 KiB
Markdown
29 lines
1.3 KiB
Markdown
---
|
|
layout: docs
|
|
title: Figures
|
|
description: Documentation and examples for displaying related images and text with the figure component in Bootstrap.
|
|
group: content
|
|
---
|
|
|
|
Anytime you need to display a piece of content—like an image with an optional caption, consider using a `<figure>`.
|
|
|
|
Use the included `.figure` , `.figure-img` and `.figure-caption` classes to provide some baseline styles for the HTML5 `<figure>` and `<figcaption>` elements. Images in figures have no explicit size, so be sure to add the `.img-fluid` class to your `<img>` to make it responsive.
|
|
|
|
{% capture example %}
|
|
<figure class="figure">
|
|
{% include icons/placeholder.svg width="400" height="300" class="figure-img img-fluid rounded" %}
|
|
<figcaption class="figure-caption">A caption for the above image.</figcaption>
|
|
</figure>
|
|
{% endcapture %}
|
|
{% include example.html content=example %}
|
|
|
|
Aligning the figure's caption is easy with our [text utilities]({{ site.baseurl }}/docs/{{ site.docs_version }}/utilities/text/#text-alignment).
|
|
|
|
{% capture example %}
|
|
<figure class="figure">
|
|
{% include icons/placeholder.svg width="400" height="300" class="figure-img img-fluid rounded" %}
|
|
<figcaption class="figure-caption text-right">A caption for the above image.</figcaption>
|
|
</figure>
|
|
{% endcapture %}
|
|
{% include example.html content=example %}
|