Stripped personal data from development repository
edit | blame | history | raw

---
layout: docs
title: Images
description: Documentation and examples for opting images into responsive behavior (so they never become larger than their parent elements) and add lightweight styles to them—all via classes.
group: content

toc: true

Responsive images

Images in Bootstrap are made responsive with .img-fluid. max-width: 100%; and height: auto; are applied to the image so that it scales with the parent element.

{% include icons/placeholder.svg width="100%" height="250" class="bd-placeholder-img-lg img-fluid" text="Responsive image" %}

{% highlight html %}
Responsive image
{% endhighlight %}

{% capture callout %}

SVG images and IE 10

In Internet Explorer 10, SVG images with .img-fluid are disproportionately sized. To fix this, add width: 100% \9; where necessary. This fix improperly sizes other image formats, so Bootstrap doesn't apply it automatically.
{% endcapture %}
{% include callout.html content=callout type="warning" %}

Image thumbnails

In addition to our [border-radius utilities]({{ site.baseurl }}/docs/{{ site.docs_version }}/utilities/borders/), you can use .img-thumbnail to give an image a rounded 1px border appearance.

{% include icons/placeholder.svg width="200" height="200" class="img-thumbnail" title="A generic square placeholder image with a white border around it, making it resemble a photograph taken with an old instant camera" %}

{% highlight html %}
...
{% endhighlight %}

Aligning images

Align images with the [helper float classes]({{ site.baseurl }}/docs/{{ site.docs_version }}/utilities/float/) or [text alignment classes]({{ site.baseurl }}/docs/{{ site.docs_version }}/utilities/text/#text-alignment). block-level images can be centered using [the .mx-auto margin utility class]({{ site.baseurl }}/docs/{{ site.docs_version }}/utilities/spacing/#horizontal-centering).

{% include icons/placeholder.svg width="200" height="200" class="rounded float-left" %} {% include icons/placeholder.svg width="200" height="200" class="rounded float-right" %}

{% highlight html %}
...
...
{% endhighlight %}

{% include icons/placeholder.svg width="200" height="200" class="rounded mx-auto d-block" %}

{% highlight html %}
...
{% endhighlight %}

{% include icons/placeholder.svg width="200" height="200" class="rounded" %}

{% highlight html %}


...

{% endhighlight %}

Picture

If you are using the <picture> element to specify multiple <source> elements for a specific <img>, make sure to add the .img-* classes to the <img> and not to the <picture> tag.

{% highlight html %}


...

{% endhighlight %}