diff options
Diffstat (limited to 'site/content/docs/4.3/components/media-object.md')
| -rw-r--r-- | site/content/docs/4.3/components/media-object.md | 128 |
1 files changed, 128 insertions, 0 deletions
diff --git a/site/content/docs/4.3/components/media-object.md b/site/content/docs/4.3/components/media-object.md new file mode 100644 index 0000000000..3f558c7af9 --- /dev/null +++ b/site/content/docs/4.3/components/media-object.md @@ -0,0 +1,128 @@ +--- +layout: docs +title: Media object +description: Documentation and examples for Bootstrap's media object to construct highly repetitive components like blog comments, tweets, and the like. +group: components +toc: true +--- + +## Example + +The [media object](http://www.stubbornella.org/content/2010/06/25/the-media-object-saves-hundreds-of-lines-of-code/) helps build complex and repetitive components where some media is positioned alongside content that doesn't wrap around said media. Plus, it does this with only two required classes thanks to flexbox. + +Below is an example of a single media object. Only two classes are required—the wrapping `.media` and the `.media-body` around your content. Optional padding and margin can be controlled through [spacing utilities](/docs/{{< param docs_version >}}/utilities/spacing/). + +{{< example >}} +<div class="media"> + {{< placeholder width="64" height="64" class="mr-3" >}} + <div class="media-body"> + <h5 class="mt-0">Media heading</h5> + Cras sit amet nibh libero, in gravida nulla. Nulla vel metus scelerisque ante sollicitudin. Cras purus odio, vestibulum in vulputate at, tempus viverra turpis. Fusce condimentum nunc ac nisi vulputate fringilla. Donec lacinia congue felis in faucibus. + </div> +</div> +{{< /example >}} + +## Nesting + +Media objects can be infinitely nested, though we suggest you stop at some point. Place nested `.media` within the `.media-body` of a parent media object. + +{{< example >}} +<div class="media"> + {{< placeholder width="64" height="64" class="mr-3" >}} + <div class="media-body"> + <h5 class="mt-0">Media heading</h5> + Cras sit amet nibh libero, in gravida nulla. Nulla vel metus scelerisque ante sollicitudin. Cras purus odio, vestibulum in vulputate at, tempus viverra turpis. Fusce condimentum nunc ac nisi vulputate fringilla. Donec lacinia congue felis in faucibus. + + <div class="media mt-3"> + <a class="mr-3" href="#"> + {{< placeholder width="64" height="64" >}} + </a> + <div class="media-body"> + <h5 class="mt-0">Media heading</h5> + Cras sit amet nibh libero, in gravida nulla. Nulla vel metus scelerisque ante sollicitudin. Cras purus odio, vestibulum in vulputate at, tempus viverra turpis. Fusce condimentum nunc ac nisi vulputate fringilla. Donec lacinia congue felis in faucibus. + </div> + </div> + </div> +</div> +{{< /example >}} + +## Alignment + +Media in a media object can be aligned with flexbox utilities to the top (default), middle, or end of your `.media-body` content. + +{{< example >}} +<div class="media"> + {{< placeholder width="64" height="64" class="align-self-start mr-3" >}} + <div class="media-body"> + <h5 class="mt-0">Top-aligned media</h5> + <p>Cras sit amet nibh libero, in gravida nulla. Nulla vel metus scelerisque ante sollicitudin. Cras purus odio, vestibulum in vulputate at, tempus viverra turpis. Fusce condimentum nunc ac nisi vulputate fringilla. Donec lacinia congue felis in faucibus.</p> + <p>Donec sed odio dui. Nullam quis risus eget urna mollis ornare vel eu leo. Cum sociis natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus.</p> + </div> +</div> +{{< /example >}} + +{{< example >}} +<div class="media"> + {{< placeholder width="64" height="64" class="align-self-center mr-3" >}} + <div class="media-body"> + <h5 class="mt-0">Center-aligned media</h5> + <p>Cras sit amet nibh libero, in gravida nulla. Nulla vel metus scelerisque ante sollicitudin. Cras purus odio, vestibulum in vulputate at, tempus viverra turpis. Fusce condimentum nunc ac nisi vulputate fringilla. Donec lacinia congue felis in faucibus.</p> + <p class="mb-0">Donec sed odio dui. Nullam quis risus eget urna mollis ornare vel eu leo. Cum sociis natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus.</p> + </div> +</div> +{{< /example >}} + +{{< example >}} +<div class="media"> + {{< placeholder width="64" height="64" class="align-self-end mr-3" >}} + <div class="media-body"> + <h5 class="mt-0">Bottom-aligned media</h5> + <p>Cras sit amet nibh libero, in gravida nulla. Nulla vel metus scelerisque ante sollicitudin. Cras purus odio, vestibulum in vulputate at, tempus viverra turpis. Fusce condimentum nunc ac nisi vulputate fringilla. Donec lacinia congue felis in faucibus.</p> + <p class="mb-0">Donec sed odio dui. Nullam quis risus eget urna mollis ornare vel eu leo. Cum sociis natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus.</p> + </div> +</div> +{{< /example >}} + +## Order + +Change the order of content in media objects by modifying the HTML itself, or by adding some custom flexbox CSS to set the `order` property (to an integer of your choosing). + +{{< example >}} +<div class="media"> + <div class="media-body"> + <h5 class="mt-0 mb-1">Media object</h5> + Cras sit amet nibh libero, in gravida nulla. Nulla vel metus scelerisque ante sollicitudin. Cras purus odio, vestibulum in vulputate at, tempus viverra turpis. Fusce condimentum nunc ac nisi vulputate fringilla. Donec lacinia congue felis in faucibus. + </div> + {{< placeholder width="64" height="64" class="ml-3" >}} +</div> +{{< /example >}} + +## Media list + +Because the media object has so few structural requirements, you can also use these classes on list HTML elements. On your `<ul>` or `<ol>`, add the `.list-unstyled` to remove any browser default list styles, and then apply `.media` to your `<li>`s. As always, use spacing utilities wherever needed to fine tune. + +{{< example >}} +<ul class="list-unstyled"> + <li class="media"> + {{< placeholder width="64" height="64" class="mr-3" >}} + <div class="media-body"> + <h5 class="mt-0 mb-1">List-based media object</h5> + Cras sit amet nibh libero, in gravida nulla. Nulla vel metus scelerisque ante sollicitudin. Cras purus odio, vestibulum in vulputate at, tempus viverra turpis. Fusce condimentum nunc ac nisi vulputate fringilla. Donec lacinia congue felis in faucibus. + </div> + </li> + <li class="media my-4"> + {{< placeholder width="64" height="64" class="mr-3" >}} + <div class="media-body"> + <h5 class="mt-0 mb-1">List-based media object</h5> + Cras sit amet nibh libero, in gravida nulla. Nulla vel metus scelerisque ante sollicitudin. Cras purus odio, vestibulum in vulputate at, tempus viverra turpis. Fusce condimentum nunc ac nisi vulputate fringilla. Donec lacinia congue felis in faucibus. + </div> + </li> + <li class="media"> + {{< placeholder width="64" height="64" class="mr-3" >}} + <div class="media-body"> + <h5 class="mt-0 mb-1">List-based media object</h5> + Cras sit amet nibh libero, in gravida nulla. Nulla vel metus scelerisque ante sollicitudin. Cras purus odio, vestibulum in vulputate at, tempus viverra turpis. Fusce condimentum nunc ac nisi vulputate fringilla. Donec lacinia congue felis in faucibus. + </div> + </li> +</ul> +{{< /example >}} |