Documentation
IntroductionLayout
Text
- Accordion
- Alert
- Animation
- Align
- Badge
- Base
- Breadcrumb
- Button
- Card
- Close
- Comment
- Description List
- Divider
- Dotnav
- Drop
- Dropdown
- Filter
- Form
- Height
- Icon
- Iconnav
- Image
- Inverse
- Label
- Leader
- Lightbox
- Link
- List
- Margin
- Marker
- Modal
- Nav
- Navbar
- Notification
- Off-canvas
- Overlay
- Padding
- Pagination
- Parallax
- Placeholder
- Position
- Print
- Progress
- Scroll
- Scrollspy
- Search
- Section
- Slidenav
- Slider
- Slideshow
- Sortable
- Spinner
- Sticky
- Subnav
- SVG
- Switcher
- Tab
- Table
- Thumbnav
- Tile
- Toggle
- Tooltip
- Totop
- Transition
- Upload
- Utility
- Video
- Visibility
Cover
Expand images, videos or iframes to cover their entire container and place your own content on top.
Usage
To have an image cover its parent element, add the .uk-cover-container
class to the parent and the uk-cover
attribute to the image.
<div class="uk-cover-container">
<img src="" alt="" uk-cover>
</div>
Note To position content on top of the covering element, use the Position component. To adapt your content for better visibility, add the .uk-light
or .uk-dark
class from the Inverse component.
<div class="uk-cover-container uk-height-medium">
<img src="images/dark.jpg" alt="" uk-cover>
</div>
Video
To create a video that covers its parent container, add the uk-cover
attribute to a video. Wrap a container element around the video and add the .uk-cover-container
class to clip the content.
The Cover component inherits all properties from the Video component which means videos are muted and play automatically. The video will pause whenever it’s not visible and resume once it becomes visible again.
<div class="uk-cover-container">
<video uk-cover></video>
</div>
<div class="uk-cover-container uk-height-medium">
<video src="https://yootheme.com/site/images/media/yootheme-pro.mp4" autoplay loop muted playsinline uk-cover></video>
</div>
Iframe
To apply the Cover component to an iframe, you need to add the uk-cover
attribute to the iframe. Now add the .uk-cover-container
class to a container element around the iframe to clip the content.
<div class="uk-cover-container">
<iframe src="" uk-cover></iframe>
</div>
<div class="uk-cover-container uk-height-medium">
<iframe src="https://www.youtube-nocookie.com/embed/c2pz2mlSfXA?autoplay=1&controls=0&showinfo=0&rel=0&loop=1&modestbranding=1&wmode=transparent" width="1920" height="1080" frameborder="0" allowfullscreen uk-cover></iframe>
</div>
Responsive height
To add responsive behavior to your cover image, you need to create an invisible <canvas>
element and assign width
and height
values to it, according to the aspect ratio you want the covered area to have. That way it will adapt the responsive behavior of the image.
<div class="uk-cover-container">
<canvas width="" height=""></canvas>
<img src="" alt="" uk-cover>
</div>
<div class="uk-cover-container">
<canvas width="400" height="200"></canvas>
<img src="images/dark.jpg" alt="" uk-cover>
</div>
Viewport height
Adding the uk-height-viewport
attribute from the Height component will stretch the height of the parent element to fill the whole viewport.
<div class="uk-cover-container" uk-height-viewport>
<img src="" alt="" uk-cover>
</div>
Component options
Any of these options can be applied to the component attribute. Separate multiple options with a semicolon. Learn more
Option | Value | Default | Description |
---|---|---|---|
automute |
Boolean | true | Tries to automute the iframe’s video. |
width |
Number | undefined | The element’s width. |
height |
Number | undefined | The element’s height. |
JavaScript
Learn more about JavaScript components.
Initialization
UIkit.cover(element, options);