Module background_image

Module background_image 

Source
Expand description

Utilities for controlling an element’s background image.

Class Properties Preview
bg-nonebackground-image: none;
bg-gradient-to-tbackground-image: linear-gradient(to top in oklab, var(--en-gradient-stops));
bg-gradient-to-trbackground-image: linear-gradient(to top right in oklab, var(--en-gradient-stops));
bg-gradient-to-rbackground-image: linear-gradient(to right in oklab, var(--en-gradient-stops));
bg-gradient-to-brbackground-image: linear-gradient(to bottom right in oklab, var(--en-gradient-stops));
bg-gradient-to-bbackground-image: linear-gradient(to bottom in oklab, var(--en-gradient-stops));
bg-gradient-to-blbackground-image: linear-gradient(to bottom left in oklab, var(--en-gradient-stops));
bg-gradient-to-lbackground-image: linear-gradient(to left in oklab, var(--en-gradient-stops));
bg-gradient-to-tlbackground-image: linear-gradient(to top left in oklab, var(--en-gradient-stops));
bg-linear-to-tbackground-image: linear-gradient(to top in oklab, var(--en-gradient-stops));
bg-linear-to-trbackground-image: linear-gradient(to top right in oklab, var(--en-gradient-stops));
bg-linear-to-rbackground-image: linear-gradient(to right in oklab, var(--en-gradient-stops));
bg-linear-to-brbackground-image: linear-gradient(to bottom right in oklab, var(--en-gradient-stops));
bg-linear-to-bbackground-image: linear-gradient(to bottom in oklab, var(--en-gradient-stops));
bg-linear-to-blbackground-image: linear-gradient(to bottom left in oklab, var(--en-gradient-stops));
bg-linear-to-lbackground-image: linear-gradient(to left in oklab, var(--en-gradient-stops));
bg-linear-to-tlbackground-image: linear-gradient(to top left in oklab, var(--en-gradient-stops));
bg-linear-<integer>background-image: linear-gradient(<integer>deg in oklab, var(--en-gradient-stops));
bg-radialbackground-image: radial-gradient(in oklab, var(--en-gradient-stops));
bg-conicbackground-image: conic-gradient(in oklab, var(--en-gradient-stops));
bg-conic-<integer>background-image: conic-gradient(from <integer>deg in oklab, var(--en-gradient-stops));

§Interpolation modes

You can choose the interpolation mode used by each background having a gradient by prefixing the class with /<interpolation_mode>, e.g bg-linear-to-r/hsl or bg-radial/increasing.

The following interpolation modes are available:

Interpolation mode CSS argument used Preview
srgbsrgb
hslhsl
oklaboklab
oklchoklch
longeroklch longer hue
shorteroklch shorter hue
increasingoklch increasing hue
decreasingoklch decreasing hue

§Arbitrary values

Any <image> property is allowed as arbitrary value for bg-. For example, bg-[url('/hello.png')].

Any property is allowed as arbitrary value for bg-linear-. For example, bg-linear-[to_bottom_#fff,#000].

Any property is allowed as arbitrary value for bg-radial-. For example, bg-radial-[at_25%_25%].

Any property is allowed as arbitrary value for bg-conic-. For example, bg-conic-[from_22deg_in_oklab,#fff,#000].

Because the default scanner splits by some special characters, you must use the following escape codes in arbitrary values:

  • &#34; for "
  • &#39; for '
  • &#40; for (
  • &#41; for )
  • &#91; for [
  • &#92; for \
  • &#93; for ]
  • &#95; for _ (because by default _ is replaced by a space in arbitrary values, so &#95; prevents this behavior)
  • &#96; for `

Tailwind reference