Migration

Migration from UIkit 2.7 to 2.8

Gloss 2.8 renames the top and bottom options to start and end in the Sticky component.

Option Replace with
top start
bottom end

It also deprecates the position: auto option from the Sticky component. Simply use the new overflow-flip: true options instead.

Option Replace with
position: auto overflow-flip: true

Migration from Gloss 2.6 to 2.7

Gloss 2.7 deprecates gls-img from the Image component for the <img> element. Simply use the native loading="lazy" attribute instead. This also applies if gls-img is used to target adjacent slides within Slideshows or Sliders. Both components, Slideshow and Slider, work with lazy loading images out of the box.

Attribute Replace with
gls-img loading="lazy"

Important This change also requires <img> elements to have width and height attributes to prevent layout shifts.

Migration from Gloss 2.5 to 2.6

Gloss 2.6 adds new start and end options to the Parallax component and deprecates the viewport option. Replace the viewport option with the end option. Simply calculate 1 minus your viewport value and multiply it by 100vh + 100%. Here are some examples:

Viewport Value End Value
0.6 40vh + 40%
0.5 50vh + 50%
0.3 70vh + 70%

Migration from Gloss 2.0 to 2.1

In Gloss 2.1 all Less variables and class names which have xxlarge in their name got renamed to 2xlarge for better consistency. Just find and replace these Less variables if you are using a custom Less theme. There is just one class in the Width component which has to be updated in your markup.

Class Replace with
gls-width-xxlarge gls-width-2xlarge

Heading Component

The Primary and Hero classes in the Heading component are deprecated. Update your markup by replacing the following classes.

Class Replace with
gls-heading-primary gls-heading-medium
gls-heading-hero gls-heading-xlarge