mirror of
https://github.com/twbs/bootstrap.git
synced 2024-11-29 11:24:18 +01:00
92 lines
3.6 KiB
Markdown
92 lines
3.6 KiB
Markdown
---
|
|
layout: page
|
|
title: Images
|
|
group: components
|
|
---
|
|
|
|
Opt your images into responsive behavior (so they never become larger than their parent elements) and add lightweight styles to them—all via classes.
|
|
|
|
## Contents
|
|
|
|
* Will be replaced with the ToC, excluding the "Contents" header
|
|
{:toc}
|
|
|
|
## Responsive images
|
|
|
|
Images in Bootstrap are made responsive with `.img-responsive`. `max-width: 100%;` and `height: auto;` are applied to the image so that it scales with the parent element.
|
|
|
|
<div class="bd-example">
|
|
<img data-src="holder.js/100%x250" class="img-responsive" alt="Generic responsive image">
|
|
</div>
|
|
|
|
{% highlight html %}
|
|
<img src="..." class="img-responsive" alt="Responsive image">
|
|
{% endhighlight %}
|
|
|
|
{% callout warning %}
|
|
#### SVG images and IE 9-10
|
|
|
|
In Internet Explorer 9-10, SVG images with `.img-responsive` are disproportionately sized. To fix this, add `width: 100% \9;` where necessary. Bootstrap doesn't apply this automatically as it causes complications to other image formats.
|
|
{% endcallout %}
|
|
|
|
## Image shapes
|
|
|
|
Add classes to an `<img>` element to easily style images in any project.
|
|
|
|
<div class="bd-example bd-example-images">
|
|
<img data-src="holder.js/200x200" class="img-rounded" alt="A generic square placeholder image with rounded corners">
|
|
<img data-src="holder.js/200x200" class="img-circle" alt="A generic square placeholder image where only the portion within the circle circumscribed about said square is visible">
|
|
<img data-src="holder.js/200x200" class="img-thumbnail" alt="A generic square placeholder image with a white border around it, making it resemble a photograph taken with an old instant camera">
|
|
</div>
|
|
|
|
{% highlight html %}
|
|
<img src="..." alt="..." class="img-rounded">
|
|
<img src="..." alt="..." class="img-circle">
|
|
<img src="..." alt="..." class="img-thumbnail">
|
|
{% endhighlight %}
|
|
|
|
## Aligning images
|
|
|
|
Align images with the [helper float classes](/components/helpers) or [text alignment classes](/components/helpers). A simple centering class can also be used for `block` level images.
|
|
|
|
<div class="bd-example bd-example-images">
|
|
<img data-src="holder.js/200x200" class="img-rounded pull-left" alt="A generic square placeholder image with rounded corners">
|
|
<img data-src="holder.js/200x200" class="img-rounded pull-right" alt="A generic square placeholder image with rounded corners">
|
|
</div>
|
|
|
|
{% highlight html %}
|
|
<img src="..." class="img-rounded pull-left" alt="...">
|
|
<img src="..." class="img-rounded pull-right" alt="...">
|
|
{% endhighlight %}
|
|
|
|
<div class="bd-example bd-example-images">
|
|
<img data-src="holder.js/200x200" class="img-rounded center-block" style="display: block;" alt="A generic square placeholder image with rounded corners">
|
|
</div>
|
|
|
|
{% highlight html %}
|
|
<img src="..." class="img-rounded center-block" style="display: block;" alt="...">
|
|
{% endhighlight %}
|
|
|
|
<div class="bd-example bd-example-images">
|
|
<div class="text-center">
|
|
<img data-src="holder.js/200x200" class="img-rounded" alt="A generic square placeholder image with rounded corners">
|
|
</div>
|
|
</div>
|
|
|
|
{% highlight html %}
|
|
<div class="text-center">
|
|
<img src="..." class="img-rounded" alt="...">
|
|
</div>
|
|
{% endhighlight %}
|
|
|
|
## Figures
|
|
|
|
Use the included `.figure` and `.figure-caption` classes to provide some baseline styles for the HTML5 `<figure>` and `<figcaption>` elements. As a bonus, immediate children images are automatically responsive.
|
|
|
|
{% example html %}
|
|
<figure class="figure">
|
|
<img data-src="holder.js/400x300" class="img-rounded" alt="A generic square placeholder image with rounded corners in a figure.">
|
|
<figcaption class="figure-caption">A caption for the above image.</figcaption>
|
|
</figure>
|
|
{% endexample %}
|