0
0
mirror of https://github.com/twbs/bootstrap.git synced 2024-12-10 22:24:19 +01:00
Bootstrap/site/docs/4.3/content/images.md

85 lines
3.3 KiB
Markdown
Raw Normal View History

2014-07-13 09:59:31 +02:00
---
layout: docs
2014-07-13 09:59:31 +02:00
title: Images
2017-05-28 07:16:44 +02:00
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.
2015-08-10 08:38:16 +02:00
group: content
2017-05-28 07:16:44 +02:00
toc: true
2014-07-13 09:59:31 +02:00
---
2014-07-10 06:17:22 +02:00
## 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.
2014-07-10 06:17:22 +02:00
<div class="bd-example">
{% include icons/placeholder.svg width="100%" height="250" class="bd-placeholder-img-lg img-fluid" text="Responsive image" %}
2014-07-10 06:17:22 +02:00
</div>
2014-03-17 03:03:53 +01:00
{% highlight html %}
<img src="..." class="img-fluid" alt="Responsive image">
2014-03-17 03:03:53 +01:00
{% 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" %}
2014-07-10 06:17:22 +02:00
## Image thumbnails
2014-07-10 06:17:22 +02:00
2017-05-29 20:38:06 +02:00
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.
2014-07-10 06:17:22 +02:00
<div class="bd-example bd-example-images">
2018-11-08 18:33:02 +01:00
{% 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" %}
2014-07-10 06:17:22 +02:00
</div>
2014-03-17 03:03:53 +01:00
{% highlight html %}
<img src="..." alt="..." class="img-thumbnail">
{% endhighlight %}
Merge branch 'master' into v4 Conflicts: .travis.yml Gruntfile.js bower.json dist/css/bootstrap.css dist/css/bootstrap.css.map dist/css/bootstrap.min.css dist/js/bootstrap.js dist/js/bootstrap.min.js docs/_data/glyphicons.yml docs/_includes/components/breadcrumbs.html docs/_includes/components/button-dropdowns.html docs/_includes/components/button-groups.html docs/_includes/components/dropdowns.html docs/_includes/components/glyphicons.html docs/_includes/components/labels.html docs/_includes/components/list-group.html docs/_includes/components/media.html docs/_includes/components/navs.html docs/_includes/components/panels.html docs/_includes/components/progress-bars.html docs/_includes/components/thumbnails.html docs/_includes/components/wells.html docs/_includes/css/buttons.html docs/_includes/css/forms.html docs/_includes/css/helpers.html docs/_includes/css/images.html docs/_includes/css/less.html docs/_includes/customizer-variables.html docs/_includes/getting-started/accessibility.html docs/_includes/getting-started/browser-device-support.html docs/_includes/getting-started/community.html docs/_includes/getting-started/examples.html docs/_includes/getting-started/grunt.html docs/_includes/getting-started/license.html docs/_includes/getting-started/template.html docs/_includes/header.html docs/_includes/js/affix.html docs/_includes/js/alerts.html docs/_includes/js/carousel.html docs/_includes/js/collapse.html docs/_includes/js/dropdowns.html docs/_includes/js/modal.html docs/_includes/js/overview.html docs/_includes/js/popovers.html docs/_includes/js/scrollspy.html docs/_includes/js/tabs.html docs/_includes/js/tooltips.html docs/_includes/js/transitions.html docs/_includes/nav/javascript.html docs/_layouts/default.html docs/assets/css/docs.min.css docs/assets/css/src/docs.css docs/assets/js/customize.min.js docs/assets/js/docs.min.js docs/assets/js/raw-files.min.js docs/assets/js/vendor/FileSaver.js docs/assets/js/vendor/autoprefixer.js docs/assets/js/vendor/uglify.min.js docs/dist/css/bootstrap.css docs/dist/css/bootstrap.css.map docs/dist/css/bootstrap.min.css docs/dist/js/bootstrap.min.js docs/examples/blog/index.html docs/examples/carousel/index.html docs/examples/cover/index.html docs/examples/dashboard/index.html docs/examples/narrow-jumbotron/narrow-jumbotron.css docs/examples/navbar-fixed-top/index.html docs/examples/navbar-static-top/index.html docs/examples/non-responsive/index.html docs/examples/non-responsive/non-responsive.css docs/examples/theme/index.html grunt/configBridge.json js/affix.js js/carousel.js js/collapse.js js/dropdown.js js/modal.js js/popover.js js/scrollspy.js js/tab.js js/tests/unit/affix.js js/tests/unit/button.js js/tests/unit/carousel.js js/tests/unit/modal.js js/tests/unit/tooltip.js js/tooltip.js less/badges.less less/glyphicons.less less/type.less less/variables.less package.json scss/_dropdown.scss scss/_forms.scss test-infra/npm-shrinkwrap.json
2015-03-01 22:44:10 +01:00
## 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).
2015-03-11 20:19:22 +01:00
<div class="bd-example bd-example-images">
{% include icons/placeholder.svg width="200" height="200" class="rounded float-left" %}
{% include icons/placeholder.svg width="200" height="200" class="rounded float-right" %}
2015-03-11 20:19:22 +01:00
</div>
{% highlight html %}
<img src="..." class="rounded float-left" alt="...">
<img src="..." class="rounded float-right" alt="...">
2015-03-11 20:19:22 +01:00
{% endhighlight %}
<div class="bd-example bd-example-images">
{% include icons/placeholder.svg width="200" height="200" class="rounded mx-auto d-block" %}
2015-03-11 20:19:22 +01:00
</div>
{% highlight html %}
<img src="..." class="rounded mx-auto d-block" alt="...">
2015-03-11 20:19:22 +01:00
{% endhighlight %}
<div class="bd-example bd-example-images">
<div class="text-center">
{% include icons/placeholder.svg width="200" height="200" class="rounded" %}
2015-03-11 20:19:22 +01:00
</div>
</div>
{% highlight html %}
<div class="text-center">
<img src="..." class="rounded" alt="...">
2015-03-11 20:19:22 +01:00
</div>
{% 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 %}
<picture>
<source srcset="..." type="image/svg+xml">
<img src="..." class="img-fluid img-thumbnail" alt="...">
</picture>
{% endhighlight %}