Background Effects

  • bg-effects

Usage

  1. Use the class bg-effects to activate the background styles.
  2. Add the following CSS variables to the Element’s Custom CSS Box
--background-transform: scale(1.1);
--background-hover-transform: scale(1);
--background-filter: blur(0px) saturate(0);
--background-hover-filter: blur(3px) saturate(1);
--transition-duration: 1s;

–background-transform and –background-hover-transform options:

Value Description
matrix(n,n,n,n,n,n) Defines a 2D transformation, using a matrix of six values
matrix3d
(n,n,n,n,n,n,n,n,n,n,n,n,n,n,n,n)
Defines a 3D transformation, using a 4×4 matrix of 16 values
translate(x,y) Defines a 2D translation
translate3d(x,y,z) Defines a 3D translation
translateX(x) Defines a translation, using only the value for the X-axis
translateY(y) Defines a translation, using only the value for the Y-axis
translateZ(z) Defines a 3D translation, using only the value for the Z-axis
scale(x,y) Defines a 2D scale transformation
scale3d(x,y,z) Defines a 3D scale transformation
scaleX(x) Defines a scale transformation by giving a value for the X-axis
scaleY(y) Defines a scale transformation by giving a value for the Y-axis
scaleZ(z) Defines a 3D scale transformation by giving a value for the Z-axis
rotate(angle) Defines a 2D rotation, the angle is specified in the parameter
rotate3d(x,y,z,angle) Defines a 3D rotation
rotateX(angle) Defines a 3D rotation along the X-axis
rotateY(angle) Defines a 3D rotation along the Y-axis
rotateZ(angle) Defines a 3D rotation along the Z-axis
skew(x-angle,y-angle) Defines a 2D skew transformation along the X- and the Y-axis
skewX(angle) Defines a 2D skew transformation along the X-axis
skewY(angle) Defines a 2D skew transformation along the Y-axis
perspective(n) Defines a perspective view for a 3D transformed element

–background-filter and –background-hover-filter options:

Filter Description
blur(px)

Applies a blur effect to the image. A larger value will create more blur.

If no value is specified, 0 is used.

brightness(%)

Adjusts the brightness of the image.

0% will make the image completely black.
100% (1) is default and represents the original image.
Values over 100% will provide brighter results.

contrast(%)

Adjusts the contrast of the image.

0% will make the image completely black.
100% (1) is default, and represents the original image.
Values over 100% will provide results with more contrast.

drop-shadow(h-shadow v-shadow blur spread color)

Applies a drop shadow effect to the image.

Possible values:
h-shadow – Required. Specifies a pixel value for the horizontal shadow. Negative values place the shadow to the left of the image.

v-shadow – Required. Specifies a pixel value for the vertical shadow. Negative values place the shadow above the image.

blur – Optional. This is the third value, and must be in pixels. Adds a blur effect to the shadow. A larger value will create more blur (the shadow becomes bigger and lighter). Negative values are not allowed. If no value is specified, 0 is used (the shadow’s edge is sharp).

spread – Optional. This is the fourth value, and must be in pixels. Positive values will cause the shadow to expand and grow bigger, and negative values will cause the shadow to shrink. If not specified, it will be 0 (the shadow will be the same size as the element).
Note: Chrome, Safari and Opera, and maybe other browsers, do not support this 4th length; it will not render if added.

color – Optional. Adds a color to the shadow. If not specified, the color depends on the browser (often black).

An example of creating a red shadow, which is 8px big both horizontally and vertically, with a blur effect of 10px:

filter: drop-shadow(8px 8px 10px red);

grayscale(%)

Converts the image to grayscale.

0% (0) is default and represents the original image.
100% will make the image completely gray (used for black and white images).

Note: Negative values are not allowed.

hue-rotate(deg)

Applies a hue rotation on the image. The value defines the number of degrees around the color circle the image samples will be adjusted. 0deg is default, and represents the original image.

Note: Maximum value is 360deg.

invert(%)

Inverts the samples in the image.

0% (0) is default and represents the original image.
100% will make the image completely inverted.

Note: Negative values are not allowed.

opacity(%)

Sets the opacity level for the image. The opacity-level describes the transparency-level, where:

0% is completely transparent.
100% (1) is default and represents the original image (no transparency).

Note: Negative values are not allowed.

saturate(%)

Saturates the image.

0% (0) will make the image completely un-saturated.
100% is default and represents the original image.
Values over 100% provides super-saturated results.

Note: Negative values are not allowed.

sepia(%)

Converts the image to sepia.

0% (0) is default and represents the original image.
100% will make the image completely sepia.

Note: Negative values are not allowed.

url()

The url() function takes the location of an XML file that specifies an SVG filter, and may include an anchor to a specific filter element. Example:

filter: url(svg-url#element-id)

Examples

bg-effects

–background-transform:scale(1.05);
–background-hover-transform:scale(1.0);
–background-filter:brightness(1) blur(0px);
–background-hover-filter:brightness(0.5) blur(3px);

bg-effects

–background-transform:scale(1.1);
–background-hover-transform:scale(3.5);
–background-filter:blur(1.1) brightness(1) saturate(1) hue-rotate(0deg);
–background-hover-filter:blur(5px) brightness(0.5) saturate(5) hue-rotate(35deg);

bg-hover gradient-overlay

–background-transform:scale(1.05);
–background-hover-transform:scale(1.0);
–background-filter:brightness(1) blur(0px) saturate(0);
–background-hover-filter:brightness(0.5) blur(3px);

bg-hover gradient-overlay

–background-transform:scale(1.5);
–background-hover-transform:scale(1.0);
–background-filter:blur(1.1) brightness(1) saturate(1) hue-rotate(0deg);
–background-hover-filter:blur(5px) brightness(0.8) saturate(5) hue-rotate(35deg);

bg-effects

–background-transform:scale(1.05);
–background-hover-transform:scale(10.0);
–background-filter:brightness(0.8);
–background-hover-filter:brightness(0);

bg-effects

–background-transform:translateY(100px) scale(2);
–background-hover-transform:translateY(0px) scale(2);
–transition-duration:1s;