Box shadow CSS property
Learn how to animate a custom CSS box-shadow or use a built-in variants
Overview
Create engaging CSS box-shadow animations using the standard CSS box-shadow
property. With TorusKit, you can also access predefined shadow
aliases like sm
, md
, lg
, and xl
to quickly add shadow effects of varying intensity. These shortcuts make it simple to apply CSS shadow effects
without manually defining each parameter.
Syntax
To animate box-shadow properties effectively, follow the box-shadow syntax. Ensure that all parameters—x
, y
offsets, blur
, spread
, and color—are
included to achieve the desired effect with TorusKit’s box-shadow animations.
Default usage
For a basic CSS box-shadow animation, define shadow properties within your TorusKit setup. You can use either the full box-shadow
syntax or the shorthand bs
format to specify all shadow parameters.
Alias
For added convenience, TorusKit includes built-in shadow
aliases, making it easier to achieve CSS shadow effects with specific blur levels. These variants (sm
, md
, lg
, xl
) save time by allowing quick access to preset shadow options.
Definition
Use the following syntax to apply a predefined CSS shadow variant quickly.
Variants
See each box-shadow variant in action here:
Examples
The examples below demonstrate how to use various box-shadow
properties with TorusKit. While these examples use the hover
or animate
trigger, you can apply any other trigger that is available.
Initial value
To start an element’s box-shadow animation from a particular style, define an initial CSS shadow effect. Since TorusKit processes elements before rendering, there’s no Flash of unstyled content, so styles load instantly.
Discrete timeline
Using a discrete timeline for CSS box-shadow animation requires only an initial value (optional) and a final value. In this example, the box-shadow property is animated to 0rem 1rem 2rem 0rem #ff00a9
. If no initial value is set, TorusKit defaults to the element’s current CSS style.
Sequenced timeline
A sequenced timeline allows CSS shadow effects to change in a specific order—sequence of steps. In this example, we animate box-shadow
properties across multiple steps with different colors (hex, rgba, and hsla) for a gradual box-shadow animation.
Offset timeline
An offset timeline defines animation steps by percentage offsets, providing another method for animating box-shadow. This example animates box-shadow
properties across offsets for a smooth sequence.
In this case, we have omitted the first step with an offset of 0%
, which is typically used to set the initial values for all properties. As a result, TorusKit retrieves the initial values from the current element’s style.