transition
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2015.
The transition
CSS property is a shorthand property for transition-property
, transition-duration
, transition-timing-function
, transition-delay
, and transition-behavior
.
Try it
Transitions enable you to define the transition between two states of an element. Different states may be defined using pseudo-classes like :hover
or :active
or dynamically set using JavaScript.
Constituent properties
This property is a shorthand for the following CSS properties:
Syntax
/* Apply to 1 property */
/* property name | duration */
transition: margin-right 4s;
/* property name | duration | delay */
transition: margin-right 4s 1s;
/* property name | duration | easing function */
transition: margin-right 4s ease-in-out;
/* property name | duration | easing function | delay */
transition: margin-right 4s ease-in-out 1s;
/* property name | duration | behavior */
transition: display 4s allow-discrete;
/* Apply to 2 properties */
transition:
margin-right 4s,
color 1s;
/* Apply to all changed properties */
transition: all 0.5s ease-out allow-discrete;
transition: 200ms linear 50ms;
/* Global values */
transition: inherit;
transition: initial;
transition: revert;
transition: revert-layer;
transition: unset;
The transition
property value is specified as one of the following:
- The special value
none
, which specifies that no transitions will occur on this element. This is the default value. - One or more single-property transitions, separated by commas.
Each single-property transition describes the transition that should be applied to a single property or all properties. It includes:
- zero or one value representing the property or properties to which the transition should apply. This can be set as:
- A
<custom-ident>
representing a single property. - The special value
all
, which specifies that the transition will be applied to all properties that change as the element changes state. - No value, in which case a value of
all
will be inferred and the specified transition will still apply to all changing properties.
- A
- zero or one
<easing-function>
value representing the easing function to use - zero, one, or two
<time>
values. The first value that can be parsed as a time is assigned to thetransition-duration
, and the second value that can be parsed as a time is assigned totransition-delay
. - zero or one value declaring whether to start transitions for properties whose animation behavior is discrete. The value, if present, is either the keyword
allow-discrete
or the keywordnormal
.
If you specify all
as the transition property for one single-property transition, but then specify subsequent single-property transitions with <custom-ident>
values, those subsequent transitions will override the first one. For example:
transition:
all 200ms,
opacity 400ms;
In this case, all the properties that change as the element changes state will transition with a duration of 200ms except for opacity
, which will take 400ms to transition.
See how things are handled when lists of property values aren't the same length. In short, extra transition descriptions beyond the number of properties actually being animated are ignored.
Formal definition
Initial value | as each of the properties of the shorthand:
|
---|---|
Applies to | all elements, ::before and ::after pseudo-elements |
Inherited | no |
Computed value | as each of the properties of the shorthand:
|
Animation type | Not animatable |
Formal syntax
transition =
<single-transition>#
<single-transition> =
[ none | <single-transition-property> ] ||
<time> ||
<easing-function> ||
<time>
<single-transition-property> =
all |
<custom-ident>
<easing-function> =
<linear-easing-function> |
<cubic-bezier-easing-function> |
<step-easing-function>
<linear-easing-function> =
linear |
<linear()>
<cubic-bezier-easing-function> =
ease |
ease-in |
ease-out |
ease-in-out |
<cubic-bezier()>
<step-easing-function> =
step-start |
step-end |
<steps()>
<linear()> =
linear( [ <number> && <percentage>{0,2} ]# )
<cubic-bezier()> =
cubic-bezier( [ <number [0,1]> , <number> ]#{2} )
<steps()> =
steps( <integer> , <step-position>? )
<step-position> =
jump-start |
jump-end |
jump-none |
jump-both |
start |
end
Examples
Basic example
In this example, when the user hovers over the element, there is a half-second (500ms
) delay before a two-second background-color
transition occurs.
HTML
<a class="target">Hover over me</a>
CSS
We include two <time>
values. In the transition
shorthand, the first <time>
value is the transition-duration
. The second time value is the transition-delay
. Both default to 0s
if omitted.
.target {
font-size: 2rem;
background-color: palegoldenrod;
transition: background-color 2s 500ms;
}
.target:hover {
background-color: darkorange;
}
Specifications
Specification |
---|
CSS Transitions # transition-shorthand-property |
Browser compatibility
BCD tables only load in the browser