aboutsummaryrefslogtreecommitdiff
path: root/docs/4.1/utilities/embed.md
diff options
context:
space:
mode:
authorMark Otto <[email protected]>2018-04-09 09:00:23 -0700
committerGitHub <[email protected]>2018-04-09 09:00:23 -0700
commit8f7bd419935adfcd53c471a0202083464800619e (patch)
treed0e6ab018a0f41b59a1206cf72ffc79a474e69b9 /docs/4.1/utilities/embed.md
parent91730a644f107ca80a747a6f7f0c173eca5708fa (diff)
downloadbootstrap-4.1.0.tar.xz
bootstrap-4.1.0.zip
Ship v4.1.0 (#26218)v4.1.0
* update docs path from docs/4.0/ to docs/4.1/ * bump version to 4.1.0 * Update redirects to work for 4.1 docs move * Update docs version switcher to include latest and link to 4.0 docs * re-run dist * Update package-lock.json * Update docs-navbar.html
Diffstat (limited to 'docs/4.1/utilities/embed.md')
-rw-r--r--docs/4.1/utilities/embed.md50
1 files changed, 50 insertions, 0 deletions
diff --git a/docs/4.1/utilities/embed.md b/docs/4.1/utilities/embed.md
new file mode 100644
index 000000000..4713c598c
--- /dev/null
+++ b/docs/4.1/utilities/embed.md
@@ -0,0 +1,50 @@
+---
+layout: docs
+title: Embeds
+description: Create responsive video or slideshow embeds based on the width of the parent by creating an intrinsic ratio that scales on any device.
+group: utilities
+toc: true
+---
+
+## About
+
+Rules are directly applied to `<iframe>`, `<embed>`, `<video>`, and `<object>` elements; optionally use an explicit descendant class `.embed-responsive-item` when you want to match the styling for other attributes.
+
+**Pro-Tip!** You don't need to include `frameborder="0"` in your `<iframe>`s as we override that for you.
+
+## Example
+
+Wrap any embed like an `<iframe>` in a parent element with `.embed-responsive` and an aspect ratio. The `.embed-responsive-item` isn't strictly required, but we encourage it.
+
+{% capture example %}
+<div class="embed-responsive embed-responsive-16by9">
+ <iframe class="embed-responsive-item" src="https://www.youtube.com/embed/zpOULjyy-n8?rel=0" allowfullscreen></iframe>
+</div>
+{% endcapture %}
+{% include example.html content=example %}
+
+## Aspect ratios
+
+Aspect ratios can be customized with modifier classes.
+
+{% highlight html %}
+<!-- 21:9 aspect ratio -->
+<div class="embed-responsive embed-responsive-21by9">
+ <iframe class="embed-responsive-item" src="..."></iframe>
+</div>
+
+<!-- 16:9 aspect ratio -->
+<div class="embed-responsive embed-responsive-16by9">
+ <iframe class="embed-responsive-item" src="..."></iframe>
+</div>
+
+<!-- 4:3 aspect ratio -->
+<div class="embed-responsive embed-responsive-4by3">
+ <iframe class="embed-responsive-item" src="..."></iframe>
+</div>
+
+<!-- 1:1 aspect ratio -->
+<div class="embed-responsive embed-responsive-1by1">
+ <iframe class="embed-responsive-item" src="..."></iframe>
+</div>
+{% endhighlight %}