The cascade is an algorithm that defines how to combine property values originating from different sources. It lies at the core of CSS, as emphasized by the name: Cascading Style Sheets. This article explains what the cascade is, the order in which CSS declarations cascade, and how this affects you, the web developer.
Only CSS declarations, that is property/value pairs, participate in the cascade. This means that at-rules containing entities other than declarations, such as a @font-face
rule containing descriptors, don't participate in the cascade. In these cases, only the at-rule as a whole participates in the cascade: here, the @font-face
identified by its font-family
descriptor. If several @font-face
rules with the same descriptor are defined, only the most appropriate @font-face
, as a whole, is considered.
While the declarations contained in most at-rules — such as those in @media
, @document
, or @supports
— participate in the cascade, declarations contained in @keyframes
don't. As with @font-face
, only the at-rule as a whole is selected via the cascade algorithm.
Finally, note that @import
and @charset
obey specific algorithms and aren't affected by the cascade algorithm.
The CSS cascade algorithm's job is to select CSS declarations in order to determine the correct values for CSS properties. CSS declarations originate from different origins: the User-agent stylesheets, the Author stylesheets, and the User stylesheets.
Though style sheets come from these different origins, they overlap in scope; to make this work, the cascade algorithm defines how they interact.
The browser has a basic style sheet that gives a default style to any document. These style sheets are named user-agent stylesheets. Some browsers use actual style sheets for this purpose, while others simulate them in code, but the end result is the same.
Some browsers let users modify the user-agent stylesheet. Although some constraints on user-agent stylesheets are set by the HTML specification, browsers still have a lot of latitude: that means that significant differences exist from one browser to another. To simplify the development process, Web developers often use a CSS reset style sheet, forcing common properties values to a known state before beginning to make alterations to suit their specific needs.
Author stylesheets are the most common type of style sheet. These are style sheets that define styles as part of the design of a given web page or site. The author of the page defines the styles for the document using one or more stylesheets, which define the look and feel of the website — its theme.
The user (or reader) of the web site can choose to override styles in many browsers using a custom user stylesheet designed to tailor the experience to the user's wishes.
This feature was never implemented outside of Gecko, where it was only ever used for the non-standard XBL stylesheets.
The cascading algorithm determines how to find the value to apply for each property for each document element.
!important
, and by their origin. The cascade is in ascending order, which means that !important
values from a user-defined style sheet have precedence over normal values originated from a user-agent style sheet: Origin | Importance | |
---|---|---|
1 | CSS Transitions | see below |
2 | user agent | normal |
3 | user | normal |
override | normal | |
4 | author | normal |
5 | CSS Animations | see below |
override | !important | |
6 | author | !important |
7 | user | !important |
8 | user agent | !important |
After your content has finished altering styles, it may find itself in a situation where it needs to restore them to a known state. This may happen in cases of animations, theme changes, and so forth. The CSS property all
lets you quickly set (almost) everything in CSS back to a known state.
all
lets you opt to immediately restore all properties to any of their initial (default) state, the state inherited from the previous level of the cascade, a specific origin (the user-agent stylesheet, the author stylesheet, or the user stylesheet), or even to clear the values of the properties entirely.
CSS animations, using @keyframes
at-rules, define animations between states. Keyframes don't cascade, meaning that at any given time CSS takes values from only one single @keyframes
, and never mixes multiple ones together.
When several keyframes are appropriate, it chooses the latest defined in the most important document, but never combined all together.
Also note that values within @keyframes
at-rules overwrite all normal values but are overwritten by !important
values.
Let's look at an example involving multiple sources of CSS across the various origins; here we have a user agent style sheet, two author style sheets, a user stylesheet, and inline styles within the HTML:
User-agent CSS:
li { margin-left: 10px }
Author CSS 1:
li { margin-left: 0 } /* This is a reset */
Author CSS 2:
@media screen { li { margin-left: 3px } } @media print { li { margin-left: 1px } }
User CSS:
.specific { margin-left: 1em }
HTML:
<ul> <li class="specific">1<sup>st</sup></li> <li>2<sup>nd</sup></li> </ul>
In this case, declarations inside li
and .specific
rules should apply. No declaration is marked as !important
, so the precedence order is author style sheets before user style sheets or user-agent stylesheet.
So three declarations are in competition:
margin-left: 0
margin-left: 3px
margin-left: 1px
The last one is ignored (on a screen), and the first two have the same selector, hence the same specificity. Therefore, it is the last one that is then selected:
margin-left: 3px
Note that the declaration defined in the user CSS, though having a greater specifity, is not chosen as the cascade algorithm is applied before the specifity algorithm.
Specification | Status | Comment |
---|---|---|
CSS Cascading and Inheritance Level 4 | Candidate Recommendation | Added the revert keyword, which allows rolling a property back a cascade level. |
CSS Cascading and Inheritance Level 3 | Candidate Recommendation | Removed the override cascade origin, as it was never used in a W3C standard. |
CSS Level 2 (Revision 1) The definition of 'the cascade' in that specification. | Recommendation | |
Document Object Model (DOM) Level 2 Style Specification The definition of 'override cascade origin' in that specification. | Obsolete | Defined the override cascade origin, but didn't elaborate further. |
CSS Level 1 The definition of 'the cascade' in that specification. | Recommendation | Initial definition. |
© 2005–2018 Mozilla Developer Network and individual contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/CSS/Cascade