Height
Define the height of elements depending on the viewport or match the heights of different elements.
Height
Define the height of elements depending on the viewport or match the heights of different elements.
UIkit’s Height component offers three options to set heights: using simple fixed height utility classes, depending on the viewport or by matching the heights of different elements.
Usage
UIkit provides a number of useful classes to alter an element’s height.
Class | Description |
---|---|
.uk-height-1-1 | This class applies a height of 100%. This only works if the parent element has a set height. |
.uk-height-small .uk-height-max-small | These classes apply a height or max-height of 150px. |
.uk-height-medium .uk-height-max-medium | These classes apply a height or max-height of 300px. |
.uk-height-large .uk-height-max-large | These classes apply a height or max-height of 450px. |
- SmallMediumLarge
<div class="uk-child-width-1-3@s" uk-grid> <div> <div class="uk-height-small uk-card uk-card-default uk-card-body uk-flex uk-flex-center uk-flex-middle">Small</div> </div> <div> <div class="uk-height-medium uk-card uk-card-default uk-card-body uk-flex uk-flex-center uk-flex-middle">Medium</div> </div> <div> <div class="uk-height-large uk-card uk-card-default uk-card-body uk-flex uk-flex-center uk-flex-middle">Large</div> </div> </div>
Viewport height
Add the uk-height-viewport
attribute to create a container that fills the height of the entire viewport. You can change the height behavior by adding the offset-top
, offset-bottom
or expand
option to the attribute. Learn more
Option | Value | Default | Description |
---|---|---|---|
offset-top | Boolean | false | Subtracts the element’s top offset from its height. |
offset-bottom | Boolean, Number, Pixel, CSS Selector | false | Subtracts the height (true) of the sibling that immediately follows the element, the given percentage (Number), Pixel (px) value from element’s own height or the given element’s height. |
expand | Boolean | false | Expands the element’s height to make a short page fill the viewport. |
min-height | Number | 0 | Sets a minimum height. Useful if all children are positioned absolute. |
You can view examples in the tests for Height Viewport and Height Expand.
Match height
To expand all children of a container to the same height regardless of their content, for example inside a grid, add the uk-height-match
attribute. You can change the height matching behavior by setting the target
or row
option to the attribute. Learn more
Option | Value | Default | Description |
---|---|---|---|
target | String | > * | Elements that should match. |
row | Boolean | true | By default only items in the same row will be matched. For example, once grid columns extend to a width of 100%, their heights will no longer be matched. This makes sense, for example, if they stack vertically in narrower viewports. |
target
is the Primary option, and its key may be omitted if it’s the only option in the attribute value.
Match cards
You can also target and match specific elements inside the container, like cards. Just add the target: SELECTOR
option to the attribute.
…
- Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.Lorem IpsumLorem ipsum dolor sit amet, consectetur adipiscing elit.Lorem Ipsum
<div class="uk-child-width-1-2@s" uk-grid uk-height-match="target: > div > .uk-card"> <div> <div class="uk-card uk-card-default uk-card-body">Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.</div> </div> <div> <div class="uk-card uk-card-default uk-card-body">Lorem Ipsum</div> </div> <div> <div class="uk-card uk-card-default uk-card-body">Lorem ipsum dolor sit amet, consectetur adipiscing elit.</div> </div> <div> <div class="uk-card uk-card-default uk-card-body">Lorem Ipsum</div> </div> </div>
Match all
If your grid wraps into multiple rows, only grid columns within the same row are matched. To match grid columns across all rows, just add the row: false
option to the attribute.
…
- Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.Lorem IpsumLorem ipsum dolor sit amet, consectetur adipiscing elit.Lorem Ipsum
<div class="uk-child-width-1-2@s" uk-grid uk-height-match="target: > div > .uk-card; row: false"> <div class="uk-first-column"> <div class="uk-card uk-card-default uk-card-body">Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.</div> </div> <div> <div class="uk-card uk-card-default uk-card-body">Lorem Ipsum</div> </div> <div class="uk-grid-margin uk-first-column"> <div class="uk-card uk-card-default uk-card-body">Lorem ipsum dolor sit amet, consectetur adipiscing elit.</div> </div> <div class="uk-grid-margin"> <div class="uk-card uk-card-default uk-card-body">Lorem Ipsum</div> </div> </div>
Component options
The table below lists the available settings of the uk-height-match
attribute. Learn more
Option | Value | Default | Description |
---|---|---|---|
target | CSS selector | > * | Elements that should match. By default, direct children will match. |
row | Boolean | true | If your targets wrap into multiple rows, only grid columns within the same row are matched. |
JavaScript
Learn more about JavaScript components.
Initialization
element, options;