CINXE.COM
CSS Cascading and Inheritance Level 5
<!doctype html><html lang="en"> <head> <meta content="text/html; charset=utf-8" http-equiv="Content-Type"> <meta content="width=device-width, initial-scale=1, shrink-to-fit=no" name="viewport"> <title>CSS Cascading and Inheritance Level 5</title> <meta content="ED" name="w3c-status"> <link href="https://www.w3.org/StyleSheets/TR/2021/W3C-ED" rel="stylesheet"> <link href="https://www.w3.org/2008/site/images/favicon.ico" rel="icon"> <meta content="Bikeshed version 9559857, updated Fri Jul 29 17:25:02 2022 -0700" name="generator"> <link href="https://www.w3.org/TR/css-cascade-5/" rel="canonical"> <link href="https://drafts.csswg.org/csslogo.ico" rel="icon"> <style>/* style-autolinks */ .css.css, .property.property, .descriptor.descriptor { color: var(--a-normal-text); font-size: inherit; font-family: inherit; } .css::before, .property::before, .descriptor::before { content: "‘"; } .css::after, .property::after, .descriptor::after { content: "’"; } .property, .descriptor { /* Don't wrap property and descriptor names */ white-space: nowrap; } .type { /* CSS value <type> */ font-style: italic; } pre .property::before, pre .property::after { content: ""; } [data-link-type="property"]::before, [data-link-type="propdesc"]::before, [data-link-type="descriptor"]::before, [data-link-type="value"]::before, [data-link-type="function"]::before, [data-link-type="at-rule"]::before, [data-link-type="selector"]::before, [data-link-type="maybe"]::before { content: "‘"; } [data-link-type="property"]::after, [data-link-type="propdesc"]::after, [data-link-type="descriptor"]::after, [data-link-type="value"]::after, [data-link-type="function"]::after, [data-link-type="at-rule"]::after, [data-link-type="selector"]::after, [data-link-type="maybe"]::after { content: "’"; } [data-link-type].production::before, [data-link-type].production::after, .prod [data-link-type]::before, .prod [data-link-type]::after { content: ""; } [data-link-type=element], [data-link-type=element-attr] { font-family: Menlo, Consolas, "DejaVu Sans Mono", monospace; font-size: .9em; } [data-link-type=element]::before { content: "<" } [data-link-type=element]::after { content: ">" } [data-link-type=biblio] { white-space: pre; }</style> <style>/* style-caniuse-panel */ :root { --caniuse-shadow: #999; --caniuse-nosupport-text: #ccc; --caniuse-partialsupport-text: #666; } .caniuse-status { font: 1em sans-serif; width: 9em; padding: 0.3em; position: absolute; z-index: 8; top: auto; right: 0.3em; background: var(--borderedblock-bg, #EEE); color: var(--text, black); box-shadow: 0 0 3px var(--caniuse-shadow, #999); overflow: hidden; border-collapse: initial; border-spacing: initial; } .caniuse-status.wrapped { width: auto; height: 1em; } .caniuse-status.wrapped > :not(input) { display: none; } .caniuse-status > input { float: right; border: none; background: transparent; padding: 0; margin: 0; } .caniuse-status > p { font-size: 0.6em; margin: 0; padding: 0; clear: both; } .caniuse-status > p + p { padding-top: 0.5em; } .caniuse-status > .support { display: block; } .caniuse-status > .support > span { padding: 0.2em 0; display: block; display: table; } .caniuse-status > .support > span.partial { color: var(--caniuse-partialsupport-text, #666666); filter: grayscale(50%); } .caniuse-status > .support > span.no { color: var(--caniuse-nosupport-text, #CCCCCC); filter: grayscale(100%); } .caniuse-status > .support > span.no::before { opacity: 0.5; } .caniuse-status > .support > span:first-of-type { padding-top: 0.5em; } .caniuse-status > .support > span > span { padding: 0 0.5em; display: table-cell; vertical-align: top; } .caniuse-status > .support > span > span:first-child { width: 100%; } .caniuse-status > .support > span > span:last-child { width: 100%; white-space: pre; padding: 0; } .caniuse-status > .support > span::before { content: ' '; display: table-cell; min-width: 1.5em; height: 1.5em; background: no-repeat center center; background-size: contain; text-align: right; font-size: 0.75em; font-weight: bold; } .caniuse-status > .support > .and_chr::before { background-image: url(https://resources.whatwg.org/browser-logos/chrome.svg); } .caniuse-status > .support > .and_ff::before { background-image: url(https://resources.whatwg.org/browser-logos/firefox.png); } .caniuse-status > .support > .and_uc::before { background-image: url(https://resources.whatwg.org/browser-logos/uc.png); } /* UC Browser for Android */ .caniuse-status > .support > .android::before { background-image: url(https://resources.whatwg.org/browser-logos/android.svg); } .caniuse-status > .support > .bb::before { background-image: url(https://resources.whatwg.org/browser-logos/bb.jpg); } /* Blackberry Browser */ .caniuse-status > .support > .chrome::before { background-image: url(https://resources.whatwg.org/browser-logos/chrome.svg); } .caniuse-status > .support > .edge::before { background-image: url(https://resources.whatwg.org/browser-logos/edge.svg); } .caniuse-status > .support > .firefox::before { background-image: url(https://resources.whatwg.org/browser-logos/firefox.png); } .caniuse-status > .support > .ie::before { background-image: url(https://resources.whatwg.org/browser-logos/ie.png); } .caniuse-status > .support > .ie_mob::before { background-image: url(https://resources.whatwg.org/browser-logos/ie-mobile.svg); } .caniuse-status > .support > .ios_saf::before { background-image: url(https://resources.whatwg.org/browser-logos/safari-ios.svg); } .caniuse-status > .support > .op_mini::before { background-image: url(https://resources.whatwg.org/browser-logos/opera-mini.png); } .caniuse-status > .support > .op_mob::before { background-image: url(https://resources.whatwg.org/browser-logos/opera.svg); } .caniuse-status > .support > .opera::before { background-image: url(https://resources.whatwg.org/browser-logos/opera.svg); } .caniuse-status > .support > .safari::before { background-image: url(https://resources.whatwg.org/browser-logos/safari.png); } .caniuse-status > .support > .samsung::before { background-image: url(https://resources.whatwg.org/browser-logos/samsung.svg); } .caniuse-status > .caniuse { text-align: right; font-style: italic; } @media (max-width: 767px) { .caniuse-status.wrapped { width: 9em; height: auto; } .caniuse-status:not(.wrapped) { width: 1em; height: 1em; } .caniuse-status.wrapped > :not(input) { display: block; } .caniuse-status:not(.wrapped) > :not(input) { display: none; } }</style> <style>/* style-colors */ /* Any --*-text not paired with a --*-bg is assumed to have a transparent bg */ :root { color-scheme: light dark; --text: black; --bg: white; --unofficial-watermark: url(https://www.w3.org/StyleSheets/TR/2016/logos/UD-watermark); --logo-bg: #1a5e9a; --logo-active-bg: #c00; --logo-text: white; --tocnav-normal-text: #707070; --tocnav-normal-bg: var(--bg); --tocnav-hover-text: var(--tocnav-normal-text); --tocnav-hover-bg: #f8f8f8; --tocnav-active-text: #c00; --tocnav-active-bg: var(--tocnav-normal-bg); --tocsidebar-text: var(--text); --tocsidebar-bg: #f7f8f9; --tocsidebar-shadow: rgba(0,0,0,.1); --tocsidebar-heading-text: hsla(203,20%,40%,.7); --toclink-text: var(--text); --toclink-underline: #3980b5; --toclink-visited-text: var(--toclink-text); --toclink-visited-underline: #054572; --heading-text: #005a9c; --hr-text: var(--text); --algo-border: #def; --del-text: red; --del-bg: transparent; --ins-text: #080; --ins-bg: transparent; --a-normal-text: #034575; --a-normal-underline: #bbb; --a-visited-text: var(--a-normal-text); --a-visited-underline: #707070; --a-hover-bg: rgba(75%, 75%, 75%, .25); --a-active-text: #c00; --a-active-underline: #c00; --blockquote-border: silver; --blockquote-bg: transparent; --blockquote-text: currentcolor; --issue-border: #e05252; --issue-bg: #fbe9e9; --issue-text: var(--text); --issueheading-text: #831616; --example-border: #e0cb52; --example-bg: #fcfaee; --example-text: var(--text); --exampleheading-text: #574b0f; --note-border: #52e052; --note-bg: #e9fbe9; --note-text: var(--text); --noteheading-text: hsl(120, 70%, 30%); --notesummary-underline: silver; --assertion-border: #aaa; --assertion-bg: #eee; --assertion-text: black; --advisement-border: orange; --advisement-bg: #fec; --advisement-text: var(--text); --advisementheading-text: #b35f00; --warning-border: red; --warning-bg: hsla(40,100%,50%,0.95); --warning-text: var(--text); --amendment-border: #330099; --amendment-bg: #F5F0FF; --amendment-text: var(--text); --amendmentheading-text: #220066; --def-border: #8ccbf2; --def-bg: #def; --def-text: var(--text); --defrow-border: #bbd7e9; --datacell-border: silver; --indexinfo-text: #707070; --indextable-hover-text: black; --indextable-hover-bg: #f7f8f9; --outdatedspec-bg: rgba(0, 0, 0, .5); --outdatedspec-text: black; --outdated-bg: maroon; --outdated-text: white; --outdated-shadow: red; --editedrec-bg: darkorange; }</style> <style>/* style-counters */ body { counter-reset: example figure issue; } .issue { counter-increment: issue; } .issue:not(.no-marker)::before { content: "Issue " counter(issue); } .example { counter-increment: example; } .example:not(.no-marker)::before { content: "Example " counter(example); } .invalid.example:not(.no-marker)::before, .illegal.example:not(.no-marker)::before { content: "Invalid Example" counter(example); } figcaption { counter-increment: figure; } figcaption:not(.no-marker)::before { content: "Figure " counter(figure) " "; }</style> <style>/* style-dfn-panel */ :root { --dfnpanel-bg: #ddd; --dfnpanel-text: var(--text); } .dfn-panel { position: absolute; z-index: 35; height: auto; width: -webkit-fit-content; width: fit-content; max-width: 300px; max-height: 500px; overflow: auto; padding: 0.5em 0.75em; font: small Helvetica Neue, sans-serif, Droid Sans Fallback; background: var(--dfnpanel-bg); color: var(--dfnpanel-text); border: outset 0.2em; } .dfn-panel:not(.on) { display: none; } .dfn-panel * { margin: 0; padding: 0; text-indent: 0; } .dfn-panel > b { display: block; } .dfn-panel a { color: var(--dfnpanel-text); } .dfn-panel a:not(:hover) { text-decoration: none !important; border-bottom: none !important; } .dfn-panel > b + b { margin-top: 0.25em; } .dfn-panel ul { padding: 0; } .dfn-panel li { list-style: inside; } .dfn-panel.activated { display: inline-block; position: fixed; left: .5em; bottom: 2em; margin: 0 auto; max-width: calc(100vw - 1.5em - .4em - .5em); max-height: 30vh; } .dfn-paneled { cursor: pointer; } </style> <style>/* style-issues */ a[href].issue-return { float: right; float: inline-end; color: var(--issueheading-text); font-weight: bold; text-decoration: none; } </style> <style>/* style-md-lists */ /* This is a weird hack for me not yet following the commonmark spec regarding paragraph and lists. */ [data-md] > :first-child { margin-top: 0; } [data-md] > :last-child { margin-bottom: 0; }</style> <style>/* style-mdn-anno */ @media (max-width: 767px) { .mdn-anno { opacity: .1 } } .mdn-anno { font: 1em sans-serif; padding: 0.3em; position: absolute; z-index: 8; right: 0.3em; background: #EEE; color: black; box-shadow: 0 0 3px #999; overflow: hidden; border-collapse: initial; border-spacing: initial; min-width: 9em; max-width: min-content; white-space: nowrap; word-wrap: normal; hyphens: none} .mdn-anno:not(.wrapped) { opacity: 1} .mdn-anno:hover { z-index: 9 } .mdn-anno.wrapped { min-width: 0 } .mdn-anno.wrapped > :not(button) { display: none; } .mdn-anno > .mdn-anno-btn { cursor: pointer; border: none; color: #000; background: transparent; margin: -8px; float: right; padding: 10px 8px 8px 8px; outline: none; } .mdn-anno > .mdn-anno-btn > .less-than-two-engines-flag { color: red; padding-right: 2px; } .mdn-anno > .mdn-anno-btn > .all-engines-flag { color: green; padding-right: 2px; } .mdn-anno > .mdn-anno-btn > span { color: #fff; background-color: #000; font-weight: normal; font-family: zillaslab, Palatino, "Palatino Linotype", serif; padding: 2px 3px 0px 3px; line-height: 1.3em; vertical-align: top; } .mdn-anno > .feature { margin-top: 20px; } .mdn-anno > .feature:not(:first-of-type) { border-top: 1px solid #999; margin-top: 6px; padding-top: 2px; } .mdn-anno > .feature > .less-than-two-engines-text { color: red } .mdn-anno > .feature > .all-engines-text { color: green } .mdn-anno > .feature > p { font-size: .75em; margin-top: 6px; margin-bottom: 0; } .mdn-anno > .feature > p + p { margin-top: 3px; } .mdn-anno > .feature > .support { display: block; font-size: 0.6em; margin: 0; padding: 0; margin-top: 2px } .mdn-anno > .feature > .support + div { padding-top: 0.5em; } .mdn-anno > .feature > .support > hr { display: block; border: none; border-top: 1px dotted #999; padding: 3px 0px 0px 0px; margin: 2px 3px 0px 3px; } .mdn-anno > .feature > .support > hr::before { content: ""; } .mdn-anno > .feature > .support > span { padding: 0.2em 0; display: block; display: table; } .mdn-anno > .feature > .support > span.no { color: #CCCCCC; filter: grayscale(100%); } .mdn-anno > .feature > .support > span.no::before { opacity: 0.5; } .mdn-anno > .feature > .support > span:first-of-type { padding-top: 0.5em; } .mdn-anno > .feature > .support > span > span { padding: 0 0.5em; display: table-cell; } .mdn-anno > .feature > .support > span > span:first-child { width: 100%; } .mdn-anno > .feature > .support > span > span:last-child { width: 100%; white-space: pre; padding: 0; } .mdn-anno > .feature > .support > span::before { content: ' '; display: table-cell; min-width: 1.5em; height: 1.5em; background: no-repeat center center; background-size: contain; text-align: right; font-size: 0.75em; font-weight: bold; } .mdn-anno > .feature > .support > .chrome_android::before { background-image: url(https://resources.whatwg.org/browser-logos/chrome.svg); } .mdn-anno > .feature > .support > .firefox_android::before { background-image: url(https://resources.whatwg.org/browser-logos/firefox.png); } .mdn-anno > .feature > .support > .chrome::before { background-image: url(https://resources.whatwg.org/browser-logos/chrome.svg); } .mdn-anno > .feature > .support > .edge_blink::before { background-image: url(https://resources.whatwg.org/browser-logos/edge.svg); } .mdn-anno > .feature > .support > .edge::before { background-image: url(https://resources.whatwg.org/browser-logos/edge_legacy.svg); } .mdn-anno > .feature > .support > .firefox::before { background-image: url(https://resources.whatwg.org/browser-logos/firefox.png); } .mdn-anno > .feature > .support > .ie::before { background-image: url(https://resources.whatwg.org/browser-logos/ie.png); } .mdn-anno > .feature > .support > .safari_ios::before { background-image: url(https://resources.whatwg.org/browser-logos/safari-ios.svg); } .mdn-anno > .feature > .support > .nodejs::before { background-image: url(https://nodejs.org/static/images/favicons/favicon.ico); } .mdn-anno > .feature > .support > .opera_android::before { background-image: url(https://resources.whatwg.org/browser-logos/opera.svg); } .mdn-anno > .feature > .support > .opera::before { background-image: url(https://resources.whatwg.org/browser-logos/opera.svg); } .mdn-anno > .feature > .support > .safari::before { background-image: url(https://resources.whatwg.org/browser-logos/safari.png); } .mdn-anno > .feature > .support > .samsunginternet_android::before { background-image: url(https://resources.whatwg.org/browser-logos/samsung.svg); } .mdn-anno > .feature > .support > .webview_android::before { background-image: url(https://resources.whatwg.org/browser-logos/android-webview.png); } .name-slug-mismatch { color: red } .caniuse-status:hover { z-index: 9; } /* dt, li, .issue, .note, and .example are "position: relative", so to put annotation at right margin, must move to right of containing block */ .h-entry:not(.status-LS) dt > .mdn-anno, .h-entry:not(.status-LS) li > .mdn-anno, .h-entry:not(.status-LS) .issue > .mdn-anno, .h-entry:not(.status-LS) .note > .mdn-anno, .h-entry:not(.status-LS) .example > .mdn-anno { right: -6.7em; } .h-entry p + .mdn-anno { margin-top: 0; } h2 + .mdn-anno.after { margin: -48px 0 0 0; } h3 + .mdn-anno.after { margin: -46px 0 0 0; } h4 + .mdn-anno.after { margin: -42px 0 0 0; } h5 + .mdn-anno.after { margin: -40px 0 0 0; } h6 + .mdn-anno.after { margin: -40px 0 0 0; } </style> <style>/* style-selflinks */ :root { --selflink-text: white; --selflink-bg: gray; --selflink-hover-text: black; } .heading, .issue, .note, .example, li, dt { position: relative; } a.self-link { position: absolute; top: 0; left: calc(-1 * (3.5rem - 26px)); width: calc(3.5rem - 26px); height: 2em; text-align: center; border: none; transition: opacity .2s; opacity: .5; } a.self-link:hover { opacity: 1; } .heading > a.self-link { font-size: 83%; } li > a.self-link { left: calc(-1 * (3.5rem - 26px) - 2em); } dfn > a.self-link { top: auto; left: auto; opacity: 0; width: 1.5em; height: 1.5em; background: var(--selflink-bg); color: var(--selflink-text); font-style: normal; transition: opacity .2s, background-color .2s, color .2s; } dfn:hover > a.self-link { opacity: 1; } dfn > a.self-link:hover { color: var(--selflink-hover-text); } a.self-link::before { content: "¶"; } .heading > a.self-link::before { content: "§"; } dfn > a.self-link::before { content: "#"; } </style> <style>/* style-syntax-highlighting */ pre.idl.highlight { background: var(--borderedblock-bg, var(--def-bg)); } code.highlight { padding: .1em; border-radius: .3em; } pre.highlight, pre > code.highlight { display: block; padding: 1em; margin: .5em 0; overflow: auto; border-radius: 0; } .highlight:not(.idl) { background: rgba(0, 0, 0, .03); } c-[a] { color: #990055 } /* Keyword.Declaration */ c-[b] { color: #990055 } /* Keyword.Type */ c-[c] { color: #708090 } /* Comment */ c-[d] { color: #708090 } /* Comment.Multiline */ c-[e] { color: #0077aa } /* Name.Attribute */ c-[f] { color: #669900 } /* Name.Tag */ c-[g] { color: #222222 } /* Name.Variable */ c-[k] { color: #990055 } /* Keyword */ c-[l] { color: #000000 } /* Literal */ c-[m] { color: #000000 } /* Literal.Number */ c-[n] { color: #0077aa } /* Name */ c-[o] { color: #999999 } /* Operator */ c-[p] { color: #999999 } /* Punctuation */ c-[s] { color: #a67f59 } /* Literal.String */ c-[t] { color: #a67f59 } /* Literal.String.Single */ c-[u] { color: #a67f59 } /* Literal.String.Double */ c-[cp] { color: #708090 } /* Comment.Preproc */ c-[c1] { color: #708090 } /* Comment.Single */ c-[cs] { color: #708090 } /* Comment.Special */ c-[kc] { color: #990055 } /* Keyword.Constant */ c-[kn] { color: #990055 } /* Keyword.Namespace */ c-[kp] { color: #990055 } /* Keyword.Pseudo */ c-[kr] { color: #990055 } /* Keyword.Reserved */ c-[ld] { color: #000000 } /* Literal.Date */ c-[nc] { color: #0077aa } /* Name.Class */ c-[no] { color: #0077aa } /* Name.Constant */ c-[nd] { color: #0077aa } /* Name.Decorator */ c-[ni] { color: #0077aa } /* Name.Entity */ c-[ne] { color: #0077aa } /* Name.Exception */ c-[nf] { color: #0077aa } /* Name.Function */ c-[nl] { color: #0077aa } /* Name.Label */ c-[nn] { color: #0077aa } /* Name.Namespace */ c-[py] { color: #0077aa } /* Name.Property */ c-[ow] { color: #999999 } /* Operator.Word */ c-[mb] { color: #000000 } /* Literal.Number.Bin */ c-[mf] { color: #000000 } /* Literal.Number.Float */ c-[mh] { color: #000000 } /* Literal.Number.Hex */ c-[mi] { color: #000000 } /* Literal.Number.Integer */ c-[mo] { color: #000000 } /* Literal.Number.Oct */ c-[sb] { color: #a67f59 } /* Literal.String.Backtick */ c-[sc] { color: #a67f59 } /* Literal.String.Char */ c-[sd] { color: #a67f59 } /* Literal.String.Doc */ c-[se] { color: #a67f59 } /* Literal.String.Escape */ c-[sh] { color: #a67f59 } /* Literal.String.Heredoc */ c-[si] { color: #a67f59 } /* Literal.String.Interpol */ c-[sx] { color: #a67f59 } /* Literal.String.Other */ c-[sr] { color: #a67f59 } /* Literal.String.Regex */ c-[ss] { color: #a67f59 } /* Literal.String.Symbol */ c-[vc] { color: #0077aa } /* Name.Variable.Class */ c-[vg] { color: #0077aa } /* Name.Variable.Global */ c-[vi] { color: #0077aa } /* Name.Variable.Instance */ c-[il] { color: #000000 } /* Literal.Number.Integer.Long */ </style> <style>/* style-wpt */ :root { --wpt-border: hsl(0, 0%, 60%); --wpt-bg: hsl(0, 0%, 95%); --wpt-text: var(--text); --wptheading-text: hsl(0, 0%, 30%); } @media (prefers-color-scheme: dark) { :root { --wpt-border: hsl(0, 0%, 30%); --wpt-bg: var(--borderedblock-bg); --wpt-text: var(--text); --wptheading-text: hsl(0, 0%, 60%); } } .wpt-tests-block { list-style: none; border-left: .5em solid var(--wpt-border); background: var(--wpt-bg); color: var(--wpt-text); margin: 1em auto; padding: .5em; } .wpt-tests-block summary { color: var(--wptheading-text); font-weight: normal; text-transform: uppercase; } .wpt-tests-block summary::marker{ color: var(--wpt-border); } .wpt-tests-block summary:hover::marker{ color: var(--wpt-text); } /* The only content of a wpt test block in its closed state is the <summary>, which contains the word TESTS, and that is absolutely positioned. In that closed state, wpt test blocks are styled to have a top margin whose height is exactly equal to the height of the absolutely positioned <summary>, and no other background/padding/margin/border. The wpt test block elements will therefore allow the maring of the previous/next block elements to collapse through them; if this combined margin would be larger than its own top margin, it stays as is, and therefore the pre-existing vertical rhythm of the document is undisturbed. If that combined margin would be smaller, it is grown to that size. This means that the wpt test block ensures that there's always enough vertical space to insert the summary, without adding more than is needed. */ .wpt-tests-block:not([open]){ padding: 0; border: none; background: none; font-size: 0.75em; line-height: 1; position: relative; margin: 1em 0 0; } .wpt-tests-block:not([open]) summary { position: absolute; right: 0; bottom: 0; } /* It is possible that both the last child of a block element and the block element itself would be annotated with a <wpt> block each. If the block element has a padding or a border, that's fine, but otherwise the bottom margin of the block and of its last child would collapse and both <wpt> elements would overlap, being both placed there. To avoid that, add 1px of padding to the <wpt> element annotating the last child to prevent the bottom margin of the block and of its last child from collapsing (and as much negative margin, as wel only want to prevent margin collapsing, but are not trying to actually take more space). */ .wpt-tests-block:not([open]):last-child { padding-bottom: 1px; margin-bottom: -1px; } /* Exception to the previous rule: don't do that in non-last list items, because it's not necessary, and would therefore consume more space than strictly needed. Lists must have list items as children, not <wpt> elements, so a <wpt> element cannot be a sibling of a list item, and the collision that the previous rule avoids cannot happen. */ li:not(:last-child) > .wpt-tests-block:not([open]):last-child, dd:not(:last-child) > .wpt-tests-block:not([open]):last-child { padding-bottom: 0; margin-bottom: 0; } .wpt-tests-block:not([open]):not(:hover){ opacity: 0.5; } .wpt-tests-list { list-style: none; display: grid; margin: 0; padding: 0; grid-template-columns: 1fr max-content auto auto; grid-column-gap: .5em; } .wpt-tests-block hr:last-child { display: none; } .wpt-test { display: contents; } .wpt-test > a { text-decoration: underline; border: none; } .wpt-test > .wpt-name { grid-column: 1; } .wpt-test > .wpt-results { grid-column: 2; } .wpt-test > .wpt-live { grid-column: 3; } .wpt-test > .wpt-source { grid-column: 4; } .wpt-test > .wpt-results { display: flex; gap: .1em; } .wpt-test .wpt-result { display: inline-block; height: 1em; width: 1em; border-radius: 50%; position: relative; } </style> <style>/* style-darkmode */ @media (prefers-color-scheme: dark) { :root { --text: #ddd; --bg: black; --unofficial-watermark: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='400' height='400'%3E%3Cg fill='%23100808' transform='translate(200 200) rotate(-45) translate(-200 -200)' stroke='%23100808' stroke-width='3'%3E%3Ctext x='50%25' y='220' style='font: bold 70px sans-serif; text-anchor: middle; letter-spacing: 6px;'%3EUNOFFICIAL%3C/text%3E%3Ctext x='50%25' y='305' style='font: bold 70px sans-serif; text-anchor: middle; letter-spacing: 6px;'%3EDRAFT%3C/text%3E%3C/g%3E%3C/svg%3E"); --logo-bg: #1a5e9a; --logo-active-bg: #c00; --logo-text: white; --tocnav-normal-text: #999; --tocnav-normal-bg: var(--bg); --tocnav-hover-text: var(--tocnav-normal-text); --tocnav-hover-bg: #080808; --tocnav-active-text: #f44; --tocnav-active-bg: var(--tocnav-normal-bg); --tocsidebar-text: var(--text); --tocsidebar-bg: #080808; --tocsidebar-shadow: rgba(255,255,255,.1); --tocsidebar-heading-text: hsla(203,20%,40%,.7); --toclink-text: var(--text); --toclink-underline: #6af; --toclink-visited-text: var(--toclink-text); --toclink-visited-underline: #054572; --heading-text: #8af; --hr-text: var(--text); --algo-border: #456; --del-text: #f44; --del-bg: transparent; --ins-text: #4a4; --ins-bg: transparent; --a-normal-text: #6af; --a-normal-underline: #555; --a-visited-text: var(--a-normal-text); --a-visited-underline: var(--a-normal-underline); --a-hover-bg: rgba(25%, 25%, 25%, .2); --a-active-text: #f44; --a-active-underline: var(--a-active-text); --borderedblock-bg: rgba(255, 255, 255, .05); --blockquote-border: silver; --blockquote-bg: var(--borderedblock-bg); --blockquote-text: currentcolor; --issue-border: #e05252; --issue-bg: var(--borderedblock-bg); --issue-text: var(--text); --issueheading-text: hsl(0deg, 70%, 70%); --example-border: hsl(50deg, 90%, 60%); --example-bg: var(--borderedblock-bg); --example-text: var(--text); --exampleheading-text: hsl(50deg, 70%, 70%); --note-border: hsl(120deg, 100%, 35%); --note-bg: var(--borderedblock-bg); --note-text: var(--text); --noteheading-text: hsl(120, 70%, 70%); --notesummary-underline: silver; --assertion-border: #444; --assertion-bg: var(--borderedblock-bg); --assertion-text: var(--text); --advisement-border: orange; --advisement-bg: #222218; --advisement-text: var(--text); --advisementheading-text: #f84; --warning-border: red; --warning-bg: hsla(40,100%,20%,0.95); --warning-text: var(--text); --amendment-border: #330099; --amendment-bg: #080010; --amendment-text: var(--text); --amendmentheading-text: #cc00ff; --def-border: #8ccbf2; --def-bg: #080818; --def-text: var(--text); --defrow-border: #136; --datacell-border: silver; --indexinfo-text: #aaa; --indextable-hover-text: var(--text); --indextable-hover-bg: #181818; --outdatedspec-bg: rgba(255, 255, 255, .5); --outdatedspec-text: black; --outdated-bg: maroon; --outdated-text: white; --outdated-shadow: red; --editedrec-bg: darkorange; } /* In case a transparent-bg image doesn't expect to be on a dark bg, which is quite common in practice... */ img { background: white; } } @media (prefers-color-scheme: dark) { :root { --selflink-text: black; --selflink-bg: silver; --selflink-hover-text: white; } } @media (prefers-color-scheme: dark) { :root { --caniuse-shadow: #444; --caniuse-nosupport-text: #666; --caniuse-partialsupport-text: #bbb; } } @media (prefers-color-scheme: dark) { :root { --dfnpanel-bg: #222; --dfnpanel-text: var(--text); } } @media (prefers-color-scheme: dark) { .highlight:not(.idl) { background: rgba(255, 255, 255, .05); } c-[a] { color: #d33682 } /* Keyword.Declaration */ c-[b] { color: #d33682 } /* Keyword.Type */ c-[c] { color: #2aa198 } /* Comment */ c-[d] { color: #2aa198 } /* Comment.Multiline */ c-[e] { color: #268bd2 } /* Name.Attribute */ c-[f] { color: #b58900 } /* Name.Tag */ c-[g] { color: #cb4b16 } /* Name.Variable */ c-[k] { color: #d33682 } /* Keyword */ c-[l] { color: #657b83 } /* Literal */ c-[m] { color: #657b83 } /* Literal.Number */ c-[n] { color: #268bd2 } /* Name */ c-[o] { color: #657b83 } /* Operator */ c-[p] { color: #657b83 } /* Punctuation */ c-[s] { color: #6c71c4 } /* Literal.String */ c-[t] { color: #6c71c4 } /* Literal.String.Single */ c-[u] { color: #6c71c4 } /* Literal.String.Double */ c-[ch] { color: #2aa198 } /* Comment.Hashbang */ c-[cp] { color: #2aa198 } /* Comment.Preproc */ c-[cpf] { color: #2aa198 } /* Comment.PreprocFile */ c-[c1] { color: #2aa198 } /* Comment.Single */ c-[cs] { color: #2aa198 } /* Comment.Special */ c-[kc] { color: #d33682 } /* Keyword.Constant */ c-[kn] { color: #d33682 } /* Keyword.Namespace */ c-[kp] { color: #d33682 } /* Keyword.Pseudo */ c-[kr] { color: #d33682 } /* Keyword.Reserved */ c-[ld] { color: #657b83 } /* Literal.Date */ c-[nc] { color: #268bd2 } /* Name.Class */ c-[no] { color: #268bd2 } /* Name.Constant */ c-[nd] { color: #268bd2 } /* Name.Decorator */ c-[ni] { color: #268bd2 } /* Name.Entity */ c-[ne] { color: #268bd2 } /* Name.Exception */ c-[nf] { color: #268bd2 } /* Name.Function */ c-[nl] { color: #268bd2 } /* Name.Label */ c-[nn] { color: #268bd2 } /* Name.Namespace */ c-[py] { color: #268bd2 } /* Name.Property */ c-[ow] { color: #657b83 } /* Operator.Word */ c-[mb] { color: #657b83 } /* Literal.Number.Bin */ c-[mf] { color: #657b83 } /* Literal.Number.Float */ c-[mh] { color: #657b83 } /* Literal.Number.Hex */ c-[mi] { color: #657b83 } /* Literal.Number.Integer */ c-[mo] { color: #657b83 } /* Literal.Number.Oct */ c-[sa] { color: #6c71c4 } /* Literal.String.Affix */ c-[sb] { color: #6c71c4 } /* Literal.String.Backtick */ c-[sc] { color: #6c71c4 } /* Literal.String.Char */ c-[dl] { color: #6c71c4 } /* Literal.String.Delimiter */ c-[sd] { color: #6c71c4 } /* Literal.String.Doc */ c-[se] { color: #6c71c4 } /* Literal.String.Escape */ c-[sh] { color: #6c71c4 } /* Literal.String.Heredoc */ c-[si] { color: #6c71c4 } /* Literal.String.Interpol */ c-[sx] { color: #6c71c4 } /* Literal.String.Other */ c-[sr] { color: #6c71c4 } /* Literal.String.Regex */ c-[ss] { color: #6c71c4 } /* Literal.String.Symbol */ c-[fm] { color: #268bd2 } /* Name.Function.Magic */ c-[vc] { color: #cb4b16 } /* Name.Variable.Class */ c-[vg] { color: #cb4b16 } /* Name.Variable.Global */ c-[vi] { color: #cb4b16 } /* Name.Variable.Instance */ c-[vm] { color: #cb4b16 } /* Name.Variable.Magic */ c-[il] { color: #657b83 } /* Literal.Number.Integer.Long */ } </style> <style type='text/css'><!-- a#generator { width: 32px; height: 32px; display: block; position: fixed; right: 0; top: 0; border-bottom-left-radius: 5px; background: #f4f4f4; box-shadow: 2px 0px 3px #444; background-image: linear-gradient(to bottom, #eee, #fff 15%, #ededed 80%, #e0e0e0); } a#generator:focus { outline: none;} a#generator svg { position: absolute; right: 3px; top: 3px; } @keyframes fill { 0%, 100% { fill: blue; } 16% { fill: purple; } 33% { fill: hsl(0, 100%, 60%); } 50% { fill: orange; } 67% { fill: gold; } 83% { fill: hsl(120, 100%, 25%); } } @keyframes stroke { 0%, 100% { stroke: blue; } 16% { stroke: purple; } 33% { stroke: hsl(0, 100%, 60%); } 50% { stroke: orange; } 67% { stroke: gold; } 83% { stroke: hsl(120, 100%, 25%); } } a#generator.fatal [fill=blue], a#generator.error [fill=blue], .previous [fill=blue] { fill: #d00; } a#generator.fatal [stroke=blue], a#generator.error [stroke=blue], .previous [stroke=blue] { stroke: #d00; } a#generator.warning [fill=blue] { fill: #0df; } a#generator.warning [stroke=blue] { stroke: #0df; } a#generator.link-error [fill=blue] { fill: #cc0; } a#generator.link-error [stroke=blue] { stroke: #cc0; } a#generator.success [fill=blue] { fill: #0b0; } a#generator.success [stroke=blue] { stroke: #0b0; } a#generator [fill=blue], [stroke=blue] { animation: n 5s infinite linear; transition: fill 1s, stroke 1s; } a#generator.pending [stroke=blue] { animation-name: stroke; } a#generator.pending [fill=blue] { animation-name: fill; } a#generator.generating [stroke=blue] { animation-name: stroke; } a#generator.generating [fill=blue] { animation-name: fill; } --></style><body class="h-entry"> <div class="head"> <p data-fill-with="logo"><a class="logo" href="https://www.w3.org/"> <img alt="W3C" height="48" src="https://www.w3.org/StyleSheets/TR/2021/logos/W3C" width="72"> </a> </p> <h1 class="p-name no-ref" id="title">CSS Cascading and Inheritance Level 5</h1> <p id="w3c-state"><a href="https://www.w3.org/standards/types#ED">Editor’s Draft</a>, <time class="dt-updated" datetime="2022-08-04">4 August 2022</time></p> <details open> <summary>More details about this document</summary> <div data-fill-with="spec-metadata"> <dl> <dt>This version: <dd><a class="u-url" href="https://drafts.csswg.org/css-cascade-5/">https://drafts.csswg.org/css-cascade-5/</a> <dt>Latest published version: <dd><a href="https://www.w3.org/TR/css-cascade-5/">https://www.w3.org/TR/css-cascade-5/</a> <dt>Previous Versions: <dd><a href="https://www.w3.org/TR/2022/CR-css-cascade-5-20220113/" rel="prev">https://www.w3.org/TR/2022/CR-css-cascade-5-20220113/</a> <dd><a href="https://www.w3.org/TR/2021/WD-css-cascade-5-20211015/" rel="prev">https://www.w3.org/TR/2021/WD-css-cascade-5-20211015/</a> <dd><a href="https://www.w3.org/TR/2021/WD-css-cascade-5-20210829/" rel="prev">https://www.w3.org/TR/2021/WD-css-cascade-5-20210829/</a> <dd><a href="https://www.w3.org/TR/2021/WD-css-cascade-5-20210608/" rel="prev">https://www.w3.org/TR/2021/WD-css-cascade-5-20210608/</a> <dd><a href="https://www.w3.org/TR/2021/WD-css-cascade-5-20210319/" rel="prev">https://www.w3.org/TR/2021/WD-css-cascade-5-20210319/</a> <dd><a href="https://www.w3.org/TR/2021/WD-css-cascade-5-20210119/" rel="prev">https://www.w3.org/TR/2021/WD-css-cascade-5-20210119/</a> <dt>Implementation Report: <dd><a href="https://wpt.fyi/results/css/css-cascade">https://wpt.fyi/results/css/css-cascade</a> <dt>Feedback: <dd><a href="https://github.com/w3c/csswg-drafts/labels/css-cascade-5">CSSWG Issues Repository</a> <dd><a href="#issues-index">Inline In Spec</a> <dt class="editor">Editors: <dd class="editor p-author h-card vcard" data-editor-id="35400"><a class="p-name fn u-url url" href="http://fantasai.inkedblade.net/contact">Elika J. Etemad / fantasai</a> (<span class="p-org org">Invited Expert</span>) <dd class="editor p-author h-card vcard" data-editor-id="117151"><a class="p-name fn u-url url" href="http://miriamsuzanne.com/contact">Miriam E. Suzanne</a> (<span class="p-org org">Invited Expert</span>) <dd class="editor p-author h-card vcard" data-editor-id="42199"><a class="p-name fn u-url url" href="http://xanthir.com/contact/">Tab Atkins Jr.</a> (<span class="p-org org">Google</span>) <dt>Suggest an Edit for this Spec: <dd><a href="https://github.com/w3c/csswg-drafts/blob/main/css-cascade-5/Overview.bs">GitHub Editor</a> </dl> </div> </details> <div data-fill-with="warning"></div> <p class="copyright" data-fill-with="copyright"><a href="https://www.w3.org/Consortium/Legal/ipr-notice#Copyright">Copyright</a> © 2022 <a href="https://www.w3.org/"><abbr title="World Wide Web Consortium">W3C</abbr></a><sup>®</sup> (<a href="https://www.csail.mit.edu/"><abbr title="Massachusetts Institute of Technology">MIT</abbr></a>, <a href="https://www.ercim.eu/"><abbr title="European Research Consortium for Informatics and Mathematics">ERCIM</abbr></a>, <a href="https://www.keio.ac.jp/">Keio</a>, <a href="https://ev.buaa.edu.cn/">Beihang</a>). W3C <a href="https://www.w3.org/Consortium/Legal/ipr-notice#Legal_Disclaimer">liability</a>, <a href="https://www.w3.org/Consortium/Legal/ipr-notice#W3C_Trademarks">trademark</a> and <a href="https://www.w3.org/Consortium/Legal/2015/copyright-software-and-document" rel="license">permissive document license</a> rules apply. </p> <hr title="Separator for header"> </div> <div class="p-summary" data-fill-with="abstract"> <h2 class="no-num no-toc no-ref heading settled" id="abstract"><span class="content">Abstract</span></h2> <p>This CSS module describes how to collate style rules and assign values to all properties on all elements. By way of cascading and inheritance, values are propagated for all properties on all elements.</p> <p>New in this level is <a data-link-type="dfn" href="#cascade-layers" id="ref-for-cascade-layers">cascade layers</a>.</p> <a href="https://www.w3.org/TR/CSS/">CSS</a> is a language for describing the rendering of structured documents (such as HTML and XML) on screen, on paper, etc. </div> <h2 class="no-num no-toc no-ref heading settled" id="sotd"><span class="content">Status of this document</span></h2> <div data-fill-with="status"> <p> This is a public copy of the editors’ draft. It is provided for discussion only and may change at any moment. Its publication here does not imply endorsement of its contents by W3C. Don’t cite this document other than as work in progress. </p> <p>Please send feedback by <a href="https://github.com/w3c/csswg-drafts/issues">filing issues in GitHub</a> (preferred), including the spec code “css-cascade” in the title, like this: “[css-cascade] <i>…summary of comment…</i>”. All issues and comments are <a href="https://lists.w3.org/Archives/Public/public-css-archive/">archived</a>. Alternately, feedback can be sent to the (<a href="https://lists.w3.org/Archives/Public/www-style/">archived</a>) public mailing list <a href="mailto:www-style@w3.org?Subject=%5Bcss-cascade%5D%20PUT%20SUBJECT%20HERE">www-style@w3.org</a>. </p> <p>This document is governed by the <a href="https://www.w3.org/2021/Process-20211102/" id="w3c_process_revision">2 November 2021 W3C Process Document</a>. </p> <p></p> </div> <div data-fill-with="at-risk"> <p>The following features are at-risk, and may be dropped during the CR period: </p> <ul> <li>the <a class="css" data-link-type="maybe" href="#valdef-all-revert-layer" id="ref-for-valdef-all-revert-layer">revert-layer</a> keyword </ul> <p>“At-risk” is a W3C Process term-of-art, and does not necessarily imply that the feature is in danger of being dropped or delayed. It means that the WG believes the feature may have difficulty being interoperably implemented in a timely manner, and marking it as such allows the WG to drop the feature if necessary when transitioning to the Proposed Rec stage, without having to publish a new Candidate Rec without the feature first.</p> </div> <nav data-fill-with="table-of-contents" id="toc"> <h2 class="no-num no-toc no-ref" id="contents">Table of Contents</h2> <ol class="toc" role="directory"> <li> <a href="#intro"><span class="secno">1</span> <span class="content"> Introduction</span></a> <ol class="toc"> <li><a href="#placement"><span class="secno">1.1</span> <span class="content"> Module Interactions</span></a> </ol> <li> <a href="#at-import"><span class="secno">2</span> <span class="content"> Importing Style Sheets: the <span class="css">@import</span> rule</span></a> <ol class="toc"> <li><a href="#conditional-import"><span class="secno">2.1</span> <span class="content"> Conditional <span class="css">@import</span> Rules</span></a> <li><a href="#import-processing"><span class="secno">2.2</span> <span class="content"> Processing Stylesheet Imports</span></a> <li><a href="#content-type"><span class="secno">2.3</span> <span class="content"> Content-Type of CSS Style Sheets</span></a> </ol> <li> <a href="#shorthand"><span class="secno">3</span> <span class="content"> Shorthand Properties</span></a> <ol class="toc"> <li><a href="#aliasing"><span class="secno">3.1</span> <span class="content"> Property Aliasing</span></a> <li><a href="#all-shorthand"><span class="secno">3.2</span> <span class="content"> Resetting All Properties: the <span class="property">all</span> property</span></a> </ol> <li> <a href="#value-stages"><span class="secno">4</span> <span class="content"> Value Processing</span></a> <ol class="toc"> <li> <a href="#declared"><span class="secno">4.1</span> <span class="content"> Declared Values</span></a> <ol class="toc"> <li><a href="#value-aliasing"><span class="secno">4.1.1</span> <span class="content"> Value Aliasing</span></a> </ol> <li><a href="#cascaded"><span class="secno">4.2</span> <span class="content"> Cascaded Values</span></a> <li><a href="#specified"><span class="secno">4.3</span> <span class="content"> Specified Values</span></a> <li><a href="#computed"><span class="secno">4.4</span> <span class="content"> Computed Values</span></a> <li> <a href="#used"><span class="secno">4.5</span> <span class="content"> Used Values</span></a> <ol class="toc"> <li><a href="#applies-to"><span class="secno">4.5.1</span> <span class="content"> Applicable Properties</span></a> </ol> <li><a href="#actual"><span class="secno">4.6</span> <span class="content"> Actual Values</span></a> <li><a href="#stages-examples"><span class="secno">4.7</span> <span class="content"> Examples</span></a> <li><a href="#fragments"><span class="secno">4.8</span> <span class="content"> Per-Fragment Value Processing</span></a> </ol> <li><a href="#filtering"><span class="secno">5</span> <span class="content"> Filtering</span></a> <li> <a href="#cascading"><span class="secno">6</span> <span class="content"> Cascading</span></a> <ol class="toc"> <li><a href="#cascade-sort"><span class="secno">6.1</span> <span class="content"> Cascade Sorting Order</span></a> <li><a href="#cascading-origins"><span class="secno">6.2</span> <span class="content"> Cascading Origins</span></a> <li><a href="#importance"><span class="secno">6.3</span> <span class="content"> Important Declarations: the <span class="css">!important</span> annotation</span></a> <li> <a href="#layering"><span class="secno">6.4</span> <span class="content"> Cascade Layers</span></a> <ol class="toc"> <li><a href="#layer-declaration"><span class="secno">6.4.1</span> <span class="content"> Declaring Cascade Layers</span></a> <li> <a href="#layer-names"><span class="secno">6.4.2</span> <span class="content"> Layer Naming and Nesting</span></a> <ol class="toc"> <li><a href="#unnamed-layers"><span class="secno">6.4.2.1</span> <span class="content"> Anonymous Layers</span></a> </ol> <li><a href="#layer-ordering"><span class="secno">6.4.3</span> <span class="content"> Layer Ordering</span></a> <li> <a href="#at-layer"><span class="secno">6.4.4</span> <span class="content"> Declaring Layers Inline: the <span class="css">@layer</span> rule</span></a> <ol class="toc"> <li><a href="#layer-block"><span class="secno">6.4.4.1</span> <span class="content"> Assigning Styles Inline: the <span class="css">@layer</span> block at-rule</span></a> <li><a href="#layer-empty"><span class="secno">6.4.4.2</span> <span class="content"> Declaring Without Styles: the <span class="css">@layer</span> statement at-rule</span></a> </ol> </ol> <li><a href="#preshint"><span class="secno">6.5</span> <span class="content"> Precedence of Non-CSS Presentational Hints</span></a> </ol> <li> <a href="#defaulting"><span class="secno">7</span> <span class="content"> Defaulting</span></a> <ol class="toc"> <li><a href="#initial-values"><span class="secno">7.1</span> <span class="content"> Initial Values</span></a> <li><a href="#inheriting"><span class="secno">7.2</span> <span class="content"> Inheritance</span></a> <li> <a href="#defaulting-keywords"><span class="secno">7.3</span> <span class="content"> Explicit Defaulting</span></a> <ol class="toc"> <li><a href="#initial"><span class="secno">7.3.1</span> <span class="content"> Resetting a Property: the <span class="css">initial</span> keyword</span></a> <li><a href="#inherit"><span class="secno">7.3.2</span> <span class="content"> Explicit Inheritance: the <span class="css">inherit</span> keyword</span></a> <li><a href="#inherit-initial"><span class="secno">7.3.3</span> <span class="content"> Erasing All Declarations: the <span class="css">unset</span> keyword</span></a> <li><a href="#default"><span class="secno">7.3.4</span> <span class="content"> Rolling Back Cascade Origins: the <span class="css">revert</span> keyword</span></a> <li><a href="#revert-layer"><span class="secno">7.3.5</span> <span class="content"> Rolling Back Cascade Layers: the <span class="css">revert-layer</span> keyword</span></a> </ol> </ol> <li> <a href="#layer-apis"><span class="secno">8</span> <span class="content">Layer APIs</span></a> <ol class="toc"> <li><a href="#extensions-to-cssimportrule-interface"><span class="secno">8.1</span> <span class="content"> Extensions to the <code>CSSImportRule</code> interface</span></a> <li><a href="#the-csslayerblockrule-interface"><span class="secno">8.2</span> <span class="content"> The <code>CSSLayerBlockRule</code> interface</span></a> <li><a href="#the-csslayerstatementrule-interface"><span class="secno">8.3</span> <span class="content"> The <code>CSSLayerStatementRule</code> interface</span></a> </ol> <li> <a href="#changes"><span class="secno">9</span> <span class="content"> Changes</span></a> <ol class="toc"> <li><a href="#changes-2022-01"><span class="secno">9.1</span> <span class="content"> Changes since the 13 Jan 2022 Candidate Recommendation Snapshot</span></a> <li><a href="#changes-2021-10"><span class="secno">9.2</span> <span class="content"> Changes since the 15 Oct 2021 Working Draft</span></a> <li><a href="#changes-2021-08"><span class="secno">9.3</span> <span class="content"> Changes since the 29 August 2021 Working Draft</span></a> <li><a href="#changes-2021-06"><span class="secno">9.4</span> <span class="content"> Changes since the 8 June 2021 Working Draft</span></a> <li><a href="#changes-2021-03"><span class="secno">9.5</span> <span class="content"> Changes since the 19 March 2021 Working Draft</span></a> <li><a href="#changes-2021-01"><span class="secno">9.6</span> <span class="content"> Changes since the 19 January 2021 Working Draft</span></a> <li><a href="#additions-l4"><span class="secno">9.7</span> <span class="content"> Additions Since Level 4</span></a> <li><a href="#additions-l3"><span class="secno">9.8</span> <span class="content"> Additions Since Level 3</span></a> <li><a href="#changes-2"><span class="secno">9.9</span> <span class="content"> Additions Since Level 2</span></a> </ol> <li><a href="#acknowledgments"><span class="secno"></span> <span class="content">Acknowledgments</span></a> <li><a href="#priv-sec"><span class="secno"></span> <span class="content"> Privacy and Security Considerations</span></a> <li> <a href="#w3c-conformance"><span class="secno"></span> <span class="content"> Conformance</span></a> <ol class="toc"> <li><a href="#w3c-conventions"><span class="secno"></span> <span class="content"> Document conventions</span></a> <li><a href="#w3c-conformance-classes"><span class="secno"></span> <span class="content"> Conformance classes</span></a> <li> <a href="#w3c-partial"><span class="secno"></span> <span class="content"> Partial implementations</span></a> <ol class="toc"> <li><a href="#w3c-conform-future-proofing"><span class="secno"></span> <span class="content"> Implementations of Unstable and Proprietary Features</span></a> </ol> <li><a href="#w3c-testing"><span class="secno"></span> <span class="content"> Non-experimental implementations</span></a> </ol> <li> <a href="#index"><span class="secno"></span> <span class="content">Index</span></a> <ol class="toc"> <li><a href="#index-defined-here"><span class="secno"></span> <span class="content">Terms defined by this specification</span></a> <li><a href="#index-defined-elsewhere"><span class="secno"></span> <span class="content">Terms defined by reference</span></a> </ol> <li> <a href="#references"><span class="secno"></span> <span class="content">References</span></a> <ol class="toc"> <li><a href="#normative"><span class="secno"></span> <span class="content">Normative References</span></a> <li><a href="#informative"><span class="secno"></span> <span class="content">Informative References</span></a> </ol> <li><a href="#property-index"><span class="secno"></span> <span class="content">Property Index</span></a> <li><a href="#idl-index"><span class="secno"></span> <span class="content">IDL Index</span></a> <li><a href="#issues-index"><span class="secno"></span> <span class="content">Issues Index</span></a> </ol> </nav> <main> <h2 class="heading settled" data-level="1" id="intro"><span class="secno">1. </span><span class="content"> Introduction</span><a class="self-link" href="#intro"></a></h2> <p>CSS defines a finite set of parameters, called <dfn class="dfn-paneled" data-dfn-for="CSS" data-dfn-type="dfn" data-export data-lt="property" id="css-property">properties</dfn>, that direct the rendering of a document. Each <a data-link-type="dfn" href="#css-property" id="ref-for-css-property">property</a> has a name (e.g., <a class="property css" data-link-type="property" href="https://drafts.csswg.org/css-color-4/#propdef-color" id="ref-for-propdef-color">color</a>, <a class="property css" data-link-type="property" href="https://drafts.csswg.org/css-fonts-4/#propdef-font-size" id="ref-for-propdef-font-size">font-size</a>, or <a class="property css" data-link-type="property" href="https://drafts.csswg.org/css-backgrounds-3/#propdef-border-style" id="ref-for-propdef-border-style">border-style</a>), a value space (e.g., <a class="production css" data-link-type="type" href="https://drafts.csswg.org/css-color-4/#typedef-color" id="ref-for-typedef-color" title="Expands to: aliceblue | antiquewhite | aqua | aquamarine | azure | beige | bisque | black | blanchedalmond | blue | blueviolet | brown | burlywood | cadetblue | chartreuse | chocolate | coral | cornflowerblue | cornsilk | crimson | currentcolor | cyan | darkblue | darkcyan | darkgoldenrod | darkgray | darkgreen | darkgrey | darkkhaki | darkmagenta | darkolivegreen | darkorange | darkorchid | darkred | darksalmon | darkseagreen | darkslateblue | darkslategray | darkslategrey | darkturquoise | darkviolet | deeppink | deepskyblue | dimgray | dimgrey | dodgerblue | firebrick | floralwhite | forestgreen | fuchsia | gainsboro | ghostwhite | gold | goldenrod | gray | green | greenyellow | grey | honeydew | hotpink | indianred | indigo | ivory | khaki | lavender | lavenderblush | lawngreen | lemonchiffon | lightblue | lightcoral | lightcyan | lightgoldenrodyellow | lightgray | lightgreen | lightgrey | lightpink | lightsalmon | lightseagreen | lightskyblue | lightslategray | lightslategrey | lightsteelblue | lightyellow | lime | limegreen | linen | magenta | maroon | mediumaquamarine | mediumblue | mediumorchid | mediumpurple | mediumseagreen | mediumslateblue | mediumspringgreen | mediumturquoise | mediumvioletred | midnightblue | mintcream | mistyrose | moccasin | navajowhite | navy | none | oldlace | olive | olivedrab | orange | orangered | orchid | palegoldenrod | palegreen | paleturquoise | palevioletred | papayawhip | peachpuff | peru | pink | plum | powderblue | purple | rebeccapurple | red | rosybrown | royalblue | saddlebrown | salmon | sandybrown | seagreen | seashell | sienna | silver | skyblue | slateblue | slategray | slategrey | snow | springgreen | steelblue | tan | teal | thistle | tomato | transparent | turquoise | violet | wheat | white | whitesmoke | yellow | yellowgreen"><color></a>, <a class="production css" data-link-type="type" href="https://drafts.csswg.org/css-values-4/#typedef-length-percentage" id="ref-for-typedef-length-percentage"><length-percentage></a>, <span class="css">[ solid | dashed | dotted | … ]</span>), and a defined behavior on the rendering of the document. Properties values are assigned to various parts of the document via <a data-link-type="dfn" href="https://drafts.csswg.org/css-syntax-3/#css-property-declarations" id="ref-for-css-property-declarations">property declarations</a>, which assign the property a value (e.g. <a class="css" data-link-type="maybe" href="https://drafts.csswg.org/css-color-4/#valdef-color-red" id="ref-for-valdef-color-red">red</a>, <span class="css">12pt</span>, <a class="css" data-link-type="maybe" href="https://drafts.csswg.org/css-backgrounds-3/#valdef-line-style-dotted" id="ref-for-valdef-line-style-dotted">dotted</a>) for the associated element or box.</p> <p>One of the fundamental design principles of CSS is <a data-link-type="dfn" href="#cascade" id="ref-for-cascade">cascading</a>, which allows several style sheets to influence the presentation of a document. When different <a data-link-type="dfn" href="https://drafts.csswg.org/cssom-1/#cssstyledeclaration-declarations" id="ref-for-cssstyledeclaration-declarations">declarations</a> try to set a value for the same element/property combination, the conflicts must somehow be resolved.</p> <p>The opposite problem arises when no <a data-link-type="dfn" href="https://drafts.csswg.org/cssom-1/#cssstyledeclaration-declarations" id="ref-for-cssstyledeclaration-declarations①">declarations</a> try to set a value for an element/property combination. In this case, a value is be found by way of <a data-link-type="dfn" href="#inheritance" id="ref-for-inheritance">inheritance</a> or by looking at the property’s <a data-link-type="dfn" href="#initial-value" id="ref-for-initial-value">initial value</a>.</p> <p>The <a href="#cascade" id="ref-for-cascade①⑤">cascading</a> and <a href="#defaulting">defaulting</a> process takes a set of <a data-link-type="dfn" href="https://drafts.csswg.org/cssom-1/#cssstyledeclaration-declarations" id="ref-for-cssstyledeclaration-declarations②">declarations</a> as input, and outputs a <a data-link-type="dfn" href="#specified-value" id="ref-for-specified-value">specified value</a> for each property on each element.</p> <p>The rules for finding the specified value for all properties on all elements in the document are described in this specification. The rules for finding the specified values in the page context and its margin boxes are described in <a data-link-type="biblio" href="#biblio-css-page-3">[css-page-3]</a>.</p> <h3 class="heading settled" data-level="1.1" id="placement"><span class="secno">1.1. </span><span class="content"> Module Interactions</span><a class="self-link" href="#placement"></a></h3> <p><em>This section is normative.</em></p> <p>This module replaces and extends the rules for assigning property values, cascading, and inheritance defined in <a data-link-type="biblio" href="#biblio-css2">[CSS2]</a> chapter 6.</p> <p>Other CSS modules may expand the definitions of some of the syntax and features defined here. For example, the Media Queries Level 4 specification, when combined with this module, expands the definition of the <a class="production css" data-link-type="type" href="https://drafts.csswg.org/mediaqueries-4/#typedef-media-query" id="ref-for-typedef-media-query"><media-query></a> value type as used in this specification.</p> <p>For the purpose of this specification, <a data-link-type="dfn" href="https://drafts.csswg.org/css-display-3/#text-nodes" id="ref-for-text-nodes">text nodes</a> are treated as <a data-link-type="dfn" href="https://drafts.csswg.org/css-display-3/#elements" id="ref-for-elements">element</a> children of their associated element, and possess the full set of properties; since they cannot be targeted by selectors all of their computed values are assigned by <a href="#defaulting">defaulting</a>.</p> <h2 class="heading settled" data-level="2" id="at-import"><span class="secno">2. </span><span class="content"> Importing Style Sheets: the <a class="css" data-link-type="maybe" href="#at-ruledef-import" id="ref-for-at-ruledef-import">@import</a> rule</span><a class="self-link" href="#at-import"></a></h2> <div class="mdn-anno wrapped after"> <button class="mdn-anno-btn"><b class="all-engines-flag" title="This feature is in all current engines.">✔</b><span>MDN</span></button> <div class="feature"> <p><a href="https://developer.mozilla.org/en-US/docs/Web/CSS/@import" title="The @import CSS at-rule is used to import style rules from other stylesheets.">@import</a></p> <p class="all-engines-text">In all current engines.</p> <div class="support"> <span class="firefox yes"><span>Firefox</span><span>1+</span></span><span class="safari yes"><span>Safari</span><span>1+</span></span><span class="chrome yes"><span>Chrome</span><span>1+</span></span> <hr> <span class="opera yes"><span>Opera</span><span>3.5+</span></span><span class="edge_blink yes"><span>Edge</span><span>79+</span></span> <hr> <span class="edge yes"><span>Edge (Legacy)</span><span>12+</span></span><span class="ie yes"><span>IE</span><span>5.5+</span></span> <hr> <span class="firefox_android no"><span>Firefox for Android</span><span>?</span></span><span class="safari_ios no"><span>iOS Safari</span><span>?</span></span><span class="chrome_android no"><span>Chrome for Android</span><span>?</span></span><span class="webview_android yes"><span>Android WebView</span><span>37+</span></span><span class="samsunginternet_android no"><span>Samsung Internet</span><span>?</span></span><span class="opera_android yes"><span>Opera Mobile</span><span>10.1+</span></span> </div> </div> </div> <p>The <dfn class="dfn-paneled css" data-dfn-type="at-rule" data-export id="at-ruledef-import">@import</dfn> rule allows users to import style rules from other style sheets. If an <a class="css" data-link-type="maybe" href="#at-ruledef-import" id="ref-for-at-ruledef-import①">@import</a> rule refers to a valid stylesheet, user agents must treat the contents of the stylesheet as if they were written in place of the <span class="css" id="ref-for-at-ruledef-import②">@import</span> rule, with two exceptions:</p> <ul> <li data-md> <p>If a feature (such as the <span class="css">@namespace</span> rule) <em>explicitly</em> defines that it only applies to a particular stylesheet, and not any imported ones, then it doesn’t apply to the imported stylesheet.</p> <li data-md> <p>If a feature relies on the relative ordering of two or more constructs in a stylesheet (such as the requirement that <span class="css">@namespace</span> rules must not have any other rules other than <a class="css" data-link-type="maybe" href="#at-ruledef-import" id="ref-for-at-ruledef-import③">@import</a> preceding it), it only applies between constructs in the same stylesheet.</p> </ul> <p class="example" id="example-d425da12"><a class="self-link" href="#example-d425da12"></a> For example, <a data-link-type="dfn" href="https://drafts.csswg.org/cssom-1/#cssstyledeclaration-declarations" id="ref-for-cssstyledeclaration-declarations③">declarations</a> in style rules from imported stylesheets interact with the cascade as if they were written literally into the stylesheet at the point of the <a class="css" data-link-type="maybe" href="#at-ruledef-import" id="ref-for-at-ruledef-import④">@import</a>. </p> <p>Any <a class="css" data-link-type="maybe" href="#at-ruledef-import" id="ref-for-at-ruledef-import⑤">@import</a> rules must precede all other valid at-rules and style rules in a style sheet (ignoring <a class="css" data-link-type="maybe" href="https://drafts.csswg.org/css-syntax-3/#at-ruledef-charset" id="ref-for-at-ruledef-charset">@charset</a> and empty <a class="css" data-link-type="maybe" href="#at-ruledef-layer" id="ref-for-at-ruledef-layer">@layer</a> definitions) and must not have any other valid at-rules or style rules between it and previous <span class="css" id="ref-for-at-ruledef-import⑥">@import</span> rules, or else the <span class="css" id="ref-for-at-ruledef-import⑦">@import</span> rule is invalid. The syntax of <span class="css" id="ref-for-at-ruledef-import⑧">@import</span> is:</p> <pre class="prod">@import [ <a class="production" data-link-type="type" href="https://drafts.csswg.org/css-values-4/#url-value" id="ref-for-url-value"><url></a> <a data-link-type="grammar" href="https://drafts.csswg.org/css-values-4/#comb-one" id="ref-for-comb-one">|</a> <a class="production" data-link-type="type" href="https://drafts.csswg.org/css-values-4/#string-value" id="ref-for-string-value"><string></a> ] [ layer <a data-link-type="grammar" href="https://drafts.csswg.org/css-values-4/#comb-one" id="ref-for-comb-one①">|</a> layer(<a class="production" data-link-type="type" href="#typedef-layer-name" id="ref-for-typedef-layer-name"><layer-name></a>) ]<a data-link-type="grammar" href="https://drafts.csswg.org/css-values-4/#mult-opt" id="ref-for-mult-opt">?</a> <a class="production" data-link-type="type" href="https://drafts.csswg.org/css-cascade-5/#typedef-import-condition" id="ref-for-typedef-import-condition"><import-condition></a> ; <dfn class="dfn-paneled" data-dfn-type="type" data-export id="typedef-import-conditions"><import-conditions></dfn> = [ supports( [ <a class="production" data-link-type="type" href="https://drafts.csswg.org/css-conditional-3/#typedef-supports-condition" id="ref-for-typedef-supports-condition"><supports-condition></a> <a data-link-type="grammar" href="https://drafts.csswg.org/css-values-4/#comb-one" id="ref-for-comb-one②">|</a> <a class="production" data-link-type="type"><declaration></a> ] ) ]<a data-link-type="grammar" href="https://drafts.csswg.org/css-values-4/#mult-opt" id="ref-for-mult-opt①">?</a> <a class="production" data-link-type="type" href="https://drafts.csswg.org/mediaqueries-4/#typedef-media-query-list" id="ref-for-typedef-media-query-list"><media-query-list></a><a data-link-type="grammar" href="https://drafts.csswg.org/css-values-4/#mult-opt" id="ref-for-mult-opt②">?</a></pre> <p>where:</p> <ul> <li data-md> <p>the <a class="production css" data-link-type="type" href="https://drafts.csswg.org/css-values-4/#url-value" id="ref-for-url-value①"><url></a> or <a class="production css" data-link-type="type" href="https://drafts.csswg.org/css-values-4/#string-value" id="ref-for-string-value①"><string></a> gives the URL of the style sheet to be imported.</p> <li data-md> <p>the optional <span class="css">layer</span> keyword or <span class="css">layer()</span> function assigns the contents of the style sheet into its own anonymous <a data-link-type="dfn" href="#cascade-layers" id="ref-for-cascade-layers①">cascade layer</a> or into the named <span id="ref-for-cascade-layers②">cascade layer</span>.</p> <p>The layer is added to the <a href="#layer-ordering">layer order</a> even if the import fails to load the stylesheet, but is subject to any <a data-link-type="dfn" href="#import-conditions" id="ref-for-import-conditions">import conditions</a> (just as if declared by an <a class="css" data-link-type="maybe" href="#at-ruledef-layer" id="ref-for-at-ruledef-layer①">@layer</a> rule wrapped in the appropriate <a data-link-type="dfn" href="https://drafts.csswg.org/css-conditional-3/#conditional-group-rule" id="ref-for-conditional-group-rule">conditional group rules</a>).</p> <li data-md> <p>the optional <a class="production css" data-link-type="type" href="#typedef-import-conditions" id="ref-for-typedef-import-conditions"><import-conditions></a> states the <a data-link-type="dfn" href="#import-conditions" id="ref-for-import-conditions①">import conditions</a> under which it applies.</p> </ul> <div class="example" id="example-05c74581"> <a class="self-link" href="#example-05c74581"></a> The following <a href="#conditional-import">conditional <span class="css">@import</span> rule</a> only loads the style sheet when the UA <a href="https://www.w3.org/TR/css-conditional-3/#support-definition">supports</a> <a class="css" data-link-type="propdesc" href="https://drafts.csswg.org/css-display-3/#propdef-display" id="ref-for-propdef-display">display: flex</a>, and only applies the style sheet on a <a href="https://www.w3.org/TR/CSS2/media.html#media-types">handheld</a> device with a <a href="https://www.w3.org/TR/mediaqueries-4/#width">maximum viewport width</a> of 400px. <pre>@import url("narrow.css") supports(display: flex) handheld and (max-width: 400px);</pre> </div> <div class="example" id="example-2061dccb"> <a class="self-link" href="#example-2061dccb"></a> The following layer imports load the style sheets into the <span class="css">framework.component</span> layer, and an un-named layer, respectively: <pre>@import url("tabs.css") layer(framework.component); @import url("override.css") layer(); </pre> </div> <p>If a <a class="production css" data-link-type="type" href="https://drafts.csswg.org/css-values-4/#string-value" id="ref-for-string-value②"><string></a> is provided, it must be interpreted as a <a class="production css" data-link-type="type" href="https://drafts.csswg.org/css-values-4/#url-value" id="ref-for-url-value②"><url></a> with the same value.</p> <div class="example" id="example-da2e49cb"> <a class="self-link" href="#example-da2e49cb"></a> The following lines are equivalent in meaning and illustrate both <a class="css" data-link-type="maybe" href="#at-ruledef-import" id="ref-for-at-ruledef-import⑨">@import</a> syntaxes (one with <a class="css" data-link-type="maybe" href="https://drafts.csswg.org/css-values-4/#funcdef-url" id="ref-for-funcdef-url">url()</a> and one with a bare string): <pre class="lang-css highlight"><c- n>@import</c-> <c- s>"mystyle.css"</c-><c- p>;</c-> <c- n>@import</c-> <c- nf>url</c-><c- p>(</c-><c- s>"mystyle.css"</c-><c- p>);</c-> </pre> </div> <h3 class="heading settled" data-level="2.1" id="conditional-import"><span class="secno">2.1. </span><span class="content"> Conditional <a class="css" data-link-type="maybe" href="#at-ruledef-import" id="ref-for-at-ruledef-import①⓪">@import</a> Rules</span><a class="self-link" href="#conditional-import"></a></h3> <p><dfn class="dfn-paneled" data-dfn-type="dfn" data-export id="import-conditions">Import conditions</dfn> allow the import to be media– or feature-support–dependent. In the absence of any <a data-link-type="dfn" href="#import-conditions" id="ref-for-import-conditions②">import conditions</a>, the import is unconditional. (Specifying <span class="css">all</span> for the <a class="production css" data-link-type="type" href="https://drafts.csswg.org/mediaqueries-4/#typedef-media-query-list" id="ref-for-typedef-media-query-list①"><media-query-list></a> has the same effect.) If the <span id="ref-for-import-conditions③">import conditions</span> do not match, the rules in the imported stylesheet do not apply, exactly as if the imported stylesheet were wrapped in <a class="css" data-link-type="maybe" href="https://drafts.csswg.org/css-conditional-3/#at-ruledef-media" id="ref-for-at-ruledef-media">@media</a> and/or <a class="css" data-link-type="maybe" href="https://drafts.csswg.org/css-conditional-3/#at-ruledef-supports" id="ref-for-at-ruledef-supports">@supports</a> blocks with the given conditions.</p> <div class="example" id="example-5fa651f3"> <a class="self-link" href="#example-5fa651f3"></a> The following rules illustrate how <a class="css" data-link-type="maybe" href="#at-ruledef-import" id="ref-for-at-ruledef-import①①">@import</a> rules can be made media-dependent: <pre class="lang-css highlight"><c- n>@import</c-> <c- nf>url</c-><c- p>(</c-><c- s>"fineprint.css"</c-><c- p>)</c-> print<c- p>;</c-> <c- n>@import</c-> <c- nf>url</c-><c- p>(</c-><c- s>"bluish.css"</c-><c- p>)</c-> projection<c- p>,</c-> tv<c- p>;</c-> <c- n>@import</c-> <c- nf>url</c-><c- p>(</c-><c- s>"narrow.css"</c-><c- p>)</c-> handheld and <c- p>(</c->max-width: <c- m>400</c-><c- k>px</c-><c- p>);</c-> </pre> </div> <p>User agents may therefore avoid fetching a conditional import as long as the <a data-link-type="dfn" href="#import-conditions" id="ref-for-import-conditions④">import conditions</a> do not match. Additionally, if a <a class="production css" data-link-type="type" href="https://drafts.csswg.org/css-conditional-3/#typedef-supports-condition" id="ref-for-typedef-supports-condition①"><supports-condition></a> blocks the application of the imported style sheet, the UA <em>must not</em> fetch the style sheet (unless it is loaded through some other link) and <em>must</em> return null for the import rule’s CSSImportRule.styleSheet value (even if it is loaded through some other link).</p> <div class="example" id="example-c6c2c0ee"> <a class="self-link" href="#example-c6c2c0ee"></a> The following rule illustrates how an author can provide fallback rules for legacy user agents without impacting network performance on newer user agents: <pre class="lang-css highlight"><c- n>@import</c-> <c- nf>url</c-><c- p>(</c-><c- s>"fallback-layout.css"</c-><c- p>)</c-> <c- nf>supports</c-><c- p>(</c->not <c- p>(</c->display: flex<c- p>));</c-> <c- n>@supports</c-> <c- p>(</c->display: flex<c- p>)</c-> <c- p>{</c-> ... <c- p>}</c-> </pre> </div> <p>The <a data-link-type="dfn" href="#import-conditions" id="ref-for-import-conditions⑤">import conditions</a> are given by <a class="production css" data-link-type="type" href="https://drafts.csswg.org/mediaqueries-4/#typedef-media-query-list" id="ref-for-typedef-media-query-list②"><media-query-list></a>, which is parsed and interpreted as a <a data-link-type="dfn" href="https://drafts.csswg.org/mediaqueries-4/#media-query-list" id="ref-for-media-query-list">media query list</a>, and <a class="production css" data-link-type="type" href="https://drafts.csswg.org/css-conditional-3/#typedef-supports-condition" id="ref-for-typedef-supports-condition②"><supports-condition></a>, is parsed and interpreted as a [[supports query]]. If a <a class="production css" data-link-type="type"><declaration></a> is given in place of a <span class="production" id="ref-for-typedef-supports-condition③"><supports-condition></span>, it must be interpreted as a <a class="production css" data-link-type="type" href="https://drafts.csswg.org/css-conditional-3/#typedef-supports-decl" id="ref-for-typedef-supports-decl"><supports-decl></a> (i.e. the extra set of parentheses is implied) and treated as a <span class="production" id="ref-for-typedef-supports-condition④"><supports-condition></span>.</p> <div class="example" id="example-75806df4"> <a class="self-link" href="#example-75806df4"></a> For example, the following two lines are equivalent: <pre class="lang-css highlight"><c- n>@import</c-> <c- s>"mystyle.css"</c-> <c- nf>supports</c-><c- p>(</c->display: flex<c- p>);</c-> <c- n>@import</c-> <c- s>"mystyle.css"</c-> <c- nf>supports</c-><c- p>((</c->display: flex<c- p>));</c-> </pre> </div> <p>The evaluation and full syntax of the <a data-link-type="dfn" href="#import-conditions" id="ref-for-import-conditions⑥">import conditions</a> are defined by the <a href="https://www.w3.org/TR/mediaqueries/">Media Queries</a> <a data-link-type="biblio" href="#biblio-mediaq">[MEDIAQ]</a> and <a href="https://www.w3.org/TR/css-conditional/">CSS Conditional Rules</a> <a data-link-type="biblio" href="#biblio-css-conditional-3">[CSS-CONDITIONAL-3]</a> specifications.</p> <h3 class="heading settled" data-level="2.2" id="import-processing"><span class="secno">2.2. </span><span class="content"> Processing Stylesheet Imports</span><a class="self-link" href="#import-processing"></a></h3> <p>When the same style sheet is imported or linked to a document in multiple places, user agents must process (or act as though they do) each link as though the link were to an independent style sheet.</p> <p class="note" role="note"><span>Note:</span> This does not place any requirements on resource fetching, only how the style sheet is reflected in the CSSOM and used in specs such as this one. Assuming appropriate caching, it is perfectly appropriate for a UA to fetch a style sheet only once, even though it’s linked or imported multiple times.</p> <p>The <a data-link-type="dfn" href="#origin" id="ref-for-origin">cascade origin</a> of an imported style sheet is the <span id="ref-for-origin①">cascade origin</span> of the style sheet that imported it.</p> <p>The <a data-link-type="dfn" href="https://drafts.csswg.org/css-syntax-3/#environment-encoding" id="ref-for-environment-encoding">environment encoding</a> of an imported style sheet is the encoding of the style sheet that imported it. <a data-link-type="biblio" href="#biblio-css-syntax-3">[css-syntax-3]</a></p> <h3 class="heading settled" data-level="2.3" id="content-type"><span class="secno">2.3. </span><span class="content"> Content-Type of CSS Style Sheets</span><a class="self-link" href="#content-type"></a></h3> <p>The processing of imported style sheets depends on the actual type of the linked resource:</p> <ul> <li data-md> <p>If the resource does not have <a data-link-type="dfn" href="https://html.spec.whatwg.org/multipage/urls-and-fetching.html#content-type" id="ref-for-content-type">Content-Type metadata</a>, the type is treated as <code>text/css</code>.</p> <li data-md> <p>If the host document is in <a data-link-type="dfn" href="https://dom.spec.whatwg.org/#concept-document-quirks" id="ref-for-concept-document-quirks">quirks mode</a>, and the host document’s origin is <a data-link-type="dfn" href="https://html.spec.whatwg.org/multipage/origin.html#same-origin" id="ref-for-same-origin">same origin</a> with the linked resource <a data-link-type="dfn" href="https://fetch.spec.whatwg.org/#concept-response" id="ref-for-concept-response">response’s</a> <a data-link-type="dfn" href="https://fetch.spec.whatwg.org/#concept-response-url" id="ref-for-concept-response-url">URL’s</a> origin, the type is treated as <code>text/css</code>.</p> <li data-md> <p>Otherwise, the type is determined from its <a data-link-type="dfn" href="https://html.spec.whatwg.org/multipage/urls-and-fetching.html#content-type" id="ref-for-content-type①">Content-Type metadata</a>.</p> </ul> <p>If the linked resource’s type is <code>text/css</code>, it must be interpreted as a CSS style sheet. Otherwise, it must be interpreted as a network error.</p> <h2 class="heading settled" data-level="3" id="shorthand"><span class="secno">3. </span><span class="content"> Shorthand Properties</span><a class="self-link" href="#shorthand"></a></h2> <p>Some properties are <dfn class="dfn-paneled" data-dfn-type="dfn" data-export data-lt="shorthand property | shorthand" id="shorthand-property">shorthand properties</dfn>, meaning that they allow authors to specify the values of several properties with a single property. A <a data-link-type="dfn" href="#shorthand-property" id="ref-for-shorthand-property">shorthand property</a> sets all of its <dfn class="dfn-paneled" data-dfn-type="dfn" data-export data-lt="longhand | longhand property | sub-property" id="longhand">longhand sub-properties</dfn>, exactly as if expanded in place.</p> <p>When values are omitted from a <a data-link-type="dfn" href="#shorthand-property" id="ref-for-shorthand-property①">shorthand</a> form, unless otherwise defined, each “missing” <a data-link-type="dfn" href="#longhand" id="ref-for-longhand">sub-property</a> is assigned its <a data-link-type="dfn" href="#initial-value" id="ref-for-initial-value①">initial value</a>.</p> <div class="note" role="note"> This means that a <a data-link-type="dfn" href="#shorthand-property" id="ref-for-shorthand-property②">shorthand</a> <a data-link-type="dfn" href="https://drafts.csswg.org/css-syntax-3/#css-property-declarations" id="ref-for-css-property-declarations①">property declaration</a> always sets <em>all</em> of its <a data-link-type="dfn" href="#longhand" id="ref-for-longhand①">sub-properties</a>, even those that are not explicitly set. Carelessly used, this might result in inadvertently resetting some <span id="ref-for-longhand②">sub-properties</span>. Carefully used, a <span id="ref-for-shorthand-property③">shorthand</span> can guarantee a “blank slate” by resetting <span id="ref-for-longhand③">sub-properties</span> inadvertently cascaded from other sources. <p>For example, writing <a class="css" data-link-type="propdesc" href="https://drafts.csswg.org/css-backgrounds-3/#propdef-background" id="ref-for-propdef-background">background: green</a> rather than <a class="css" data-link-type="propdesc" href="https://drafts.csswg.org/css-backgrounds-3/#propdef-background-color" id="ref-for-propdef-background-color">background-color: green</a> ensures that the background color overrides any earlier <a data-link-type="dfn" href="https://drafts.csswg.org/cssom-1/#cssstyledeclaration-declarations" id="ref-for-cssstyledeclaration-declarations④">declarations</a> that might have set the background to an image with <a class="property css" data-link-type="property" href="https://drafts.csswg.org/css-backgrounds-3/#propdef-background-image" id="ref-for-propdef-background-image">background-image</a>.</p> </div> <div class="example" id="example-8762997a"> <a class="self-link" href="#example-8762997a"></a> For example, the CSS Level 1 <a class="property css" data-link-type="property" href="https://drafts.csswg.org/css-fonts-4/#propdef-font" id="ref-for-propdef-font">font</a> property is a <a data-link-type="dfn" href="#shorthand-property" id="ref-for-shorthand-property④">shorthand</a> property for setting <a class="css" data-link-type="property" href="https://drafts.csswg.org/css-fonts-4/#propdef-font-style" id="ref-for-propdef-font-style">font-style</a>, <a class="css" data-link-type="property" href="https://drafts.csswg.org/css-fonts-4/#propdef-font-variant" id="ref-for-propdef-font-variant">font-variant</a>, <a class="css" data-link-type="property" href="https://drafts.csswg.org/css-fonts-4/#propdef-font-weight" id="ref-for-propdef-font-weight">font-weight</a>, <a class="property css" data-link-type="property" href="https://drafts.csswg.org/css-fonts-4/#propdef-font-size" id="ref-for-propdef-font-size①">font-size</a>, <a class="property css" data-link-type="property" href="https://drafts.csswg.org/css2/#propdef-line-height" id="ref-for-propdef-line-height">line-height</a>, and <a class="css" data-link-type="property" href="https://drafts.csswg.org/css-fonts-4/#propdef-font-family" id="ref-for-propdef-font-family">font-family</a> all at once. The multiple declarations of this example: <pre class="lang-css highlight">h1 <c- p>{</c-> <c- k>font-weight</c-><c- p>:</c-> bold<c- p>;</c-> <c- k>font-size</c-><c- p>:</c-> <c- m>12</c-><c- k>pt</c-><c- p>;</c-> <c- k>line-height</c-><c- p>:</c-> <c- m>14</c-><c- k>pt</c-><c- p>;</c-> <c- k>font-family</c-><c- p>:</c-> Helvetica<c- p>;</c-> <c- k>font-variant</c-><c- p>:</c-> normal<c- p>;</c-> <c- k>font-style</c-><c- p>:</c-> normal<c- p>;</c-> <c- p>}</c-> </pre> <p>can therefore be rewritten as</p> <pre class="lang-css highlight">h1 <c- p>{</c-> <c- k>font</c-><c- p>:</c-> bold <c- m>12</c-><c- k>pt</c->/<c- m>14</c-><c- k>pt</c-> Helvetica <c- p>}</c-></pre> <p>As more <a class="property css" data-link-type="property" href="https://drafts.csswg.org/css-fonts-4/#propdef-font" id="ref-for-propdef-font①">font</a> <a data-link-type="dfn" href="#longhand" id="ref-for-longhand④">sub-properties</a> are introduced into CSS, the shorthand declaration resets those to their initial values as well.</p> </div> <p>In some cases, a <a data-link-type="dfn" href="#shorthand-property" id="ref-for-shorthand-property⑤">shorthand</a> might have different syntax or special keywords that don’t directly correspond to values of its <a data-link-type="dfn" href="#longhand" id="ref-for-longhand⑤">sub-properties</a>. (In such cases, the <span id="ref-for-shorthand-property⑥">shorthand</span> will explicitly define the expansion of its values.)</p> <p>In other cases, a property might be a <dfn class="dfn-paneled" data-dfn-type="dfn" data-export id="reset-only-sub-property">reset-only sub-property</dfn> of the shorthand: Like other <a data-link-type="dfn" href="#longhand" id="ref-for-longhand⑥">sub-properties</a>, it is reset to its initial value by the shorthand when unspecified, but the shorthand might not include syntax to set the <span id="ref-for-longhand⑦">sub-property</span> to any of its other values. <span class="ex">For example, the <a class="property css" data-link-type="property" href="https://drafts.csswg.org/css-backgrounds-3/#propdef-border" id="ref-for-propdef-border">border</a> shorthand resets <a class="property css" data-link-type="property" href="https://drafts.csswg.org/css-backgrounds-3/#propdef-border-image" id="ref-for-propdef-border-image">border-image</a> to its initial value of <span class="css">none</span>, but has no syntax to set it to anything else. <a data-link-type="biblio" href="#biblio-css-backgrounds-3">[css-backgrounds-3]</a></span></p> <p>If a <a data-link-type="dfn" href="#shorthand-property" id="ref-for-shorthand-property⑦">shorthand</a> is specified as one of the <a href="https://www.w3.org/TR/css-values/#common-keywords">CSS-wide keywords</a> <a data-link-type="biblio" href="#biblio-css-values-3">[css-values-3]</a>, it sets all of its <a data-link-type="dfn" href="#longhand" id="ref-for-longhand⑧">sub-properties</a> to that keyword, including any that are <a data-link-type="dfn" href="#reset-only-sub-property" id="ref-for-reset-only-sub-property">reset-only sub-properties</a>. (Note that these keywords cannot be combined with other values in a single <a data-link-type="dfn" href="https://drafts.csswg.org/css-syntax-3/#declaration" id="ref-for-declaration">declaration</a>, not even in a shorthand.)</p> <p>Declaring a <a data-link-type="dfn" href="#shorthand-property" id="ref-for-shorthand-property⑧">shorthand</a> property to be <span class="css">!important</span> is equivalent to declaring all of its <a data-link-type="dfn" href="#longhand" id="ref-for-longhand⑨">sub-properties</a> to be <span class="css">!important</span>.</p> <h3 class="heading settled" data-level="3.1" id="aliasing"><span class="secno">3.1. </span><span class="content"> Property Aliasing</span><a class="self-link" href="#aliasing"></a></h3> <p>Properties sometimes change names after being supported for a while, such as vendor-prefixed properties being standardized. The original name still needs to be supported for compatibility reasons, but the new name is preferred. To accomplish this, CSS defines two different ways of “aliasing” old syntax to new syntax.</p> <dl> <dt><dfn class="dfn-paneled" data-dfn-type="dfn" data-export data-lt="legacy name alias" id="legacy-name-alias">legacy name aliases</dfn> <dd> When the old property’s value syntax is identical to that of the new property, the two names are aliased with an operation on par with case-mapping: at parse time, the old property is converted into the new property. This conversion also applies in the CSSOM, both for string arguments and property accessors: requests for the old property name transparently transfer to the new property name instead. <div class="example" id="example-5dd1d5a6"><a class="self-link" href="#example-5dd1d5a6"></a> For example, if <span class="css">old-name</span> is a <a data-link-type="dfn" href="#legacy-name-alias" id="ref-for-legacy-name-alias">legacy name alias</a> for <span class="css">new-name</span>, <code class="highlight">getComputedStyle<c- p>(</c->el<c- p>).</c->oldName</code> will return the computed style of the <code class="highlight">newName</code> property, and <code class="highlight">el<c- p>.</c->style<c- p>.</c->setPropertyValue<c- p>(</c-><c- u>"old-name"</c-><c- p>,</c-> <c- u>"value"</c-><c- p>)</c-></code> will set the <span class="css">new-name</span> property to <code class="highlight"><c- u>"value"</c-></code>. </div> <dt><dfn class="dfn-paneled" data-dfn-type="dfn" data-export data-lt="legacy shorthand" id="legacy-shorthand">legacy shorthands</dfn> <dd> When the old property has a distinct syntax from the new property, the two names are aliased using the <a data-link-type="dfn" href="#shorthand-property" id="ref-for-shorthand-property⑨">shorthand</a> mechanism. These shorthands are defined to be <a data-link-type="dfn" href="#legacy-shorthand" id="ref-for-legacy-shorthand">legacy shorthands</a>, and their use is <em>deprecated</em>. They otherwise behave exactly as regular shorthands, except that the CSSOM will not use them when serializing declarations. <a data-link-type="biblio" href="#biblio-cssom">[CSSOM]</a> <div class="example" id="example-c7a1887e"> <a class="self-link" href="#example-c7a1887e"></a> For example, the <a class="property css" data-link-type="property">page-break-*</a> properties are <a data-link-type="dfn" href="#legacy-shorthand" id="ref-for-legacy-shorthand①">legacy shorthands</a> for the <span class="property">break-*</span> properties (see <a href="https://drafts.csswg.org/css-break-3/#page-break-properties"><cite>CSS Fragmentation 3</cite> § 3.4 Page Break Aliases: the page-break-before, page-break-after, and page-break-inside properties</a>). <p>Setting <a class="css" data-link-type="propdesc" href="https://drafts.csswg.org/css2/#propdef-page-break-before" id="ref-for-propdef-page-break-before">page-break-before: always</a> expands to <a class="css" data-link-type="propdesc" href="https://drafts.csswg.org/css-break-3/#propdef-break-before" id="ref-for-propdef-break-before">break-before: page</a> at parse time, like other shorthands do. Similarly, if <span class="css" id="ref-for-propdef-break-before①">break-before: page</span> is set, calling <code class="highlight">getComputedStyle<c- p>(</c->el<c- p>).</c->pageBreakBefore</code> will return <code class="highlight"><c- u>"always"</c-></code>. However, when serializing a style block (see <a href="https://drafts.csswg.org/cssom-1/#serializing-css-values"><cite>CSSOM 1</cite> § 6.7.2 Serializing CSS Values</a>), the <span class="property" id="ref-for-propdef-page-break-before①">page-break-before</span> property will never be chosen as the shorthand to serialize to, regardless of whether it or <span class="property" id="ref-for-propdef-break-before②">break-before</span> was specified; instead, <span class="property" id="ref-for-propdef-break-before③">break-before</span> will always be chosen.</p> </div> </dl> <h3 class="heading settled caniuse-paneled" data-level="3.2" id="all-shorthand"><span class="secno">3.2. </span><span class="content"> Resetting All Properties: the <a class="property css" data-link-type="property" href="#propdef-all" id="ref-for-propdef-all">all</a> property</span><a class="self-link" href="#all-shorthand"></a></h3> <table class="def propdef" data-link-for-hint="all"> <tbody> <tr> <th>Name: <td><dfn class="dfn-paneled css" data-dfn-type="property" data-export id="propdef-all">all</dfn> <tr class="value"> <th><a href="https://www.w3.org/TR/css-values/#value-defs">Value:</a> <td class="prod">initial <a data-link-type="grammar" href="https://drafts.csswg.org/css-values-4/#comb-one" id="ref-for-comb-one③">|</a> inherit <span id="ref-for-comb-one④">|</span> unset <span id="ref-for-comb-one⑤">|</span> revert <span id="ref-for-comb-one⑥">|</span> revert-layer <tr> <th><a href="https://www.w3.org/TR/css-cascade/#initial-values">Initial:</a> <td>see individual properties <tr> <th><a href="https://www.w3.org/TR/css-cascade/#applies-to">Applies to:</a> <td>see individual properties <tr> <th><a href="https://www.w3.org/TR/css-cascade/#inherited-property">Inherited:</a> <td>see individual properties <tr> <th><a href="https://www.w3.org/TR/css-values/#percentages">Percentages:</a> <td>see individual properties <tr> <th><a href="https://www.w3.org/TR/css-cascade/#computed">Computed value:</a> <td>see individual properties <tr> <th><a href="https://www.w3.org/TR/web-animations/#animation-type">Animation type:</a> <td>see individual properties <tr> <th><a href="https://www.w3.org/TR/cssom/#serializing-css-values">Canonical order:</a> <td>per grammar </table> <p>The <a class="property css" data-link-type="property" href="#propdef-all" id="ref-for-propdef-all①">all</a> property is a <a data-link-type="dfn" href="#shorthand-property" id="ref-for-shorthand-property①⓪">shorthand</a> that resets <em>all</em> CSS properties except <a class="property css" data-link-type="property" href="https://drafts.csswg.org/css-writing-modes-3/#propdef-direction" id="ref-for-propdef-direction">direction</a> and <a class="property css" data-link-type="property" href="https://drafts.csswg.org/css-writing-modes-3/#propdef-unicode-bidi" id="ref-for-propdef-unicode-bidi">unicode-bidi</a>. It only accepts the <a href="https://www.w3.org/TR/css-values/#common-keywords">CSS-wide keywords</a>. It does not reset <a data-link-type="dfn" href="https://drafts.csswg.org/css-variables-1/#custom-property" id="ref-for-custom-property">custom properties</a> <a data-link-type="biblio" href="#biblio-css-variables-1">[css-variables-1]</a>.</p> <p class="note" role="note"><span>Note:</span> The excepted CSS properties <a class="property css" data-link-type="property" href="https://drafts.csswg.org/css-writing-modes-3/#propdef-direction" id="ref-for-propdef-direction①">direction</a> and <a class="property css" data-link-type="property" href="https://drafts.csswg.org/css-writing-modes-3/#propdef-unicode-bidi" id="ref-for-propdef-unicode-bidi①">unicode-bidi</a> are actually markup-level features, and <a href="https://www.w3.org/TR/css-writing-modes-3/#text-direction">should not be set in the author’s style sheet</a>. (They exist as CSS properties only to style document languages not supported by the UA.) Authors should use the appropriate markup, such as HTML’s <code>dir</code> attribute, instead. <a data-link-type="biblio" href="#biblio-css-writing-modes-3">[css-writing-modes-3]</a></p> <div class="example" id="example-dae18981"> <a class="self-link" href="#example-dae18981"></a> For example, if an author specifies <a class="css" data-link-type="propdesc" href="#propdef-all" id="ref-for-propdef-all②">all: initial</a> on an element, it will block all inheritance and reset all properties, as if no rules appeared in the author, user, or user-agent levels of the cascade. <p>This can be useful for the root element of a "widget" included in a page, which does not wish to inherit the styles of the outer page. Note, however, that any "default" style applied to that element (such as, e.g. <a class="css" data-link-type="propdesc" href="https://drafts.csswg.org/css-display-3/#propdef-display" id="ref-for-propdef-display①">display: block</a> from the UA style sheet on block elements such as <code><div></code>) will also be blown away.</p> </div> <h2 class="heading settled" data-level="4" id="value-stages"><span class="secno">4. </span><span class="content"> Value Processing</span><a class="self-link" href="#value-stages"></a></h2> <p>Once a user agent has parsed a document and constructed a document tree, it must assign, to every element in the <a data-link-type="dfn" href="https://drafts.csswg.org/css-scoping-1/#flat-tree" id="ref-for-flat-tree">flat tree</a>, and correspondingly to every box in the formatting structure, a value to every property that applies to the target media type.</p> <p>The final value of a CSS property for a given element or box is the result of a multi-step calculation:</p> <ol> <li> First, all the <a data-link-type="dfn" href="#declared-value" id="ref-for-declared-value">declared values</a> applied to an element are collected, for each property on each element. There may be zero or many <span id="ref-for-declared-value①">declared values</span> applied to the element. <li> Cascading yields the <a data-link-type="dfn" href="#cascaded-value" id="ref-for-cascaded-value">cascaded value</a>. There is at most one <span id="ref-for-cascaded-value①">cascaded value</span> per property per element. <li> Defaulting yields the <a data-link-type="dfn" href="#specified-value" id="ref-for-specified-value①">specified value</a>. Every element has exactly one <span id="ref-for-specified-value②">specified value</span> per property. <li> Resolving value dependencies yields the <a data-link-type="dfn" href="#computed-value" id="ref-for-computed-value">computed value</a>. Every element has exactly one <span id="ref-for-computed-value①">computed value</span> per property. <li> Formatting the document yields the <a data-link-type="dfn" href="#used-value" id="ref-for-used-value">used value</a>. An element only has a <span id="ref-for-used-value①">used value</span> for a given property if that property applies to the element. <li> Finally, the used value is transformed to the <a data-link-type="dfn" href="#actual-value" id="ref-for-actual-value">actual value</a> based on constraints of the display environment. As with the <a data-link-type="dfn" href="#used-value" id="ref-for-used-value②">used value</a>, there may or may not be an <span id="ref-for-actual-value①">actual value</span> for a given property on an element. </ol> <p>Elements that are not <a data-link-type="dfn" href="https://dom.spec.whatwg.org/#connected" id="ref-for-connected">connected</a> or are not part of the document’s <a data-link-type="dfn" href="https://drafts.csswg.org/css-scoping-1/#flat-tree" id="ref-for-flat-tree①">flattened element tree</a> do not participate in CSS value processing, and do not have <a data-link-type="dfn" href="#declared-value" id="ref-for-declared-value②">declared</a>, <a data-link-type="dfn" href="#cascaded-value" id="ref-for-cascaded-value②">cascaded</a>, <a data-link-type="dfn" href="#specified-value" id="ref-for-specified-value③">specified</a>, <a data-link-type="dfn" href="#computed-value" id="ref-for-computed-value②">computed</a>, <a data-link-type="dfn" href="#used-value" id="ref-for-used-value③">used</a>, or <a data-link-type="dfn" href="#actual-value" id="ref-for-actual-value②">actual</a> values, even if they potentially have style <a data-link-type="dfn" href="https://drafts.csswg.org/cssom-1/#cssstyledeclaration-declarations" id="ref-for-cssstyledeclaration-declarations⑤">declarations</a> assigned to them (for example, by a <code>style</code> attribute).</p> <h3 class="heading settled" data-level="4.1" id="declared"><span class="secno">4.1. </span><span class="content"> Declared Values</span><a class="self-link" href="#declared"></a></h3> <p>Each <a data-link-type="dfn" href="https://drafts.csswg.org/css-syntax-3/#css-property-declarations" id="ref-for-css-property-declarations②">property declaration</a> <a href="#filtering">applied to an element</a> contributes a <dfn class="dfn-paneled" data-dfn-type="dfn" data-export data-local-lt="declared" id="declared-value">declared value</dfn> for that property associated with the element. See <a href="#filtering">Filtering Declarations</a> for details.</p> <p>These values are then processed by the <a data-link-type="dfn" href="#cascade" id="ref-for-cascade①">cascade</a> to choose a single “winning value”.</p> <h4 class="heading settled" data-level="4.1.1" id="value-aliasing"><span class="secno">4.1.1. </span><span class="content"> Value Aliasing</span><a class="self-link" href="#value-aliasing"></a></h4> <p>Some property values have <dfn data-dfn-for="CSS" data-dfn-type="dfn" data-export data-lt="legacy value alias" id="css-legacy-value-alias">legacy value aliases<a class="self-link" href="#css-legacy-value-alias"></a></dfn>: at parse time, the legacy syntax is converted into the new syntax, resulting in a <a data-link-type="dfn" href="#declared-value" id="ref-for-declared-value③">declared value</a> different from the parsed input. These aliases are typically used for handling legacy compatibility requirements, such as converting <a data-link-type="dfn" href="https://drafts.csswg.org/css-2021/#vendor-prefix" id="ref-for-vendor-prefix">vendor-prefixed</a> values to their standard equivalents.</p> <h3 class="heading settled" data-level="4.2" id="cascaded"><span class="secno">4.2. </span><span class="content"> Cascaded Values</span><a class="self-link" href="#cascaded"></a></h3> <p>The <dfn class="dfn-paneled" data-dfn-type="dfn" data-export data-local-lt="cascaded" id="cascaded-value">cascaded value</dfn> represents the result of <a href="#cascade" id="ref-for-cascade①⑥">the cascade</a>: it is the <a data-link-type="dfn" href="#declared-value" id="ref-for-declared-value④">declared value</a> that wins the cascade (is sorted first in the <a data-link-type="dfn" href="#output-of-the-cascade" id="ref-for-output-of-the-cascade">output of the cascade</a>). If the <span id="ref-for-output-of-the-cascade①">output of the cascade</span> is an empty list, there is no <a data-link-type="dfn" href="#cascaded-value" id="ref-for-cascaded-value③">cascaded value</a>.</p> <h3 class="heading settled" data-level="4.3" id="specified"><span class="secno">4.3. </span><span class="content"> Specified Values</span><a class="self-link" href="#specified"></a></h3> <p>The <dfn class="dfn-paneled" data-dfn-type="dfn" data-export data-local-lt="specified" id="specified-value">specified value</dfn> is the value of a given property that the style sheet authors intended for that element. It is the result of putting the <a data-link-type="dfn" href="#cascaded-value" id="ref-for-cascaded-value④">cascaded value</a> through the <a href="#defaulting">defaulting</a> processes, guaranteeing that a <a data-link-type="dfn" href="#specified-value" id="ref-for-specified-value④">specified value</a> exists for every property on every element.</p> <p>In many cases, the <a data-link-type="dfn" href="#specified-value" id="ref-for-specified-value⑤">specified value</a> is the <a data-link-type="dfn" href="#cascaded-value" id="ref-for-cascaded-value⑤">cascaded value</a>. However, if there is no <span id="ref-for-cascaded-value⑥">cascaded value</span> at all, the <span id="ref-for-specified-value⑥">specified value</span> is <a href="#defaulting">defaulted</a>. The <a data-link-type="dfn" href="https://drafts.csswg.org/css-values-4/#css-wide-keywords" id="ref-for-css-wide-keywords">CSS-wide keywords</a> are handled specially when they are the <span id="ref-for-cascaded-value⑦">cascaded value</span> of a property, setting the <span id="ref-for-specified-value⑦">specified value</span> as required by that keyword, see <a href="#defaulting-keywords">§ 7.3 Explicit Defaulting</a>.</p> <h3 class="heading settled" data-level="4.4" id="computed"><span class="secno">4.4. </span><span class="content"> Computed Values</span><a class="self-link" href="#computed"></a></h3> <p>The <dfn class="dfn-paneled" data-dfn-type="dfn" data-export data-local-lt="computed" id="computed-value">computed value</dfn> is the result of resolving the <a data-link-type="dfn" href="#specified-value" id="ref-for-specified-value⑧">specified value</a> as defined in the “Computed Value” line of the property definition table, generally absolutizing it in preparation for <a data-link-type="dfn" href="#inheritance" id="ref-for-inheritance①">inheritance</a>.</p> <p class="note" role="note"><span>Note:</span> The <a data-link-type="dfn" href="#computed-value" id="ref-for-computed-value③">computed value</a> is the value that is transferred from parent to child during <a data-link-type="dfn" href="#inheritance" id="ref-for-inheritance②">inheritance</a>. For historical reasons, it is not necessarily the value returned by the <code class="idl"><a data-link-type="idl" href="https://drafts.csswg.org/cssom-1/#dom-window-getcomputedstyle" id="ref-for-dom-window-getcomputedstyle">getComputedStyle()</a></code> function, which sometimes returns <a data-link-type="dfn" href="#used-value" id="ref-for-used-value④">used values</a>. <a data-link-type="biblio" href="#biblio-cssom">[CSSOM]</a> Furthermore, the <span id="ref-for-computed-value④">computed value</span> is an abstract data representation: their definitions reflect that data representation, not how that data is serialized. For example, serialization rules often allow omitting certain values which are implied during parsing; but those values are nonetheless part of the <span id="ref-for-computed-value⑤">computed value</span>.</p> <div class="example" id="example-29410c97"> <a class="self-link" href="#example-29410c97"></a> A <a data-link-type="dfn" href="#specified-value" id="ref-for-specified-value⑨">specified value</a> can be either absolute (i.e., not relative to another value, as in <a class="css" data-link-type="maybe" href="https://drafts.csswg.org/css-color-4/#valdef-color-red" id="ref-for-valdef-color-red①">red</a> or <span class="css">2mm</span>) or relative (i.e., relative to another value, as in <a class="css" data-link-type="maybe" href="https://drafts.csswg.org/css-align-3/#valdef-justify-self-auto" id="ref-for-valdef-justify-self-auto">auto</a>, <span class="css">2em</span>). Computing a relative value generally absolutizes it: <ul> <li> values with relative units (<a class="css" data-link-type="maybe" href="https://drafts.csswg.org/css-values-4/#em" id="ref-for-em">em</a>, <a class="css" data-link-type="maybe" href="https://drafts.csswg.org/css-values-3/#ex" id="ref-for-ex">ex</a>, <a class="css" data-link-type="maybe" href="https://drafts.csswg.org/css-values-4/#valdef-length-vh" id="ref-for-valdef-length-vh">vh</a>, <a class="css" data-link-type="maybe" href="https://drafts.csswg.org/css-values-4/#valdef-length-vw" id="ref-for-valdef-length-vw">vw</a>) must be made absolute by multiplying with the appropriate reference size <li> certain keywords (e.g., <span class="css">smaller</span>, <a class="css" data-link-type="maybe" href="https://drafts.csswg.org/css-fonts-4/#valdef-font-weight-bolder" id="ref-for-valdef-font-weight-bolder">bolder</a>) must be replaced according to their definitions <li> percentages on some properties must be multiplied by a reference value (defined by the property) <li> valid relative URLs must be resolved to become absolute. </ul> <p>See examples (f), (g) and (h) in the <a href="#stages-examples">table below</a>.</p> </div> <p class="note" role="note"><span>Note:</span> In general, the <a data-link-type="dfn" href="#computed-value" id="ref-for-computed-value⑥">computed value</a> resolves the <a data-link-type="dfn" href="#specified-value" id="ref-for-specified-value①⓪">specified value</a> as far as possible without laying out the document or performing other expensive or hard-to-parallelize operations, such as resolving network requests or retrieving values other than from the element and its parent.</p> <p>The <a data-link-type="dfn" href="#computed-value" id="ref-for-computed-value⑦">computed value</a> exists even when the property does not apply. However, some properties may change how they determine the <span id="ref-for-computed-value⑧">computed value</span> based on whether the property <a data-link-type="dfn" href="#apply" id="ref-for-apply">applies to</a> the element.</p> <h3 class="heading settled" data-level="4.5" id="used"><span class="secno">4.5. </span><span class="content"> Used Values</span><a class="self-link" href="#used"></a></h3> <p>The <dfn class="dfn-paneled" data-dfn-type="dfn" data-export data-local-lt="used" id="used-value">used value</dfn> is the result of taking the <a data-link-type="dfn" href="#computed-value" id="ref-for-computed-value⑨">computed value</a> and completing any remaining calculations to make it the absolute theoretical value used in the formatting of the document.</p> <p class="example" id="example-aaa6b50b"><a class="self-link" href="#example-aaa6b50b"></a> For example, a declaration of <a class="css" data-link-type="propdesc" href="https://drafts.csswg.org/css-sizing-3/#propdef-width" id="ref-for-propdef-width">width: auto</a> can’t be resolved into a length without knowing the layout of the element’s ancestors, so the <a data-link-type="dfn" href="#computed-value" id="ref-for-computed-value①⓪">computed value</a> is <a class="css" data-link-type="maybe" href="https://drafts.csswg.org/css-align-3/#valdef-justify-self-auto" id="ref-for-valdef-justify-self-auto①">auto</a>, while the <a data-link-type="dfn" href="#used-value" id="ref-for-used-value⑤">used value</a> is an absolute length, such as <span class="css">100px</span>. <a data-link-type="biblio" href="#biblio-css2">[CSS2]</a> </p> <p class="example" id="example-aac2d669"><a class="self-link" href="#example-aac2d669"></a> As another example, a <code><div></code> might have a computed <a class="property css" data-link-type="property" href="https://drafts.csswg.org/css-break-3/#propdef-break-before" id="ref-for-propdef-break-before④">break-before</a> value of <a class="css" data-link-type="maybe" href="https://drafts.csswg.org/css-align-3/#valdef-justify-self-auto" id="ref-for-valdef-justify-self-auto②">auto</a>, but acquire a used <span class="property" id="ref-for-propdef-break-before⑤">break-before</span> value of <a class="css" data-link-type="maybe" href="https://drafts.csswg.org/css-break-4/#valdef-break-before-page" id="ref-for-valdef-break-before-page">page</a> by propagation from its first child. <a data-link-type="biblio" href="#biblio-css-break-3">[css-break-3]</a> </p> <p>If a property does not <a data-link-type="dfn" href="#apply" id="ref-for-apply①">apply to</a> this element or box type then it has no <a data-link-type="dfn" href="#used-value" id="ref-for-used-value⑥">used value</a> for that property.</p> <p class="example" id="example-19a1092f"><a class="self-link" href="#example-19a1092f"></a> For example, the <a class="property css" data-link-type="property" href="https://drafts.csswg.org/css-flexbox-1/#propdef-flex" id="ref-for-propdef-flex">flex</a> property has no <a data-link-type="dfn" href="#used-value" id="ref-for-used-value⑦">used value</a> on elements that aren’t <a data-link-type="dfn" href="https://drafts.csswg.org/css-flexbox-1/#flex-item" id="ref-for-flex-item">flex items</a>. </p> <h4 class="heading settled" data-level="4.5.1" id="applies-to"><span class="secno">4.5.1. </span><span class="content"> Applicable Properties</span><a class="self-link" href="#applies-to"></a></h4> <p>If a property does not <dfn class="dfn-paneled" data-dfn-for="CSS" data-dfn-type="dfn" data-export id="apply">apply to</dfn> an element or box type—<wbr>as noted in its “Applies to” line—<wbr>this means it does not directly take effect on that type of box or element.</p> <p class="note" role="note"><span>Note:</span> A property that does not apply can still have <em>indirect</em> formatting effects if its computed value affects the computation of other properties that do apply; and of course its <a data-link-type="dfn" href="#computed-value" id="ref-for-computed-value①①">computed value</a>, which always exists, can still inherit to descendants and take effect on them.</p> <div class="example" id="example-9b82d3cf"><a class="self-link" href="#example-9b82d3cf"></a> Even though <a class="property css" data-link-type="property" href="https://drafts.csswg.org/css-writing-modes-4/#propdef-writing-mode" id="ref-for-propdef-writing-mode">writing-mode</a> and <a class="property css" data-link-type="property" href="https://drafts.csswg.org/css-writing-modes-4/#propdef-text-orientation" id="ref-for-propdef-text-orientation">text-orientation</a> do not apply to table rows (they do not affect how the table row or its children are laid out), setting them on such boxes will still affect the calculation of font relative units such as <a class="css" data-link-type="maybe" href="https://drafts.csswg.org/css-values-4/#ch" id="ref-for-ch">ch</a>, and thus possibly any property that takes a <a class="production css" data-link-type="type" href="https://drafts.csswg.org/css-values-4/#length-value" id="ref-for-length-value" title="Expands to: advance measure | cap | ch | cm | dvb | dvh | dvi | dvmax | dvmin | dvw | em | ex | ic | in | lh | lvb | lvh | lvi | lvmax | lvmin | lvw | mm | pc | pt | px | q | rcap | rch | rem | rex | ric | rlh | svb | svh | svi | svmax | svmin | svw | vb | vh | vi | vmax | vmin | vw"><length></a>. </div> <div class="example" id="example-c1c9d619"><a class="self-link" href="#example-c1c9d619"></a> Setting <a class="property css" data-link-type="property" href="https://drafts.csswg.org/css-text-4/#propdef-text-transform" id="ref-for-propdef-text-transform">text-transform</a> on an HTML <code><a data-link-type="element" href="https://html.spec.whatwg.org/multipage/grouping-content.html#the-p-element" id="ref-for-the-p-element">p</a></code> element (which is <a class="css" data-link-type="propdesc" href="https://drafts.csswg.org/css-display-3/#propdef-display" id="ref-for-propdef-display②">display: block</a> by default) will have an effect, even though <span class="property" id="ref-for-propdef-text-transform①">text-transform</span> only applies to <a data-link-type="dfn" href="https://drafts.csswg.org/css-display-3/#inline-box" id="ref-for-inline-box">inline boxes</a>, because the property inherits into the paragraph’s anonymous <a data-link-type="dfn" href="https://drafts.csswg.org/css-inline-3/#root-inline-box" id="ref-for-root-inline-box">root inline box</a> and applies to the text it contains. </div> <p class="note" role="note"><span>Note:</span> A property defined to apply to “all elements” applies to all elements and <a data-link-type="dfn" href="https://drafts.csswg.org/css-display-3/#display-type" id="ref-for-display-type">display types</a>, but not necessarily to all <a data-link-type="dfn" href="https://drafts.csswg.org/selectors-4/#pseudo-element" id="ref-for-pseudo-element">pseudo-element</a> types, since pseudo-elements often have their own specific rendering models or other restrictions. The <a class="css" data-link-type="maybe" href="https://drafts.csswg.org/css-pseudo-4/#selectordef-before" id="ref-for-selectordef-before">::before</a> and <a class="css" data-link-type="maybe" href="https://drafts.csswg.org/css-pseudo-4/#selectordef-after" id="ref-for-selectordef-after">::after</a> pseudo-elements, however, are defined to generate boxes almost exactly like normal elements and are therefore defined accept all properties that apply to “all elements”. See <a data-link-type="biblio" href="#biblio-css-pseudo-4">[CSS-PSEUDO-4]</a> for more information about <span id="ref-for-pseudo-element①">pseudo-elements</span>.</p> <h3 class="heading settled" data-level="4.6" id="actual"><span class="secno">4.6. </span><span class="content"> Actual Values</span><a class="self-link" href="#actual"></a></h3> <p>A <a data-link-type="dfn" href="#used-value" id="ref-for-used-value⑧">used value</a> is in principle ready to be used, but a user agent may not be able to make use of the value in a given environment. <span class="ex">For example, a user agent may only be able to render borders with integer pixel widths and may therefore have to approximate the <a data-link-type="dfn" href="#used-value" id="ref-for-used-value⑨">used</a> width. Also, the font size of an element may need adjustment based on the availability of fonts or the value of the <a class="property css" data-link-type="property" href="https://drafts.csswg.org/css-fonts-5/#propdef-font-size-adjust" id="ref-for-propdef-font-size-adjust">font-size-adjust</a> property.</span> The <dfn class="dfn-paneled" data-dfn-type="dfn" data-export data-local-lt="actual" id="actual-value">actual value</dfn> is the used value after any such adjustments have been made.</p> <p class="note" role="note"><span>Note:</span> By probing the actual values of elements, much can be learned about how the document is laid out. However, not all information is recorded in the actual values. For example, the actual value of the <a class="property css" data-link-type="property" href="https://drafts.csswg.org/css2/#propdef-page-break-after" id="ref-for-propdef-page-break-after">page-break-after</a> property does not reflect whether there is a page break or not after the element. Similarly, the actual value of <a class="property css" data-link-type="property" href="https://drafts.csswg.org/css-break-3/#propdef-orphans" id="ref-for-propdef-orphans">orphans</a> does not reflect how many orphan lines there is in a certain element. See examples (j) and (k) in the <a href="#stages-examples">table below</a>.</p> <h3 class="heading settled" data-level="4.7" id="stages-examples"><span class="secno">4.7. </span><span class="content"> Examples</span><a class="self-link" href="#stages-examples"></a></h3> <table class="data non-normative"> <caption>Examples of CSS Value Computation</caption> <thead> <tr> <th> <th>Property <th>Winning declaration <th>Cascaded value <th>Specified value <th>Computed value <th>Used value <th>Actual value <tbody> <tr> <td>(a) <th><a class="property css" data-link-type="property" href="https://drafts.csswg.org/css-text-3/#propdef-text-align" id="ref-for-propdef-text-align">text-align</a> <td><code class="declaration">text-align: left</code> <td><span class="css">left</span> <td><span class="css">left</span> <td><span class="css">left</span> <td><span class="css">left</span> <td><span class="css">left</span> <tr> <td>(b) <th><a class="property css" data-link-type="property" href="https://drafts.csswg.org/css-backgrounds-3/#propdef-border-top-width" id="ref-for-propdef-border-top-width">border-top-width</a>, <a class="property css" data-link-type="property" href="https://drafts.csswg.org/css-backgrounds-3/#propdef-border-right-width" id="ref-for-propdef-border-right-width">border-right-width</a>, <a class="property css" data-link-type="property" href="https://drafts.csswg.org/css-backgrounds-3/#propdef-border-bottom-width" id="ref-for-propdef-border-bottom-width">border-bottom-width</a>, <a class="property css" data-link-type="property" href="https://drafts.csswg.org/css-backgrounds-3/#propdef-border-left-width" id="ref-for-propdef-border-left-width">border-left-width</a> <td><code class="declaration">border-width: inherit</code> <td><span class="css">inherit</span> <td class="say"><span class="css">4.2px</span> <td><span class="css">4.2px</span> <td><span class="css">4.2px</span> <td><span class="css">4px</span> <tr> <td>(c) <th><a class="property css" data-link-type="property" href="https://drafts.csswg.org/css-sizing-3/#propdef-width" id="ref-for-propdef-width①">width</a> <td><small>(none)</small> <td><small>(none)</small> <td><span class="css">auto</span> <small>(initial value)</small> <td><span class="css">auto</span> <td><span class="css">120px</span> <td><span class="css">120px</span> <tr> <td>(d) <th><a class="property css" data-link-type="property" href="https://drafts.csswg.org/css-lists-3/#propdef-list-style-position" id="ref-for-propdef-list-style-position">list-style-position</a> <td><code class="declaration">list-style-position: inherit</code> <td><span class="css">inherit</span> <td class="say"><span class="css">inside</span> <td><span class="css">inside</span> <td><span class="css">inside</span> <td><span class="css">inside</span> <tr> <td>(e) <th><a class="property css" data-link-type="property" href="https://drafts.csswg.org/css-lists-3/#propdef-list-style-position" id="ref-for-propdef-list-style-position①">list-style-position</a> <td><code class="declaration">list-style-position: initial</code> <td><span class="css">initial</span> <td><span class="css">outside</span> <small>(initial value)</small> <td><span class="css">outside</span> <td><span class="css">outside</span> <td><span class="css">outside</span> <tr> <td>(f) <th><a class="property css" data-link-type="property" href="https://drafts.csswg.org/css-fonts-4/#propdef-font-size" id="ref-for-propdef-font-size②">font-size</a> <td><code class="declaration">font-size: 1.2em</code> <td><span class="css">1.2em</span> <td><span class="css">1.2em</span> <td class="say"><span class="css">14.1px</span> <td><span class="css">14.1px</span> <td><span class="css">14px</span> <tr> <td>(g) <th><a class="property css" data-link-type="property" href="https://drafts.csswg.org/css-sizing-3/#propdef-width" id="ref-for-propdef-width②">width</a> <td><code class="declaration">width: 80%</code> <td><span class="css">80%</span> <td><span class="css">80%</span> <td><span class="css">80%</span> <td class="say"><span class="css">354.2px</span> <td><span class="css">354px</span> <tr> <td>(h) <th><a class="property css" data-link-type="property" href="https://drafts.csswg.org/css-sizing-3/#propdef-width" id="ref-for-propdef-width③">width</a> <td><code class="declaration">width: auto</code> <td><span class="css">auto</span> <td><span class="css">auto</span> <td><span class="css">auto</span> <td class="say"><span class="css">134px</span> <td><span class="css">134px</span> <tr> <td>(i) <th><a class="property css" data-link-type="property" href="https://drafts.csswg.org/css-sizing-3/#propdef-height" id="ref-for-propdef-height">height</a> <td><code class="declaration">height: auto</code> <td><span class="css">auto</span> <td><span class="css">auto</span> <td><span class="css">auto</span> <td class="say"><span class="css">176px</span> <td><span class="css">176px</span> <tr> <td>(j) <th><a class="property css" data-link-type="property" href="https://drafts.csswg.org/css2/#propdef-page-break-after" id="ref-for-propdef-page-break-after①">page-break-after</a> <td><small>(none)</small> <td><small>(none)</small> <td><span class="css">auto</span> <small>(initial value)</small> <td><span class="css">auto</span> <td><span class="css">auto</span> <td><span class="css">auto</span> <tr> <td>(k) <th><a class="property css" data-link-type="property" href="https://drafts.csswg.org/css-break-3/#propdef-orphans" id="ref-for-propdef-orphans①">orphans</a> <td><code class="declaration">orphans: 3</code> <td><span class="css">3</span> <td><span class="css">3</span> <td><span class="css">3</span> <td><span class="css">3</span> <td><span class="css">3</span> </table> <h3 class="heading settled" data-level="4.8" id="fragments"><span class="secno">4.8. </span><span class="content"> Per-Fragment Value Processing</span><a class="self-link" href="#fragments"></a></h3> <p>Certain CSS features can interfere with value processing on a per-fragment basis. See for example <a href="https://drafts.csswg.org/css-pseudo-4/#first-line-inheritance"><cite>CSS Pseudo-Elements 4</cite> § 2.1.3 Inheritance and the ::first-line Pseudo-element</a> which alters inheritance for fragments within the <a class="css" data-link-type="maybe" href="https://drafts.csswg.org/css-pseudo-4/#selectordef-first-line" id="ref-for-selectordef-first-line">::first-line</a> pseudo-element. In such cases, where individual fragments are given different <a data-link-type="dfn" href="#specified-value" id="ref-for-specified-value①①">specified values</a>, any values that resolve based on the <a data-link-type="dfn" href="#computed-value" id="ref-for-computed-value①②">computed value</a> of other properties (such as <a class="css" data-link-type="maybe" href="https://drafts.csswg.org/css-color-4/#valdef-color-currentcolor" id="ref-for-valdef-color-currentcolor">currentcolor</a> or <a class="css" data-link-type="maybe" href="https://drafts.csswg.org/css-values-4/#em" id="ref-for-em①">em</a> units) are resolved per <a data-link-type="dfn" href="https://drafts.csswg.org/css-break-4/#box-fragment" id="ref-for-box-fragment">box fragment</a>. Subsequent value processing proceeds as normal in each fragment.</p> <p>APIs that assume a singular value per <a data-link-type="dfn" href="https://drafts.csswg.org/css-display-3/#box" id="ref-for-box">box</a> (rather than per <a data-link-type="dfn" href="https://drafts.csswg.org/css-break-4/#box-fragment" id="ref-for-box-fragment①">box fragment</a>) must ignore the effects of non-<a data-link-type="dfn" href="https://drafts.csswg.org/css-pseudo-4/#tree-abiding" id="ref-for-tree-abiding">tree-abiding</a> <a data-link-type="dfn" href="https://drafts.csswg.org/selectors-4/#pseudo-element" id="ref-for-pseudo-element②">pseudo-elements</a>. (For example, <a class="css" data-link-type="maybe" href="https://drafts.csswg.org/css-pseudo-4/#selectordef-first-line" id="ref-for-selectordef-first-line①">::first-line</a> styles have no effect on the value returned by <code class="idl"><a data-link-type="idl" href="https://drafts.csswg.org/cssom-1/#dom-window-getcomputedstyle" id="ref-for-dom-window-getcomputedstyle①">getComputedStyle()</a></code>.)</p> <div class="example" id="example-d0a2e292"> <a class="self-link" href="#example-d0a2e292"></a> For example, given the following markup: <pre class="highlight"><c- p><</c-><c- f>div</c-><c- p>><</c-><c- f>span</c-><c- p>></c->First line<c- p><</c-><c- f>br</c-> <c- p>/></c->Second line<c- p></</c-><c- f>span</c-><c- p>></</c-><c- f>div</c-><c- p>></c-> <c- p><</c-><c- f>div</c-><c- p>><</c-><c- f>span</c-><c- p>></c->First line<c- p></</c-><c- f>span</c-><c- p>></</c-><c- f>div</c-><c- p>></c-> <c- p><</c-><c- f>div</c-><c- p>></c->First line<c- p><</c-><c- f>br</c-><c- p>><</c-><c- f>span</c-><c- p>></c->Second line<c- p></</c-><c- f>span</c-><c- p>></</c-><c- f>div</c-><c- p>></c-> <c- p><</c-><c- f>style</c-><c- p>></c-> <c- f>div</c-> <c- p>{</c-> <c- k>color</c-><c- p>:</c-> <c- kc>blue</c-><c- p>;</c-> <c- p>}</c-> <c- f>div</c-><c- p>::</c-><c- nd>first-line</c-> <c- p>{</c-> <c- k>color</c-><c- p>:</c-> <c- kc>yellow</c-><c- p>;</c-> <c- p>}</c-> <c- f>span</c-> <c- p>{</c-> <c- k>border</c-><c- p>:</c-> <c- kc>thin</c-> <c- kc>solid</c-> <c- n>currentcolor</c-><c- p>;</c-> <c- p>}</c-> <c- p></</c-><c- f>style</c-><c- p>></c-> </pre> <p>In each <code><a data-link-type="element" href="https://html.spec.whatwg.org/multipage/grouping-content.html#the-div-element" id="ref-for-the-div-element">div</a></code>, the “First line” text is yellow and the “Second line” text is blue; the border for each fragment of the <code><a data-link-type="element" href="https://html.spec.whatwg.org/multipage/text-level-semantics.html#the-span-element" id="ref-for-the-span-element">span</a></code>s that wrap each line matches that color.</p> <p>However, <code class="idl"><a data-link-type="idl" href="https://drafts.csswg.org/cssom-1/#dom-window-getcomputedstyle" id="ref-for-dom-window-getcomputedstyle②">getComputedStyle()</a></code> on all three of the spans will return <code>"blue"</code> for <a class="property css" data-link-type="property" href="https://drafts.csswg.org/css-backgrounds-3/#propdef-border-color" id="ref-for-propdef-border-color">border-color</a>, because the effects of a <a class="css" data-link-type="maybe" href="https://drafts.csswg.org/css-pseudo-4/#selectordef-first-line" id="ref-for-selectordef-first-line②">::first-line</a> pseudo-element are ignored for APIs that aren’t fragment-aware.</p> </div> <h2 class="heading settled" data-level="5" id="filtering"><span class="secno">5. </span><span class="content"> Filtering</span><a class="self-link" href="#filtering"></a></h2> <p>In order to find the <a data-link-type="dfn" href="#declared-value" id="ref-for-declared-value⑤">declared values</a>, implementations must first identify all <a data-link-type="dfn" href="https://drafts.csswg.org/cssom-1/#cssstyledeclaration-declarations" id="ref-for-cssstyledeclaration-declarations⑥">declarations</a> that apply to each element. A declaration applies to an element if:</p> <ul> <li> It belongs to a style sheet that currently applies to this document. <li> It is not qualified by a conditional rule <a data-link-type="biblio" href="#biblio-css-conditional-3">[CSS-CONDITIONAL-3]</a> with a false condition. <li> It belongs to a style rule whose selector matches the element. <a data-link-type="biblio" href="#biblio-select">[SELECT]</a> (Taking <a href="https://www.w3.org/TR/selectors-4/#scoping">scoping</a> into account, if necessary.) <li> It is syntactically valid: the declaration’s property is a known property name, and the declaration’s value matches the syntax for that property. </ul> <p>The values of the <a data-link-type="dfn" href="https://drafts.csswg.org/cssom-1/#cssstyledeclaration-declarations" id="ref-for-cssstyledeclaration-declarations⑦">declarations</a> that apply form, for each property on each element, a list of <a data-link-type="dfn" href="#declared-value" id="ref-for-declared-value⑥">declared values</a>. The next section, the <a data-link-type="dfn" href="#cascade" id="ref-for-cascade②">cascade</a>, prioritizes these lists.</p> <h2 class="heading settled" data-level="6" id="cascading"><span class="secno">6. </span><span class="content"> Cascading</span><a class="self-link" href="#cascading"></a></h2> <p>The <dfn class="dfn-paneled" data-dfn-type="dfn" data-export id="cascade">cascade</dfn> takes an unordered list of <a data-link-type="dfn" href="#declared-value" id="ref-for-declared-value⑦">declared values</a> for a given property on a given element, sorts them by their <a data-link-type="dfn" href="https://drafts.csswg.org/css-syntax-3/#declaration" id="ref-for-declaration①">declaration’s</a> precedence as determined below, and outputs a single <a data-link-type="dfn" href="#cascaded-value" id="ref-for-cascaded-value⑧">cascaded value</a>.</p> <h3 class="heading settled" data-level="6.1" id="cascade-sort"><span class="secno">6.1. </span><span class="content"> Cascade Sorting Order</span><a class="self-link" href="#cascade-sort"></a></h3> <p>The cascade sorts <a data-link-type="dfn" href="https://drafts.csswg.org/cssom-1/#cssstyledeclaration-declarations" id="ref-for-cssstyledeclaration-declarations⑧">declarations</a> according to the following criteria, in descending order of precedence:</p> <dl> <dt id="cascade-origin"><a class="self-link" href="#cascade-origin"></a>Origin and Importance <dd> The <a data-link-type="dfn" href="#origin" id="ref-for-origin②">origin</a> of a <a data-link-type="dfn" href="https://drafts.csswg.org/css-syntax-3/#declaration" id="ref-for-declaration②">declaration</a> is based on where it comes from and its <a data-link-type="dfn" href="#important" id="ref-for-important">importance</a> is whether or not it is declared with <span class="css">!important</span> (see <a href="#importance">below</a>). The precedence of the various <span id="ref-for-origin③">origins</span> is, in descending order: <ol> <li>Transition declarations <a data-link-type="biblio" href="#biblio-css-transitions-1">[css-transitions-1]</a> <li><a data-link-type="dfn" href="#important" id="ref-for-important①">Important</a> <a data-link-type="dfn" href="#cascade-origin-ua" id="ref-for-cascade-origin-ua">user agent</a> declarations <li><a data-link-type="dfn" href="#important" id="ref-for-important②">Important</a> <a data-link-type="dfn" href="#cascade-origin-user" id="ref-for-cascade-origin-user">user</a> declarations <li><a data-link-type="dfn" href="#important" id="ref-for-important③">Important</a> <a data-link-type="dfn" href="#cascade-origin-author" id="ref-for-cascade-origin-author">author</a> declarations <li>Animation declarations <a data-link-type="biblio" href="#biblio-css-animations-1">[css-animations-1]</a> <li><a data-link-type="dfn" href="#normal" id="ref-for-normal">Normal</a> <a data-link-type="dfn" href="#cascade-origin-author" id="ref-for-cascade-origin-author①">author</a> declarations <li><a data-link-type="dfn" href="#normal" id="ref-for-normal①">Normal</a> <a data-link-type="dfn" href="#cascade-origin-user" id="ref-for-cascade-origin-user①">user</a> declarations <li><a data-link-type="dfn" href="#normal" id="ref-for-normal②">Normal</a> <a data-link-type="dfn" href="#cascade-origin-ua" id="ref-for-cascade-origin-ua①">user agent</a> declarations </ol> <p>Declarations from <a data-link-type="dfn" href="#origin" id="ref-for-origin④">origins</a> earlier in this list win over declarations from later <span id="ref-for-origin⑤">origins</span>.</p> <dt id="cascade-context"><a class="self-link" href="#cascade-context"></a>Context <dd> A document language can provide for blending <a data-link-type="dfn" href="https://drafts.csswg.org/cssom-1/#cssstyledeclaration-declarations" id="ref-for-cssstyledeclaration-declarations⑨">declarations</a> sourced from different <dfn class="dfn-paneled" data-dfn-type="dfn" data-local-lt="context" data-noexport id="encapsulation-contexts">encapsulation contexts</dfn>, such as the nested <a data-link-type="dfn" href="https://drafts.csswg.org/css-scoping-1/#tree-context" id="ref-for-tree-context">tree contexts</a> of <a data-link-type="dfn" href="https://dom.spec.whatwg.org/#concept-shadow-tree" id="ref-for-concept-shadow-tree">shadow trees</a> in the <a data-link-type="biblio" href="#biblio-dom">[DOM]</a>. <p>When comparing two declarations that are sourced from different <a data-link-type="dfn" href="#encapsulation-contexts" id="ref-for-encapsulation-contexts">encapsulation contexts</a>, then for <a data-link-type="dfn" href="#normal" id="ref-for-normal③">normal</a> rules the declaration from the outer context wins, and for <a data-link-type="dfn" href="#important" id="ref-for-important④">important</a> rules the declaration from the inner context wins. For this purpose, <a data-link-type="biblio" href="#biblio-dom">[DOM]</a> <a data-link-type="dfn" href="https://drafts.csswg.org/css-scoping-1/#tree-context" id="ref-for-tree-context①">tree contexts</a> are considered to be nested in <a data-link-type="dfn" href="https://dom.spec.whatwg.org/#concept-shadow-including-tree-order" id="ref-for-concept-shadow-including-tree-order">shadow-including tree order</a>.</p> <p class="note" role="note"><span>Note:</span> This effectively means that <a data-link-type="dfn" href="#normal" id="ref-for-normal④">normal</a> declarations belonging to an <a data-link-type="dfn" href="#encapsulation-contexts" id="ref-for-encapsulation-contexts①">encapsulation context</a> can set defaults that are easily overridden by the outer context, while <a data-link-type="dfn" href="#important" id="ref-for-important⑤">important</a> declarations belonging to an <span id="ref-for-encapsulation-contexts②">encapsulation context</span> can enforce requirements that cannot be overridden by the outer context.</p> <dt id="style-attr"><a class="self-link" href="#style-attr"></a>Element-Attached Styles <dd> Separately for <a data-link-type="dfn" href="#normal" id="ref-for-normal⑤">normal</a> and <a data-link-type="dfn" href="#important" id="ref-for-important⑥">important</a> <a data-link-type="dfn" href="https://drafts.csswg.org/cssom-1/#cssstyledeclaration-declarations" id="ref-for-cssstyledeclaration-declarations①⓪">declarations</a>, declarations that are attached directly to an element (such as the <a href="https://www.w3.org/TR/css-style-attr/#interpret">contents of a style attribute</a>) rather than indirectly mapped by means of a style rule selector take precedence over declarations the same <span id="ref-for-important⑦">importance</span> that are mapped via style rule. <p>See <a data-link-type="biblio" href="#biblio-cssstyleattr">[CSSSTYLEATTR]</a>.</p> <p class="note" role="note"><span>Note:</span> Non-CSS presentational hints (such as presentational markup) are handled separately, see <a href="#preshint">§ 6.5 Precedence of Non-CSS Presentational Hints</a>.</p> <dt id="cascade-layering"><a class="self-link" href="#cascade-layering"></a>Layers <dd> <a data-link-type="dfn" href="https://drafts.csswg.org/cssom-1/#cssstyledeclaration-declarations" id="ref-for-cssstyledeclaration-declarations①①">Declarations</a> within each <a data-link-type="dfn" href="#origin" id="ref-for-origin⑥">origin</a> and <a data-link-type="dfn" href="#encapsulation-contexts" id="ref-for-encapsulation-contexts③">context</a> can be explicitly assigned to a <a data-link-type="dfn" href="#cascade-layers" id="ref-for-cascade-layers③">cascade layer</a>. For the purpose of this step, any declaration not assigned to an explicit layer is added to an implicit final layer. <p>Cascade layers (like declarations) are sorted by order of appearance, see <a href="#layer-ordering">§ 6.4.3 Layer Ordering</a>. When comparing declarations that belong to different layers, then for <a data-link-type="dfn" href="#normal" id="ref-for-normal⑥">normal</a> rules the declaration whose <a data-link-type="dfn" href="#cascade-layers" id="ref-for-cascade-layers④">cascade layer</a> is latest in the layer order wins, and for <a data-link-type="dfn" href="#important" id="ref-for-important⑧">important</a> rules the declaration whose <span id="ref-for-cascade-layers⑤">cascade layer</span> is earliest wins.</p> <p class="note" role="note"><span>Note:</span> This follows the same logic used for precedence of <a data-link-type="dfn" href="#normal" id="ref-for-normal⑦">normal</a> and <a data-link-type="dfn" href="#important" id="ref-for-important⑨">important</a> <a data-link-type="dfn" href="#origin" id="ref-for-origin⑦">origins</a>, thus the <span class="css">!important</span> flag maintains the same “override” purpose in both settings.</p> <dt id="cascade-specificity"><a class="self-link" href="#cascade-specificity"></a>Specificity <dd> The <a href="https://www.w3.org/TR/selectors/#specificity">Selectors module</a> <a data-link-type="biblio" href="#biblio-select">[SELECT]</a> describes how to compute the specificity of a selector. Each <a data-link-type="dfn" href="https://drafts.csswg.org/css-syntax-3/#declaration" id="ref-for-declaration③">declaration</a> has the same specificity as the style rule it appears in. The declaration with the highest specificity wins. <dt id="cascade-order"><a class="self-link" href="#cascade-order"></a>Order of Appearance <dd> The last <a data-link-type="dfn" href="https://drafts.csswg.org/css-syntax-3/#declaration" id="ref-for-declaration④">declaration</a> in document order wins. For this purpose: <ul> <li>Style sheets are ordered in [[final CSS style sheets]] order. <li>Declarations from <a class="css" data-link-type="at-rule" href="#at-ruledef-import" id="ref-for-at-ruledef-import①②">imported style sheets</a> are ordered as if their style sheets were substituted in place of the <span class="css" id="ref-for-at-ruledef-import①③">@import</span> rule. <li>Declarations from style sheets independently linked by the originating document are treated as if they were concatenated in linking order, as determined by the host document language. <li>Declarations from style attributes are ordered according to the document order of the element the style attribute appears on, and are all placed after any style sheets. <a data-link-type="biblio" href="#biblio-cssstyleattr">[CSSSTYLEATTR]</a> </ul> </dl> <p>The <dfn class="dfn-paneled" data-dfn-type="dfn" data-export id="output-of-the-cascade">output of the cascade</dfn> is a (potentially empty) sorted list of <a data-link-type="dfn" href="#declared-value" id="ref-for-declared-value⑧">declared values</a> for each property on each element.</p> <h3 class="heading settled" data-level="6.2" id="cascading-origins"><span class="secno">6.2. </span><span class="content"> Cascading Origins</span><a class="self-link" href="#cascading-origins"></a></h3> <p>Each style rule has a <dfn class="dfn-paneled" data-dfn-type="dfn" data-export data-local-lt="origin" id="origin">cascade origin</dfn>, which determines where it enters the cascade. CSS defines three core <a data-link-type="dfn" href="#origin" id="ref-for-origin⑧">origins</a>:</p> <dl> <dt><dfn class="dfn-paneled" data-dfn-type="dfn" data-export data-lt="author origin|author style sheet|author-origin" id="cascade-origin-author">Author Origin</dfn> <dd> The author specifies style sheets for a source document according to the conventions of the document language. For instance, in HTML, style sheets may be included in the document or linked externally. <dt><dfn class="dfn-paneled" data-dfn-type="dfn" data-export data-lt="user origin|user style sheet|user-origin" id="cascade-origin-user">User Origin</dfn> <dd> The user may be able to specify style information for a particular document. For example, the user may specify a file that contains a style sheet or the user agent may provide an interface that generates a user style sheet (or behaves as if it did). <dt><dfn class="dfn-paneled" data-dfn-type="dfn" data-export data-lt="user-agent origin|UA origin|user-agent style sheet|UA style sheet|UA-origin" id="cascade-origin-ua">User-Agent Origin</dfn> <dd> Conforming user agents must apply a default style sheet (or behave as if they did). A user agent’s default style sheet should present the elements of the document language in ways that satisfy general presentation expectations for the document language (e.g., for visual browsers, the EM element in HTML is presented using an italic font). See e.g. the <a href="https://html.spec.whatwg.org/multipage/rendering.html#the-css-user-agent-style-sheet-and-presentational-hints">HTML user agent style sheet</a>. <a data-link-type="biblio" href="#biblio-html">[HTML]</a> </dl> <p>Extensions to CSS define the following additional <a data-link-type="dfn" href="#origin" id="ref-for-origin⑨">origins</a>:</p> <dl> <dt><dfn class="dfn-paneled" data-dfn-type="dfn" data-export id="cascade-origin-animation">Animation Origin</dfn> <dd> CSS Animations <a data-link-type="biblio" href="#biblio-css-animations-1">[css-animations-1]</a> generate “virtual” rules representing their effects when running. <dt><dfn data-dfn-type="dfn" data-export id="cascade-origin-transition">Transition Origin<a class="self-link" href="#cascade-origin-transition"></a></dfn> <dd> Like CSS Animations, CSS Transitions <a data-link-type="biblio" href="#biblio-css-transitions-1">[css-transitions-1]</a> generate “virtual” rules representing their effects when running. </dl> <h3 class="heading settled" data-level="6.3" id="importance"><span class="secno">6.3. </span><span class="content"> Important Declarations: the <span class="css">!important</span> annotation</span><a class="self-link" href="#importance"></a></h3> <p>CSS attempts to create a balance of power between author and user style sheets. By default, rules in an author’s style sheet override those in a user’s style sheet, which override those in the user-agent’s default style sheet. To balance this, a <a data-link-type="dfn" href="https://drafts.csswg.org/css-syntax-3/#declaration" id="ref-for-declaration⑤">declaration</a> can be marked <a data-link-type="dfn" href="#important" id="ref-for-important①⓪">important</a>, which increases its weight in the cascade and inverts the order of precedence.</p> <p>A <a data-link-type="dfn" href="https://drafts.csswg.org/css-syntax-3/#declaration" id="ref-for-declaration⑥">declaration</a> is <dfn class="dfn-paneled" data-dfn-type="dfn" data-export data-local-lt="importance" id="important">important</dfn> if it has a <span class="css">!important</span> annotation as defined by <a data-link-type="biblio" href="#biblio-css-syntax-3">[css-syntax-3]</a>, i.e. if the last two (non-whitespace, non-comment) tokens in its value are the delimiter token <span class="css">!</span> followed by the identifier token <span class="css">important</span>. All other declarations are <dfn class="dfn-paneled" data-dfn-type="dfn" data-noexport id="normal">normal</dfn> (non-<a data-link-type="dfn" href="#important" id="ref-for-important①①">important</a>).</p> <div class="example" id="example-813b5c64"> <a class="self-link" href="#example-813b5c64"></a> <pre class="lang-css highlight"><c- p>[</c->hidden<c- p>]</c-> <c- p>{</c-> <c- k>display</c-><c- p>:</c-> none !important<c- p>;</c-> <c- p>}</c-></pre> </div> <p>An <a data-link-type="dfn" href="#important" id="ref-for-important①②">important</a> declaration takes precedence over a <a data-link-type="dfn" href="#normal" id="ref-for-normal⑧">normal</a> declaration. Author and user style sheets may contain <span id="ref-for-important①③">important</span> declarations, with <a data-link-type="dfn" href="#cascade-origin-user" id="ref-for-cascade-origin-user②">user-origin</a> <span id="ref-for-important①④">important</span> declarations overriding <a data-link-type="dfn" href="#cascade-origin-author" id="ref-for-cascade-origin-author②">author-origin</a> <span id="ref-for-important①⑤">important</span> declarations. This CSS feature improves accessibility of documents by giving users with special requirements (large fonts, color combinations, etc.) control over presentation.</p> <p><a data-link-type="dfn" href="#important" id="ref-for-important①⑥">Important</a> declarations from all origins take precedence over animations. This allows authors to override animated values in important cases. (Animated values normally override all other rules.) <a data-link-type="biblio" href="#biblio-css-animations-1">[css-animations-1]</a></p> <p><a data-link-type="dfn" href="#cascade-origin-ua" id="ref-for-cascade-origin-ua②">User-agent style sheets</a> may also contain <a data-link-type="dfn" href="#important" id="ref-for-important①⑦">important</a> declarations. These override all <a data-link-type="dfn" href="#cascade-origin-author" id="ref-for-cascade-origin-author③">author</a> and <a data-link-type="dfn" href="#cascade-origin-user" id="ref-for-cascade-origin-user③">user</a> declarations.</p> <div class="example" id="example-b189d121"> <a class="self-link" href="#example-b189d121"></a> The first rule in the user’s style sheet in the following example contains an <span class="css">!important</span> declaration, which overrides the corresponding declaration in the author’s style sheet. The declaration in the second rule will also win due to being marked <span class="css">!important</span>. However, the third declaration in the user’s style sheet is not <span class="css">!important</span> and will therefore lose to the second rule in the author’s style sheet (which happens to set style on a <a data-link-type="dfn" href="#shorthand-property" id="ref-for-shorthand-property①①">shorthand</a> property). Also, the third author rule will lose to the second author rule since the second declaration is <span class="css">!important</span>. This shows that <span class="css">!important</span> declarations have a function also within author style sheets. <pre class="lang-css highlight"><c- c>/* From the user’s style sheet */</c-> p <c- p>{</c-> <c- k>text-indent</c-><c- p>:</c-> <c- m>1</c-><c- k>em</c-> !important <c- p>}</c-> p <c- p>{</c-> <c- k>font-style</c-><c- p>:</c-> italic !important <c- p>}</c-> p <c- p>{</c-> <c- k>font-size</c-><c- p>:</c-> <c- m>18</c-><c- k>pt</c-> <c- p>}</c-> <c- c>/* From the author’s style sheet */</c-> p <c- p>{</c-> <c- k>text-indent</c-><c- p>:</c-> <c- m>1.5</c-><c- k>em</c-> !important <c- p>}</c-> p <c- p>{</c-> <c- k>font</c-><c- p>:</c-> normal <c- m>12</c-><c- k>pt</c-> sans-serif !important <c- p>}</c-> p <c- p>{</c-> <c- k>font-size</c-><c- p>:</c-> <c- m>24</c-><c- k>pt</c-> <c- p>}</c-> </pre> <table class="data"> <thead> <tr> <th>Property <th>Winning value <tbody> <tr> <th><a class="property css" data-link-type="property" href="https://drafts.csswg.org/css-text-4/#propdef-text-indent" id="ref-for-propdef-text-indent">text-indent</a> <td><span class="css">1em</span> <tr> <th><a class="property css" data-link-type="property" href="https://drafts.csswg.org/css-fonts-4/#propdef-font-style" id="ref-for-propdef-font-style①">font-style</a> <td><a class="css" data-link-type="maybe" href="https://drafts.csswg.org/css-fonts-4/#valdef-font-style-italic" id="ref-for-valdef-font-style-italic">italic</a> <tr> <th><a class="property css" data-link-type="property" href="https://drafts.csswg.org/css-fonts-4/#propdef-font-size" id="ref-for-propdef-font-size③">font-size</a> <td><span class="css">12pt</span> <tr> <th><a class="property css" data-link-type="property" href="https://drafts.csswg.org/css-fonts-4/#propdef-font-family" id="ref-for-propdef-font-family①">font-family</a> <td><a class="css" data-link-type="maybe" href="https://drafts.csswg.org/css-fonts-4/#valdef-font-family-sans-serif" id="ref-for-valdef-font-family-sans-serif">sans-serif</a> </table> </div> <h3 class="heading settled" data-level="6.4" id="layering"><span class="secno">6.4. </span><span class="content"> Cascade Layers</span><a class="self-link" href="#layering"></a></h3> <div class="mdn-anno wrapped after"> <button class="mdn-anno-btn"><b class="all-engines-flag" title="This feature is in all current engines.">✔</b><span>MDN</span></button> <div class="feature"> <p><a href="https://developer.mozilla.org/en-US/docs/Web/CSS/@layer" title="The @layer CSS at-rule is used to declare a cascade layer and can also be used to define the order of precedence in case of multiple cascade layers.">@layer</a></p> <p class="all-engines-text">In all current engines.</p> <div class="support"> <span class="firefox yes"><span>Firefox</span><span>97+</span></span><span class="safari yes"><span>Safari</span><span>15.4+</span></span><span class="chrome yes"><span>Chrome</span><span>99+</span></span> <hr> <span class="opera no"><span>Opera</span><span>?</span></span><span class="edge_blink yes"><span>Edge</span><span>99+</span></span> <hr> <span class="edge no"><span>Edge (Legacy)</span><span>?</span></span><span class="ie no"><span>IE</span><span>None</span></span> <hr> <span class="firefox_android no"><span>Firefox for Android</span><span>?</span></span><span class="safari_ios no"><span>iOS Safari</span><span>?</span></span><span class="chrome_android no"><span>Chrome for Android</span><span>?</span></span><span class="webview_android no"><span>Android WebView</span><span>?</span></span><span class="samsunginternet_android no"><span>Samsung Internet</span><span>?</span></span><span class="opera_android no"><span>Opera Mobile</span><span>?</span></span> </div> </div> </div> <p>In the same way that <a data-link-type="dfn" href="#origin" id="ref-for-origin①⓪">cascade origins</a> provide a balance of power between user and author styles, <dfn class="dfn-paneled" data-dfn-type="dfn" data-export data-local-lt="layer" id="cascade-layers">cascade layers</dfn> provide a structured way to organize and balance concerns within a single origin. Rules within a single <a data-link-type="dfn" href="#cascade-layers" id="ref-for-cascade-layers⑥">cascade layer</a> cascade together, without interleaving with style rules outside the layer.</p> <p>Authors can create layers to represent element defaults, third-party libraries, themes, components, overrides, and other styling concerns—<wbr>and are able to re-order the cascade of layers in an explicit way, without altering selectors or specificity within each layer, or relying on order of appearance to resolve conflicts across layers.</p> <div class="example" id="example-1f8b89d6"> <a class="self-link" href="#example-1f8b89d6"></a> For example, the following generates an explicit <span class="css">reset</span> layer, with lower cascade precedence than any unlayered styles: <pre class="lang-css highlight">audio <c- p>{</c-> <c- c>/* specificity of 0,0,1 - implicit (final) layer */</c-> display: flex<c- p>;</c-> <c- p>}</c-> <c- n>@layer</c-> reset <c- p>{</c-> audio<c- p>[</c->controls<c- p>]</c-> <c- p>{</c-> <c- c>/* specificity of 0,1,1 - explicit "reset" layer */</c-> display: block<c- p>;</c-> <c- p>}</c-> <c- p>}</c-> </pre> <p>The unlayered declarations on the <code><a data-link-type="element" href="https://html.spec.whatwg.org/multipage/media.html#audio" id="ref-for-audio">audio</a></code> element take precedence over the explicitly layered declarations on <code>audio[controls]</code>—<wbr>even though the unlayered styles have a lower specificity, and come first in the order of appearance.</p> </div> <p>Name-defining <a data-link-type="dfn" href="https://drafts.csswg.org/css-syntax-3/#at-rule" id="ref-for-at-rule">at-rules</a> such as <a class="css" data-link-type="maybe" href="https://drafts.csswg.org/css-animations-1/#at-ruledef-keyframes" id="ref-for-at-ruledef-keyframes">@keyframes</a> or <a class="css" data-link-type="maybe" href="https://drafts.csswg.org/css-fonts-5/#at-font-face-rule" id="ref-for-at-font-face-rule">@font-face</a> that are defined inside <a data-link-type="dfn" href="#cascade-layers" id="ref-for-cascade-layers⑦">cascade layers</a> also use the layer order when resolving name collisions.</p> <div class="example" id="example-14540e6d"> <a class="self-link" href="#example-14540e6d"></a> For example, authors could override the animation from a framework, by providing keyframes with the same name in a higher-precedence layer: <pre class="lang-css highlight"><c- c>/* establish the layer order, so the "override" layer takes precedence */</c-> <c- n>@layer</c-> framework<c- p>,</c-> override<c- p>;</c-> <c- n>@layer</c-> override <c- p>{</c-> <c- n>@keyframes</c-> slide-left <c- p>{</c-> from <c- p>{</c-> <c- k>translate</c-><c- p>:</c-> <c- m>0</c-><c- p>;</c-> <c- p>}</c-> to <c- p>{</c-> <c- k>translate</c-><c- p>:</c-> <c- m>-100</c-><c- k>%</c-> <c- m>0</c-><c- p>;</c-> <c- p>}</c-> <c- p>}</c-> <c- p>}</c-> <c- n>@layer</c-> framework <c- p>{</c-> <c- n>@keyframes</c-> slide-left <c- p>{</c-> from <c- p>{</c-> <c- k>margin-left</c-><c- p>:</c-> <c- m>0</c-><c- p>;</c-> <c- p>}</c-> to <c- p>{</c-> <c- k>margin-left</c-><c- p>:</c-> <c- m>-100</c-><c- k>%</c-><c- p>;</c-> <c- p>}</c-> <c- p>}</c-> <c- p>}</c-> .sidebar <c- p>{</c-> <c- k>animation</c-><c- p>:</c-> slide-left <c- m>300</c-><c- k>ms</c-><c- p>;</c-> <c- p>}</c-> </pre> <p>In this case the <span class="css">override</span> layer has a higher cascade precedence than the <span class="css">framework</span> layer, so <code>slide-left</code> will animate using the <code>translate</code> property rather than <code>margin-left</code>.</p> </div> <h4 class="heading settled" data-level="6.4.1" id="layer-declaration"><span class="secno">6.4.1. </span><span class="content"> Declaring Cascade Layers</span><a class="self-link" href="#layer-declaration"></a></h4> <p>Cascade layers can be declared:</p> <ul> <li data-md> <p>using an <a class="css" data-link-type="maybe" href="#at-ruledef-import" id="ref-for-at-ruledef-import①④">@import</a> rule with the <span class="css">layer</span> keyword or <span class="css">layer()</span> function, assigning the contents of the imported file into that layer.</p> <li data-md> <p>using a <a href="#layer-block">@layer block at-rule</a>, assigning its child style rules into that layer.</p> <li data-md> <p>using a <a href="#layer-empty">@layer statement at-rule</a>, declaring a named layer without assigning any rules.</p> </ul> <p class="issue" id="issue-3d8c81e9"><a class="self-link" href="#issue-3d8c81e9"></a> Provide an attribute for assigning link or style elements to cascade layers? <a href="https://github.com/w3c/csswg-drafts/issues/5853">[Issue #w3c/csswg-drafts#5853]</a></p> <h4 class="heading settled" data-level="6.4.2" id="layer-names"><span class="secno">6.4.2. </span><span class="content"> Layer Naming and Nesting</span><a class="self-link" href="#layer-names"></a></h4> <p>A <a data-link-type="dfn" href="#cascade-layers" id="ref-for-cascade-layers⑧">cascade layer</a> has a <dfn class="dfn-paneled" data-dfn-type="dfn" data-noexport id="layer-name">layer name</dfn>, which is an ordered list representing each level of layer nesting, each segment of which can be named (as a <a data-link-type="dfn" href="https://drafts.csswg.org/css-values-4/#css-css-identifier" id="ref-for-css-css-identifier">CSS identifier</a>) or anonymous. (Thus, when a layer is nested inside of another layer, this concatenates their names.) One layer is nested in another when it is declared within the scope of another layer, e.g. an <a class="css" data-link-type="maybe" href="#at-ruledef-layer" id="ref-for-at-ruledef-layer②">@layer</a> rule inside another <span class="css" id="ref-for-at-ruledef-layer③">@layer</span>, a layered <a class="css" data-link-type="maybe" href="#at-ruledef-import" id="ref-for-at-ruledef-import①⑤">@import</a> inside a layered import, or an <span class="css" id="ref-for-at-ruledef-layer④">@layer</span> rule inside a layered import.</p> <p><a data-link-type="dfn" href="#layer-name" id="ref-for-layer-name">Layer names</a> represent the same <a data-link-type="dfn" href="#cascade-layers" id="ref-for-cascade-layers⑨">cascade layer</a> if they contain the same segments in the same order; however anonymous segments have unique identities for each occurrence. Note that nesting can cause multiple layers to share the same anonymous segment.</p> <div class="example" id="example-8b497e80"> <a class="self-link" href="#example-8b497e80"></a> Explicit layer identifiers provide a way to assign multiple style blocks to a single layer. In the following example, the contents of <code>headings.css</code> and <code>links.css</code> are cascaded within the same layer as the <code>audio[controls]</code> rule: <pre class="lang-css highlight"><c- n>@import</c-> <c- nf>url</c-><c- p>(</c-><c- s>headings.css</c-><c- p>)</c-> <c- nf>layer</c-><c- p>(</c->default<c- p>);</c-> <c- n>@import</c-> <c- nf>url</c-><c- p>(</c-><c- s>links.css</c-><c- p>)</c-> <c- nf>layer</c-><c- p>(</c->default<c- p>);</c-> <c- n>@layer</c-> default <c- p>{</c-> audio<c- p>[</c->controls<c- p>]</c-> <c- p>{</c-> <c- k>display</c-><c- p>:</c-> block<c- p>;</c-> <c- p>}</c-> <c- p>}</c-> </pre> </div> <div class="example" id="example-23b0f30e"> <a class="self-link" href="#example-23b0f30e"></a> In this example, the nested <span class="css">framework.base</span> layer is distinct from the top-level <span class="css">base</span> layer: <pre class="lang-css highlight"><c- n>@layer</c-> base <c- p>{</c-> p <c- p>{</c-> <c- k>max-width</c-><c- p>:</c-> <c- m>70</c-><c- k>ch</c-><c- p>;</c-> <c- p>}</c-> <c- p>}</c-> <c- n>@layer</c-> framework <c- p>{</c-> <c- n>@layer</c-> base <c- p>{</c-> p <c- p>{</c-> <c- k>margin-block</c-><c- p>:</c-> <c- m>0.75</c-><c- k>em</c-><c- p>;</c-> <c- p>}</c-> <c- p>}</c-> <c- n>@layer</c-> theme <c- p>{</c-> p <c- p>{</c-> <c- k>color</c-><c- p>:</c-> #222<c- p>;</c-> <c- p>}</c-> <c- p>}</c-> <c- p>}</c-> </pre> <p>The resulting layers can be represented as a tree:</p> <ol> <li data-md> <p><span class="css">base</span></p> <li data-md> <p><span class="css">framework</span></p> <ol> <li data-md> <p><span class="css">base</span></p> <li data-md> <p><span class="css">theme</span></p> </ol> </ol> <p>or as a flat list with nested identifiers:</p> <ol> <li data-md> <p><span class="css">base</span></p> <li data-md> <p><span class="css">framework.base</span></p> <li data-md> <p><span class="css">framework.theme</span></p> </ol> </div> <p>Syntactically, an explicit <a data-link-type="dfn" href="#layer-name" id="ref-for-layer-name①">layer name</a> is represented by the <a class="production css" data-link-type="type" href="#typedef-layer-name" id="ref-for-typedef-layer-name①"><layer-name></a> in <a class="css" data-link-type="maybe" href="#at-ruledef-layer" id="ref-for-at-ruledef-layer⑤">@layer</a> and <a class="css" data-link-type="maybe" href="#at-ruledef-import" id="ref-for-at-ruledef-import①⑥">@import</a> rules, which is a period-separated list of <a class="production css" data-link-type="type" href="https://drafts.csswg.org/css-values-4/#typedef-ident" id="ref-for-typedef-ident"><ident></a> tokens with no intervening white space:</p> <pre class="prod"><dfn class="dfn-paneled" data-dfn-type="type" data-export id="typedef-layer-name"><a class="production" data-link-type="type" href="#typedef-layer-name" id="ref-for-typedef-layer-name②"><layer-name></a></dfn> = <a class="production" data-link-type="type" href="https://drafts.csswg.org/css-values-4/#typedef-ident" id="ref-for-typedef-ident①"><ident></a> [ '.' <a class="production" data-link-type="type" href="https://drafts.csswg.org/css-values-4/#typedef-ident" id="ref-for-typedef-ident②"><ident></a> ]<a data-link-type="grammar" href="https://drafts.csswg.org/css-values-4/#mult-zero-plus" id="ref-for-mult-zero-plus">*</a> </pre> <p>The <a data-link-type="dfn" href="https://drafts.csswg.org/css-values-4/#css-wide-keywords" id="ref-for-css-wide-keywords①">CSS-wide keywords</a> are reserved for future use, and cause the rule to be invalid at parse time if used as an <a class="production css" data-link-type="type" href="https://drafts.csswg.org/css-values-4/#typedef-ident" id="ref-for-typedef-ident③"><ident></a> in the <a class="production css" data-link-type="type" href="#typedef-layer-name" id="ref-for-typedef-layer-name③"><layer-name></a>. When multiple identifiers are concatenated with a period, this is a shorthand representing those layers nested in order.</p> <div class="example" id="example-cd070ab3"> <a class="self-link" href="#example-cd070ab3"></a> <pre class="lang-css highlight"><c- n>@layer</c-> framework <c- p>{</c-> <c- n>@layer</c-> default <c- p>{</c-> p <c- p>{</c-> <c- k>margin-block</c-><c- p>:</c-> <c- m>0.75</c-><c- k>em</c-><c- p>;</c-> <c- p>}</c-> <c- p>}</c-> <c- n>@layer</c-> theme <c- p>{</c-> p <c- p>{</c-> <c- k>color</c-><c- p>:</c-> #222<c- p>;</c-> <c- p>}</c-> <c- p>}</c-> <c- p>}</c-> <c- n>@layer</c-> framework.theme <c- p>{</c-> <c- c>/* These styles will be added to the theme layer inside the framework layer */</c-> blockquote <c- p>{</c-> <c- k>color</c-><c- p>:</c-> rebeccapurple<c- p>;</c-> <c- p>}</c-> <c- p>}</c-> </pre> </div> <p class="note" role="note"><span>Note:</span> A nested layer cannot “escape” its parent layer to reference layers outside itself.</p> <h5 class="heading settled" data-level="6.4.2.1" id="unnamed-layers"><span class="secno">6.4.2.1. </span><span class="content"> Anonymous Layers</span><a class="self-link" href="#unnamed-layers"></a></h5> <p>When a <a class="css" data-link-type="maybe" href="#at-ruledef-layer" id="ref-for-at-ruledef-layer⑥">@layer</a> rule omits its <a class="production css" data-link-type="type" href="#typedef-layer-name" id="ref-for-typedef-layer-name④"><layer-name></a>, or an <a class="css" data-link-type="maybe" href="#at-ruledef-import" id="ref-for-at-ruledef-import①⑦">@import</a> rule uses the <span class="css">layer</span> keyword (which does not provide a <span class="production" id="ref-for-typedef-layer-name⑤"><layer-name></span>), its <a data-link-type="dfn" href="#layer-name" id="ref-for-layer-name②">layer name</a> gains a unique anonymous segment; it therefore cannot be referenced from the outside.</p> <div class="example" id="example-787042b6"> <a class="self-link" href="#example-787042b6"></a> Each occurrence of an anonymous layer declaration represents a unique cascade layer, thus: <ul> <li data-md> <p>Multiple unnamed layer rules place their styles into separate layers, as each occurrence is referencing a distinct anonymous layer name.</p> <pre class="lang-css highlight"><c- n>@layer</c-> <c- p>{</c-> <c- c>/* layer 1 */</c-> <c- p>}</c-> <c- n>@layer</c-> <c- p>{</c-> <c- c>/* layer 2 */</c-> <c- p>}</c-> </pre> <li data-md> <p>Within a single unnamed layer, child layers with the same name refer to the same cascade layer, because they share the same anonymous parent layer.</p> <pre class="lang-css highlight"><c- n>@layer</c-> <c- p>{</c-> <c- n>@layer</c-> foo <c- p>{</c-> <c- c>/* layer 1 */</c-> <c- p>}</c-> <c- n>@layer</c-> foo <c- p>{</c-> <c- c>/* also layer 1 */</c-> <c- p>}</c-> <c- p>}</c-> </pre> <li data-md> <p>Whereas in separate unnamed layers, child layers with the same name refer to different cascade layers, because they have distinct anonymous parent layers.</p> <pre class="lang-css highlight"><c- n>@layer</c-> <c- p>{</c-> <c- n>@layer</c-> foo <c- p>{</c-> <c- c>/* layer 1 */</c-> <c- p>}</c-> <c- p>}</c-> <c- n>@layer</c-> <c- p>{</c-> <c- n>@layer</c-> foo <c- p>{</c-> <c- c>/* layer 2 */</c-> <c- p>}</c-> <c- p>}</c-> </pre> </ul> </div> <div class="example" id="example-52455707"> <a class="self-link" href="#example-52455707"></a> A layer declared without a <a class="production css" data-link-type="type" href="#typedef-layer-name" id="ref-for-typedef-layer-name⑥"><layer-name></a> does not provide any external hook for re-arranging or adding styles. <p>While this can be a mere convenience for brevity, it can also be used by teams as a way to force an organizing convention (all code in that layer must be defined in the same place), or by libraries wanting to merge & hide a set of internal “private” layers that they don’t want exposed to author manipulation:</p> <pre class="lang-css highlight"><c- c>/* bootstrap-base.css */</c-> <c- c>/* unnamed wrapper layers around each sub-file */</c-> <c- n>@import</c-> <c- nf>url</c-><c- p>(</c-><c- s>base-forms.css</c-><c- p>)</c-> layer<c- p>;</c-> <c- n>@import</c-> <c- nf>url</c-><c- p>(</c-><c- s>base-links.css</c-><c- p>)</c-> layer<c- p>;</c-> <c- n>@import</c-> <c- nf>url</c-><c- p>(</c-><c- s>base-headings.css</c-><c- p>)</c-> layer<c- p>;</c-> </pre> <pre class="lang-css highlight"><c- c>/* bootstrap.css */</c-> <c- c>/* the internal names are hidden from access, subsumed in "base" */</c-> <c- n>@import</c-> <c- nf>url</c-><c- p>(</c-><c- s>bootstrap-base.css</c-><c- p>)</c-> <c- nf>layer</c-><c- p>(</c->base<c- p>);</c-> </pre> <pre class="lang-css highlight"><c- c>/* author.css */</c-> <c- c>/* author has access to bootstrap.base layer, but not into unnamed layers */</c-> <c- n>@import</c-> <c- nf>url</c-><c- p>(</c-><c- s>bootstrap.css</c-><c- p>)</c-> <c- nf>layer</c-><c- p>(</c->bootstrap<c- p>);</c-> <c- c>/* Adds additional styles to the bootstrap layer: */</c-> <c- n>@layer</c-> bootstrap <c- p>{</c->...<c- p>}</c-> </pre> </div> <h4 class="heading settled" data-level="6.4.3" id="layer-ordering"><span class="secno">6.4.3. </span><span class="content"> Layer Ordering</span><a class="self-link" href="#layer-ordering"></a></h4> <p>Cascade layers are sorted by the order in which they first are declared, with nested layers grouped within their parent layer. Unlayered rules are sorted later than any layered rules within the same parent layer (if any).</p> <div class="example" id="example-deeaea42"> <a class="self-link" href="#example-deeaea42"></a> Given the following layer rules: <pre class="lang-css highlight"><c- c>/* unlayered styles come last in the layer order */</c-> h1 <c- p>{</c-> <c- k>color</c-><c- p>:</c-> darkslateblue<c- p>;</c-> <c- p>}</c-> <c- n>@layer</c-> reset.type <c- p>{</c-> strong <c- p>{</c-> <c- k>font-weight</c-><c- p>:</c-> bold<c- p>;</c-> <c- p>}</c-> <c- p>}</c-> <c- n>@layer</c-> framework <c- p>{</c-> .title <c- p>{</c-> <c- k>font-weight</c-><c- p>:</c-> <c- m>100</c-><c- p>;</c-> <c- p>}</c-> <c- n>@layer</c-> theme <c- p>{</c-> h1<c- p>,</c-> h2 <c- p>{</c-> <c- k>color</c-><c- p>:</c-> maroon<c- p>;</c-> <c- p>}</c-> <c- p>}</c-> <c- p>}</c-> <c- n>@layer</c-> reset <c- p>{</c-> <c- p>[</c->hidden<c- p>]</c-> <c- p>{</c-> <c- k>display</c-><c- p>:</c-> none<c- p>;</c-> <c- p>}</c-> <c- p>}</c-> </pre> <p>The outer layers are sorted first, with any unlayered style rules added to an implicit outer layer which has higher precedence than (comes after) the explicit layers:</p> <ol> <li data-md> <p><span class="css">reset</span></p> <li data-md> <p><span class="css">framework</span></p> <li data-md> <p>(implicit outer layer)</p> </ol> <p>Within each layer, nested layers are sorted in appearance order, and style rules without further nesting are similarly added to an implicit sub-layer after the explicitly nested layers:</p> <ol> <li data-md> <p><span class="css">reset.type</span></p> <li data-md> <p><span class="css">reset</span> (implicit sub-layer)</p> <li data-md> <p><span class="css">framework.theme</span></p> <li data-md> <p><span class="css">framework</span> (implicit sub-layer)</p> <li data-md> <p>(implicit outer layer)</p> </ol> </div> <p>Layers that are defined inside of a <a data-link-type="dfn" href="https://drafts.csswg.org/css-conditional-3/#conditional-group-rule" id="ref-for-conditional-group-rule①">conditional group rule</a> do not contribute to the layer order unless the condition is true or unless the <span id="ref-for-conditional-group-rule②">conditional group rule</span> can evaluate differently for different elements in the document.</p> <p class="note" role="note"><span>Note:</span> Since the layer order is global to the document, any layers defined inside an element-sensitive <a data-link-type="dfn" href="https://drafts.csswg.org/css-conditional-3/#conditional-group-rule" id="ref-for-conditional-group-rule③">conditional group rule</a> need to be accommodated when establishing the global layer order, regardless of the rule’s condition. Conditions that are global to the document, however (such as <a class="css" data-link-type="maybe" href="https://drafts.csswg.org/css-conditional-3/#at-ruledef-media" id="ref-for-at-ruledef-media①">@media</a> and <a class="css" data-link-type="maybe" href="https://drafts.csswg.org/css-conditional-3/#at-ruledef-supports" id="ref-for-at-ruledef-supports①">@supports</a>) can accommodate such <a class="css" data-link-type="maybe" href="#at-ruledef-layer" id="ref-for-at-ruledef-layer⑦">@layer</a> rules conditionally.</p> <div class="example" id="example-87e2d331"> <a class="self-link" href="#example-87e2d331"></a> For example, the following layer order will depend on which media conditions match: <pre class="lang-css highlight"><c- n>@media</c-> <c- p>(</c->min-width: <c- m>30</c-><c- k>em</c-><c- p>)</c-> <c- p>{</c-> <c- n>@layer</c-> layout <c- p>{</c-> .title <c- p>{</c-> <c- k>font-size</c-><c- p>:</c-> x-large<c- p>;</c-> <c- p>}</c-> <c- p>}</c-> <c- p>}</c-> <c- n>@media</c-> <c- p>(</c->prefers-color-scheme: dark<c- p>)</c-> <c- p>{</c-> <c- n>@layer</c-> theme <c- p>{</c-> .title <c- p>{</c-> <c- k>color</c-><c- p>:</c-> white<c- p>;</c-> <c- p>}</c-> <c- p>}</c-> <c- p>}</c-> <c- n>@layer</c-> theme<c- p>,</c-> layout<c- p>;</c-> </pre> <p>If the first media-query matches based on viewport dimensions, then the <a class="css" data-link-type="maybe" href="https://drafts.csswg.org/css-contain-2/#valdef-contain-layout" id="ref-for-valdef-contain-layout">layout</a> layer will come first in the layer order. If the color-scheme preference query matches, or if neither condition is true, then <span class="css">theme</span> will come first in the layer order.</p> <p>Authors who want to avoid this behavior can establish an explicit ordering of layers in advance, and avoid defining new layers inside conditional rules.</p> </div> <p class="note" role="note"><span>Note:</span> <a data-link-type="dfn" href="#cascade-layers" id="ref-for-cascade-layers①⓪">Cascade layers</a> are scoped to their <a data-link-type="dfn" href="#origin" id="ref-for-origin①①">origin</a> and <a data-link-type="dfn" href="#encapsulation-contexts" id="ref-for-encapsulation-contexts④">context</a>, so the ordering of layers in the light DOM has no impact on the order of identically-named layers in the shadow DOM (and vice versa).</p> <p class="issue" id="issue-e29f5f96"><a class="self-link" href="#issue-e29f5f96"></a> Allow authors to explicitly place unlayered styles in the layer order <a href="https://github.com/w3c/csswg-drafts/issues/6323">[Issue #6323]</a></p> <h4 class="heading settled" data-level="6.4.4" id="at-layer"><span class="secno">6.4.4. </span><span class="content"> Declaring Layers Inline: the <a class="css" data-link-type="maybe" href="#at-ruledef-layer" id="ref-for-at-ruledef-layer⑧">@layer</a> rule</span><a class="self-link" href="#at-layer"></a></h4> <p>The <dfn class="dfn-paneled css" data-dfn-type="at-rule" data-export id="at-ruledef-layer">@layer</dfn> rule declares a <a data-link-type="dfn" href="#cascade-layers" id="ref-for-cascade-layers①①">cascade layer</a>, with the option to assign style rules.</p> <h5 class="heading settled" data-level="6.4.4.1" id="layer-block"><span class="secno">6.4.4.1. </span><span class="content"> Assigning Styles Inline: the <a class="css" data-link-type="maybe" href="#at-ruledef-layer" id="ref-for-at-ruledef-layer⑨">@layer</a> block at-rule</span><a class="self-link" href="#layer-block"></a></h5> <p>The <a class="css" data-link-type="maybe" href="#at-ruledef-layer" id="ref-for-at-ruledef-layer①⓪">@layer</a> <a data-link-type="dfn" href="https://drafts.csswg.org/css-syntax-3/#block-at-rule" id="ref-for-block-at-rule">block at-rule</a> assigns its child style rules to a particular named <a data-link-type="dfn" href="#cascade-layers" id="ref-for-cascade-layers①②">cascade layer</a>. This block layer-assignment syntax is:</p> <pre class="prod">@layer <a class="production" data-link-type="type" href="#typedef-layer-name" id="ref-for-typedef-layer-name⑦"><layer-name></a><a data-link-type="grammar" href="https://drafts.csswg.org/css-values-4/#mult-opt" id="ref-for-mult-opt③">?</a> { <a class="production" data-link-type="type" href="https://drafts.csswg.org/css-syntax-3/#typedef-stylesheet" id="ref-for-typedef-stylesheet"><stylesheet></a> } </pre> <p>Such <a class="css" data-link-type="maybe" href="#at-ruledef-layer" id="ref-for-at-ruledef-layer①①">@layer</a> block rules have the same restrictions and processing as a <a data-link-type="dfn" href="https://drafts.csswg.org/css-conditional-3/#conditional-group-rule" id="ref-for-conditional-group-rule④">conditional group rule</a> <a data-link-type="biblio" href="#biblio-css-conditional-3">[CSS-CONDITIONAL-3]</a> with a true condition.</p> <div class="example" id="example-149ef997"> <a class="self-link" href="#example-149ef997"></a> For example, <a class="css" data-link-type="maybe" href="#at-ruledef-layer" id="ref-for-at-ruledef-layer①②">@layer</a> and <a class="css" data-link-type="maybe" href="https://drafts.csswg.org/css-conditional-3/#at-ruledef-media" id="ref-for-at-ruledef-media②">@media</a> can be mixed: <pre class="lang-css highlight"><c- n>@layer</c-> framework <c- p>{</c-> h1<c- p>,</c-> h2 <c- p>{</c-> <c- k>color</c-><c- p>:</c-> maroon<c- p>;</c-> <c- k>background</c-><c- p>:</c-> white<c- p>;}</c-> <c- n>@media</c-> <c- p>(</c->prefers-color-scheme: dark<c- p>)</c-> <c- p>{</c-> h1<c- p>,</c-> h2 <c- p>{</c-> <c- k>color</c-><c- p>:</c-> red<c- p>;</c-> <c- k>background</c-><c- p>:</c-> black<c- p>;</c-> <c- p>}</c-> <c- p>}</c-> <c- p>}</c-> </pre> </div> <p class="note" role="note"><span>Note:</span> <a class="css" data-link-type="maybe" href="#at-ruledef-layer" id="ref-for-at-ruledef-layer①③">@layer</a> <a data-link-type="dfn" href="https://drafts.csswg.org/css-syntax-3/#block-at-rule" id="ref-for-block-at-rule①">block at-rules</a> cannot be interleaved with <a class="css" data-link-type="maybe" href="#at-ruledef-import" id="ref-for-at-ruledef-import①⑧">@import</a> rules.</p> <h5 class="heading settled" data-level="6.4.4.2" id="layer-empty"><span class="secno">6.4.4.2. </span><span class="content"> Declaring Without Styles: the <a class="css" data-link-type="maybe" href="#at-ruledef-layer" id="ref-for-at-ruledef-layer①④">@layer</a> statement at-rule</span><a class="self-link" href="#layer-empty"></a></h5> <p>The <a class="css" data-link-type="maybe" href="#at-ruledef-layer" id="ref-for-at-ruledef-layer①⑤">@layer</a> rule can also be used to define new layers without assigning any style rules, by providing only the <a data-link-type="dfn" href="#layer-name" id="ref-for-layer-name③">layer name</a>:</p> <pre class="prod">@layer <a class="production" data-link-type="type" href="#typedef-layer-name" id="ref-for-typedef-layer-name⑧"><layer-name></a><a data-link-type="grammar" href="https://drafts.csswg.org/css-values-4/#mult-comma" id="ref-for-mult-comma">#</a>; </pre> <p>Such empty <a class="css" data-link-type="maybe" href="#at-ruledef-layer" id="ref-for-at-ruledef-layer①⑥">@layer</a> rules are allowed before <a class="css" data-link-type="maybe" href="#at-ruledef-import" id="ref-for-at-ruledef-import①⑨">@import</a> and <span class="css">@namespace</span> rules (after the <a class="css" data-link-type="maybe" href="https://drafts.csswg.org/css-syntax-3/#at-ruledef-charset" id="ref-for-at-ruledef-charset①">@charset</a> rule, if any) as well as everywhere <span class="css" id="ref-for-at-ruledef-layer①⑦">@layer</span> <a data-link-type="dfn" href="https://drafts.csswg.org/css-syntax-3/#block-at-rule" id="ref-for-block-at-rule②">block at-rules</a> are allowed.</p> <p class="note" role="note"><span>Note:</span> No <a class="css" data-link-type="maybe" href="#at-ruledef-layer" id="ref-for-at-ruledef-layer①⑧">@layer</a> rules are allowed between <a class="css" data-link-type="maybe" href="#at-ruledef-import" id="ref-for-at-ruledef-import②⓪">@import</a> and <span class="css">@namespace</span> rules. Any <span class="css" id="ref-for-at-ruledef-layer①⑨">@layer</span> rule that comes after an <span class="css" id="ref-for-at-ruledef-import②①">@import</span> or <span class="css">@namespace</span> rule will cause any subsequent <span class="css" id="ref-for-at-ruledef-import②②">@import</span> or <span class="css">@namespace</span> rules to be ignored.</p> <p>Unlike the <a href="#layer-block">block syntax</a>, multiple comma-separated layer names can be provided in this syntax, declaring each of the layers in the order specified.</p> <p class="note" role="note"><span>Note:</span> Since layer ordering is defined by first occurrence of the layer name (see <a href="#layer-ordering">§ 6.4.3 Layer Ordering</a>), this rule allows a page to declare the order of its layers up front, so that their order is apparent without having to read the entire style sheet. It also allows inline layers to be interleaved with imported layers, which is not possible with the <a href="#layer-block">block syntax</a>.</p> <div class="example" id="example-aa4a55a5"> <a class="self-link" href="#example-aa4a55a5"></a> The statement syntax allows establishing a layer order in advance, regardless of the order in which style rules are added to each layer. It can be helpful to establish that layer order in advance, before any <a class="css" data-link-type="maybe" href="#at-ruledef-import" id="ref-for-at-ruledef-import②③">@import</a> rules. In this example, the imported <code>theme.css</code> style rules will override any rules added in the later <span class="css">default</span> block since the order of layers has already been established: <pre class="lang-css highlight"><c- n>@layer</c-> default<c- p>,</c-> theme<c- p>,</c-> components<c- p>;</c-> <c- n>@import</c-> <c- nf>url</c-><c- p>(</c-><c- s>theme.css</c-><c- p>)</c-> <c- nf>layer</c-><c- p>(</c->theme<c- p>);</c-> <c- n>@layer</c-> default <c- p>{</c-> audio<c- p>[</c->controls<c- p>]</c-> <c- p>{</c-> <c- k>display</c-><c- p>:</c-> block<c- p>;</c-> <c- p>}</c-> <c- p>}</c-> </pre> <p>It’s also possible to have <a class="css" data-link-type="maybe" href="#at-ruledef-import" id="ref-for-at-ruledef-import②④">@import</a> rules help establish the order, by placing them between <a class="css" data-link-type="maybe" href="#at-ruledef-layer" id="ref-for-at-ruledef-layer②⓪">@layer</a> rules. This example will have the same result:</p> <pre class="lang-css highlight"><c- n>@layer</c-> default<c- p>;</c-> <c- n>@import</c-> <c- nf>url</c-><c- p>(</c-><c- s>theme.css</c-><c- p>)</c-> <c- nf>layer</c-><c- p>(</c->theme<c- p>);</c-> <c- n>@layer</c-> components<c- p>;</c-> <c- n>@layer</c-> default <c- p>{</c-> audio<c- p>[</c->controls<c- p>]</c-> <c- p>{</c-> <c- k>display</c-><c- p>:</c-> block<c- p>;</c-> <c- p>}</c-> <c- p>}</c-> </pre> <p>However, <a class="css" data-link-type="maybe" href="#at-ruledef-import" id="ref-for-at-ruledef-import②⑤">@import</a> and <span class="css">@namespace</span> rules must be consecutive, without any intervening rules. The following is invalid:</p> <pre class="lang-css highlight"><c- n>@import</c-> <c- nf>url</c-><c- p>(</c-><c- s>default.css</c-><c- p>)</c-> <c- nf>layer</c-><c- p>(</c->default<c- p>);</c-> <c- n>@layer</c-> theme<c- p>;</c-> <c- n>@import</c-> <c- nf>url</c-><c- p>(</c-><c- s>components.css</c-><c- p>)</c-> <c- nf>layer</c-><c- p>(</c->components<c- p>);</c-> <c- n>@layer</c-> theme <c- p>{</c-> audio<c- p>[</c->controls<c- p>]</c-> <c- p>{</c-> <c- k>display</c-><c- p>:</c-> block<c- p>;</c-> <c- p>}</c-> <c- p>}</c-> </pre> </div> <h3 class="heading settled" data-level="6.5" id="preshint"><span class="secno">6.5. </span><span class="content"> Precedence of Non-CSS Presentational Hints</span><a class="self-link" href="#preshint"></a></h3> <p>The UA may choose to honor presentational hints in a source document’s markup, for example the <code>bgcolor</code> attribute or <code><a data-link-type="element" href="https://html.spec.whatwg.org/multipage/text-level-semantics.html#the-s-element" id="ref-for-the-s-element">s</a></code> element in <a data-link-type="biblio" href="#biblio-html">[HTML]</a>. All document language-based styling must be translated to corresponding CSS rules and enter the cascade as rules in either the <a data-link-type="dfn" href="#cascade-origin-ua" id="ref-for-cascade-origin-ua③">UA-origin</a> or a special-purpose <dfn class="dfn-paneled" data-dfn-type="dfn" data-noexport id="author-presentational-hint-origin">author presentational hint origin</dfn> between the regular <a data-link-type="dfn" href="#cascade-origin-user" id="ref-for-cascade-origin-user④">user origin</a> and the <a data-link-type="dfn" href="#cascade-origin-author" id="ref-for-cascade-origin-author④">author origin</a>. For the purpose of <a data-link-type="dfn" href="#cascade" id="ref-for-cascade③">cascading</a> this <a data-link-type="dfn" href="#author-presentational-hint-origin" id="ref-for-author-presentational-hint-origin">author presentational hint origin</a> is treated as an independent <a data-link-type="dfn" href="#origin" id="ref-for-origin①②">origin</a>; however for the purpose of the <a class="css" data-link-type="maybe" href="#valdef-all-revert" id="ref-for-valdef-all-revert">revert</a> keyword (but not for the <a class="css" data-link-type="maybe" href="#valdef-all-revert-layer" id="ref-for-valdef-all-revert-layer①">revert-layer</a> keyword) it is considered part of the <span id="ref-for-cascade-origin-author⑤">author origin</span>.</p> <p>A document language may define whether such a presentational hint enters the <a data-link-type="dfn" href="#cascade" id="ref-for-cascade④">cascade</a> as <a data-link-type="dfn" href="#cascade-origin-ua" id="ref-for-cascade-origin-ua④">UA-origin</a> or <a data-link-type="dfn" href="#cascade-origin-author" id="ref-for-cascade-origin-author⑥">author-origin</a>; if so, the UA must behave accordingly. For example, <a data-link-type="biblio" href="#biblio-svg11">[SVG11]</a> maps its presentation attributes into the <span id="ref-for-cascade-origin-author⑦">author origin</span>.</p> <p class="note" role="note"><span>Note:</span> Presentational hints entering the <a data-link-type="dfn" href="#cascade" id="ref-for-cascade⑤">cascade</a> as <a data-link-type="dfn" href="#cascade-origin-ua" id="ref-for-cascade-origin-ua⑤">UA-origin</a> rules can be overridden by <a data-link-type="dfn" href="#cascade-origin-author" id="ref-for-cascade-origin-author⑧">author-origin</a> or <a data-link-type="dfn" href="#cascade-origin-user" id="ref-for-cascade-origin-user⑤">user-origin</a> styles. Presentational hints entering the cascade as <a data-link-type="dfn" href="#author-presentational-hint-origin" id="ref-for-author-presentational-hint-origin①">author presentational hint origin</a> rules can be overridden by <span id="ref-for-cascade-origin-author⑨">author-origin</span> styles, but not by non-<a data-link-type="dfn" href="#important" id="ref-for-important①⑧">important</a> <span id="ref-for-cascade-origin-user⑥">user-origin</span> styles. Host languages should choose the appropriate origin for presentational hints with these considerations in mind.</p> <h2 class="heading settled" data-level="7" id="defaulting"><span class="secno">7. </span><span class="content"> Defaulting</span><a class="self-link" href="#defaulting"></a></h2> <p>When the <a data-link-type="dfn" href="#cascade" id="ref-for-cascade⑥">cascade</a> does not result in a value, the <a data-link-type="dfn" href="#specified-value" id="ref-for-specified-value①②">specified value</a> must be found some other way. <a data-link-type="dfn" href="#inherited-property" id="ref-for-inherited-property">Inherited properties</a> draw their defaults from their parent element through <a data-link-type="dfn" href="#inheritance" id="ref-for-inheritance③">inheritance</a>; all other properties take their <a data-link-type="dfn" href="#initial-value" id="ref-for-initial-value②">initial value</a>. Authors can explicitly request inheritance or initialization via the <a class="css" data-link-type="maybe" href="#valdef-all-inherit" id="ref-for-valdef-all-inherit">inherit</a> and <a class="css" data-link-type="maybe" href="#valdef-all-initial" id="ref-for-valdef-all-initial">initial</a> keywords.</p> <h3 class="heading settled" data-level="7.1" id="initial-values"><span class="secno">7.1. </span><span class="content"> Initial Values</span><a class="self-link" href="#initial-values"></a></h3> <p>Each property has an <dfn class="dfn-paneled" data-dfn-type="dfn" data-export id="initial-value">initial value</dfn>, defined in the property’s definition table. If the property is not an <a data-link-type="dfn" href="#inherited-property" id="ref-for-inherited-property①">inherited property</a>, and the <a data-link-type="dfn" href="#cascade" id="ref-for-cascade⑦">cascade</a> does not result in a value, then the <a data-link-type="dfn" href="#specified-value" id="ref-for-specified-value①③">specified value</a> of the property is its <a data-link-type="dfn" href="#initial-value" id="ref-for-initial-value③">initial value</a>.</p> <h3 class="heading settled" data-level="7.2" id="inheriting"><span class="secno">7.2. </span><span class="content"> Inheritance</span><a class="self-link" href="#inheriting"></a></h3> <p><dfn class="dfn-paneled" data-dfn-type="dfn" data-export data-lt="inheritance|inherit" id="inheritance">Inheritance</dfn> propagates property values from parent elements to their children. The <dfn class="dfn-paneled" data-dfn-type="dfn" data-export id="inherited-value">inherited value</dfn> of a property on an element is the <a data-link-type="dfn" href="#computed-value" id="ref-for-computed-value①③">computed value</a> of the property on the element’s parent element. For the root element, which has no parent element, the <a data-link-type="dfn" href="#inherited-value" id="ref-for-inherited-value">inherited value</a> is the <a data-link-type="dfn" href="#initial-value" id="ref-for-initial-value④">initial value</a> of the property.</p> <p>For a <a data-link-type="biblio" href="#biblio-dom">[DOM]</a> tree with shadows, inheritance operates on the <a data-link-type="dfn" href="https://drafts.csswg.org/css-scoping-1/#flat-tree" id="ref-for-flat-tree②">flattened element tree</a>. <span class="note">This means that slotted elements inherit from the <code><a data-link-type="element" href="https://html.spec.whatwg.org/multipage/scripting.html#the-slot-element" id="ref-for-the-slot-element">slot</a></code> they’re assigned to, rather than directly from their <a data-link-type="dfn" href="https://dom.spec.whatwg.org/#concept-light-tree" id="ref-for-concept-light-tree">light tree</a> parent.</span> <a data-link-type="dfn" href="https://drafts.csswg.org/selectors-4/#pseudo-element" id="ref-for-pseudo-element③">Pseudo-elements</a> inherit according to the fictional tag sequence described for each <span id="ref-for-pseudo-element④">pseudo-element</span>. <a data-link-type="biblio" href="#biblio-css-pseudo-4">[CSS-PSEUDO-4]</a></p> <p>Some properties are <dfn class="dfn-paneled" data-dfn-type="dfn" data-export data-lt="inherited property" id="inherited-property">inherited properties</dfn>, as defined in their property definition table. This means that, unless the <a data-link-type="dfn" href="#cascade" id="ref-for-cascade⑧">cascade</a> results in a value, the value will be determined by <a data-link-type="dfn" href="#inheritance" id="ref-for-inheritance④">inheritance</a>.</p> <p>A property can also be explicitly inherited. See the <a class="css" data-link-type="maybe" href="#valdef-all-inherit" id="ref-for-valdef-all-inherit①">inherit</a> keyword.</p> <p class="note" role="note"><span>Note:</span> Inheritance follows the document tree and is not intercepted by <a href="https://www.w3.org/TR/CSS2/visuren.html#box-gen">anonymous boxes</a>, or otherwise affected by manipulations of the box tree.</p> <h3 class="heading settled" data-level="7.3" id="defaulting-keywords"><span class="secno">7.3. </span><span class="content"> Explicit Defaulting</span><a class="self-link" href="#defaulting-keywords"></a></h3> <p>Several CSS-wide property values are defined below; declaring a property to have these values explicitly specifies a particular defaulting behavior. As specified in <a href="https://www.w3.org/TR/css-values/#common-keywords">CSS Values and Units</a> <a data-link-type="biblio" href="#biblio-css-values-3">[css-values-3]</a>, all CSS properties can accept these values.</p> <p>The keywords <a class="css" data-link-type="maybe" href="#valdef-all-revert" id="ref-for-valdef-all-revert①">revert</a> and <a class="css" data-link-type="maybe" href="#valdef-all-revert-layer" id="ref-for-valdef-all-revert-layer②">revert-layer</a> are <dfn data-dfn-type="dfn" data-export data-lt="cascade-dependent keyword" id="cascade-dependent-keyword">cascade-dependent keywords<a class="self-link" href="#cascade-dependent-keyword"></a></dfn>; some contexts may restrict their use while allowing the other <a data-link-type="dfn" href="https://drafts.csswg.org/css-values-4/#css-wide-keywords" id="ref-for-css-wide-keywords②">CSS-wide keywords</a>.</p> <h4 class="heading settled" data-level="7.3.1" id="initial"><span class="secno">7.3.1. </span><span class="content"> Resetting a Property: the <a class="css" data-link-type="maybe" href="#valdef-all-initial" id="ref-for-valdef-all-initial①">initial</a> keyword</span><a class="self-link" href="#initial"></a></h4> <p>If the <a data-link-type="dfn" href="#cascaded-value" id="ref-for-cascaded-value⑨">cascaded value</a> of a property is the <dfn class="caniuse-paneled dfn-paneled css" data-dfn-for="all" data-dfn-type="value" data-export id="valdef-all-initial">initial</dfn> keyword, the property’s <a data-link-type="dfn" href="#specified-value" id="ref-for-specified-value①④">specified value</a> is its <a data-link-type="dfn" href="#initial-value" id="ref-for-initial-value⑤">initial value</a>.</p> <h4 class="heading settled" data-level="7.3.2" id="inherit"><span class="secno">7.3.2. </span><span class="content"> Explicit Inheritance: the <a class="css" data-link-type="maybe" href="#valdef-all-inherit" id="ref-for-valdef-all-inherit②">inherit</a> keyword</span><a class="self-link" href="#inherit"></a></h4> <p>If the <a data-link-type="dfn" href="#cascaded-value" id="ref-for-cascaded-value①⓪">cascaded value</a> of a property is the <dfn class="dfn-paneled css" data-dfn-for="all" data-dfn-type="value" data-export id="valdef-all-inherit">inherit</dfn> keyword, the property’s <a data-link-type="dfn" href="#specified-value" id="ref-for-specified-value①⑤">specified</a> and <a data-link-type="dfn" href="#computed-value" id="ref-for-computed-value①④">computed values</a> are the <a data-link-type="dfn" href="#inherited-value" id="ref-for-inherited-value①">inherited value</a>.</p> <h4 class="heading settled" data-level="7.3.3" id="inherit-initial"><span class="secno">7.3.3. </span><span class="content"> Erasing All Declarations: the <a class="css" data-link-type="maybe" href="#valdef-all-unset" id="ref-for-valdef-all-unset">unset</a> keyword</span><a class="self-link" href="#inherit-initial"></a></h4> <p>If the <a data-link-type="dfn" href="#cascaded-value" id="ref-for-cascaded-value①①">cascaded value</a> of a property is the <dfn class="caniuse-paneled dfn-paneled css" data-dfn-for="all" data-dfn-type="value" data-export id="valdef-all-unset">unset</dfn> keyword, then if it is an inherited property, this is treated as <a class="css" data-link-type="maybe" href="#valdef-all-inherit" id="ref-for-valdef-all-inherit③">inherit</a>, and if it is not, this is treated as <a class="css" data-link-type="maybe" href="#valdef-all-initial" id="ref-for-valdef-all-initial②">initial</a>. This keyword effectively erases all <a data-link-type="dfn" href="#declared-value" id="ref-for-declared-value⑨">declared values</a> occurring earlier in the <a data-link-type="dfn" href="#cascade" id="ref-for-cascade⑨">cascade</a>, correctly inheriting or not as appropriate for the property (or all longhands of a <a data-link-type="dfn" href="#shorthand-property" id="ref-for-shorthand-property①②">shorthand</a>).</p> <h4 class="heading settled" data-level="7.3.4" id="default"><span class="secno">7.3.4. </span><span class="content"> Rolling Back Cascade Origins: the <a class="css" data-link-type="maybe" href="#valdef-all-revert" id="ref-for-valdef-all-revert②">revert</a> keyword</span><a class="self-link" href="#default"></a></h4> <p>If the <a data-link-type="dfn" href="#cascaded-value" id="ref-for-cascaded-value①②">cascaded value</a> of a property is the <dfn class="caniuse-paneled dfn-paneled css" data-dfn-for="all" data-dfn-type="value" data-export id="valdef-all-revert">revert</dfn> keyword, the behavior depends on the <a data-link-type="dfn" href="#origin" id="ref-for-origin①③">cascade origin</a> to which the <a data-link-type="dfn" href="https://drafts.csswg.org/css-syntax-3/#declaration" id="ref-for-declaration⑦">declaration</a> belongs:</p> <dl> <dt><a data-link-type="dfn" href="#cascade-origin-ua" id="ref-for-cascade-origin-ua⑥">user-agent origin</a> <dd> Equivalent to <a class="css" data-link-type="maybe" href="#valdef-all-unset" id="ref-for-valdef-all-unset①">unset</a>. <dt><a data-link-type="dfn" href="#cascade-origin-user" id="ref-for-cascade-origin-user⑦">user origin</a> <dd> Rolls back the <a data-link-type="dfn" href="#cascaded-value" id="ref-for-cascaded-value①③">cascaded value</a> to the user-agent level, so that the <a data-link-type="dfn" href="#specified-value" id="ref-for-specified-value①⑥">specified value</a> is calculated as if no <a data-link-type="dfn" href="#cascade-origin-author" id="ref-for-cascade-origin-author①⓪">author-origin</a> or <a data-link-type="dfn" href="#cascade-origin-user" id="ref-for-cascade-origin-user⑧">user-origin</a> rules were specified for this property on this element. <dt><a data-link-type="dfn" href="#cascade-origin-author" id="ref-for-cascade-origin-author①①">author origin</a> <dd> Rolls back the <a data-link-type="dfn" href="#cascaded-value" id="ref-for-cascaded-value①④">cascaded value</a> to the user level, so that the <a data-link-type="dfn" href="#specified-value" id="ref-for-specified-value①⑦">specified value</a> is calculated as if no <a data-link-type="dfn" href="#cascade-origin-author" id="ref-for-cascade-origin-author①②">author-origin</a> rules were specified for this property on this element. For the purpose of <a class="css" data-link-type="maybe" href="#valdef-all-revert" id="ref-for-valdef-all-revert③">revert</a>, this origin includes the Animation <a data-link-type="dfn" href="#origin" id="ref-for-origin①④">origin</a>. </dl> <p class="note" role="note"><span>Note:</span> Effectively the <a class="css" data-link-type="maybe" href="#valdef-all-revert" id="ref-for-valdef-all-revert④">revert</a> keyword is substituted with the value from the earlier <a data-link-type="dfn" href="#origin" id="ref-for-origin①⑤">cascade origin</a>. Thus, reverting a <a data-link-type="dfn" href="#shorthand-property" id="ref-for-shorthand-property①③">shorthand property</a> reverts all its longhands; reverting any <a href="#aliasing">property alias</a> of a property reverts all of them; reverting one of the paired properties in a <a data-link-type="dfn" href="https://drafts.csswg.org/css-logical-1/#logical-property-group" id="ref-for-logical-property-group">logical property group</a> also reverts the other one; etc.</p> <h4 class="heading settled" data-level="7.3.5" id="revert-layer"><span class="secno">7.3.5. </span><span class="content"> Rolling Back Cascade Layers: the <a class="css" data-link-type="maybe" href="#valdef-all-revert-layer" id="ref-for-valdef-all-revert-layer③">revert-layer</a> keyword</span><a class="self-link" href="#revert-layer"></a></h4> <div class="mdn-anno wrapped after"> <button class="mdn-anno-btn"><b class="less-than-two-engines-flag" title="This feature is in less than two current engines.">⚠</b><span>MDN</span></button> <div class="feature"> <p><a href="https://developer.mozilla.org/en-US/docs/Web/CSS/revert-layer" title="The revert-layer CSS keyword rolls back the value of a property in a cascade layer to the value of the property in a CSS rule matching the element in a previous cascade layer. The value of the property with this keyword is recalculated as if no rules were specified on the target element in the current cascade layer.">revert-layer</a></p> <p class="less-than-two-engines-text">In only one current engine.</p> <div class="support"> <span class="firefox yes"><span>Firefox</span><span>97+</span></span><span class="safari no"><span>Safari</span><span>None</span></span><span class="chrome no"><span>Chrome</span><span>None</span></span> <hr> <span class="opera no"><span>Opera</span><span>?</span></span><span class="edge_blink no"><span>Edge</span><span>None</span></span> <hr> <span class="edge no"><span>Edge (Legacy)</span><span>?</span></span><span class="ie no"><span>IE</span><span>None</span></span> <hr> <span class="firefox_android no"><span>Firefox for Android</span><span>?</span></span><span class="safari_ios no"><span>iOS Safari</span><span>?</span></span><span class="chrome_android no"><span>Chrome for Android</span><span>?</span></span><span class="webview_android no"><span>Android WebView</span><span>?</span></span><span class="samsunginternet_android no"><span>Samsung Internet</span><span>?</span></span><span class="opera_android no"><span>Opera Mobile</span><span>?</span></span> </div> </div> </div> <p>The <dfn class="dfn-paneled css" data-dfn-for="all" data-dfn-type="value" data-export id="valdef-all-revert-layer">revert-layer</dfn> keyword rolls back the cascade similar to <a class="css" data-link-type="maybe" href="#valdef-all-revert" id="ref-for-valdef-all-revert⑤">revert</a>, except it works by <a data-link-type="dfn" href="#cascade-layers" id="ref-for-cascade-layers①③">cascade layer</a> rather than by <a data-link-type="dfn" href="#origin" id="ref-for-origin①⑥">cascade origin</a>. If the <a data-link-type="dfn" href="#cascaded-value" id="ref-for-cascaded-value①⑤">cascaded value</a> of a property is the <a class="css" data-link-type="maybe" href="#valdef-all-revert-layer" id="ref-for-valdef-all-revert-layer④">revert-layer</a> keyword, the <span id="ref-for-cascaded-value①⑥">cascaded value</span> is rolled back to the earlier <span id="ref-for-cascade-layers①④">layer</span>, so that the <a data-link-type="dfn" href="#specified-value" id="ref-for-specified-value①⑧">specified value</a> is calculated as if no rules were specified in the current <span id="ref-for-cascade-layers①⑤">cascade layer</span>—<wbr>or between its <a data-link-type="dfn" href="#normal" id="ref-for-normal⑨">normal</a> and <a data-link-type="dfn" href="#important" id="ref-for-important①⑨">important</a> levels in the <a data-link-type="dfn" href="#cascade" id="ref-for-cascade①⓪">cascade</a>—<wbr>for this property on this element. For <span class="css" id="ref-for-valdef-all-revert-layer⑤">revert-layer</span> in <span id="ref-for-important②⓪">important</span> <a href="#style-attr">element-attached styles</a>, however, it only reverts the <a href="#style-attr">element-attached styles</a> and the intervening <a data-link-type="dfn" href="#cascade-origin-animation" id="ref-for-cascade-origin-animation">animation origin</a>, and not any of the intervening <a data-link-type="dfn" href="#cascade-origin-author" id="ref-for-cascade-origin-author①③">author-origin</a> <span id="ref-for-important②①">important</span> rules.</p> <p class="note" role="note"><span>Note:</span> If there are no lower-precedence <a data-link-type="dfn" href="https://drafts.csswg.org/cssom-1/#cssstyledeclaration-declarations" id="ref-for-cssstyledeclaration-declarations①②">declarations</a> in the same <a data-link-type="dfn" href="#origin" id="ref-for-origin①⑦">cascade origin</a> as the <a class="css" data-link-type="maybe" href="#valdef-all-revert-layer" id="ref-for-valdef-all-revert-layer⑥">revert-layer</a> value, the <a data-link-type="dfn" href="#cascaded-value" id="ref-for-cascaded-value①⑦">cascaded value</a> will roll back to the previous origin.</p> <p class="note" role="note"><span>Note:</span> The <a data-link-type="dfn" href="#cascade-origin-animation" id="ref-for-cascade-origin-animation①">animation origin</a> is not collapsed with the <a data-link-type="dfn" href="#cascade-origin-author" id="ref-for-cascade-origin-author①④">author origin</a> for this purpose as it is for <a class="css" data-link-type="maybe" href="#valdef-all-revert" id="ref-for-valdef-all-revert⑥">revert</a>, and thus effectively forms its own <a data-link-type="dfn" href="#cascade-layers" id="ref-for-cascade-layers①⑥">cascade layer</a>.</p> <h2 class="heading settled" data-level="8" id="layer-apis"><span class="secno">8. </span><span class="content">Layer APIs</span><a class="self-link" href="#layer-apis"></a></h2> <h3 class="heading settled" data-level="8.1" id="extensions-to-cssimportrule-interface"><span class="secno">8.1. </span><span class="content"> Extensions to the <code>CSSImportRule</code> interface</span><a class="self-link" href="#extensions-to-cssimportrule-interface"></a></h3> <p>The <code>CSSImportRule</code> interface is extended as follows:</p> <pre class="idl highlight def"><c- b>partial</c-> <c- b>interface</c-> <a class="idl-code" data-link-type="interface" href="https://drafts.csswg.org/cssom-1/#cssimportrule" id="ref-for-cssimportrule"><c- g>CSSImportRule</c-></a> { <c- b>readonly</c-> <c- b>attribute</c-> <a data-link-type="idl-name" href="https://drafts.csswg.org/cssom-1/#cssomstring" id="ref-for-cssomstring"><c- n>CSSOMString</c-></a>? <a class="idl-code" data-link-type="attribute" data-readonly data-type="CSSOMString?" href="#dom-cssimportrule-layername" id="ref-for-dom-cssimportrule-layername"><c- g>layerName</c-></a>; }; </pre> <p>Its <dfn class="dfn-paneled idl-code" data-dfn-for="CSSImportRule" data-dfn-type="attribute" data-export id="dom-cssimportrule-layername"><code>layerName</code></dfn> attribute represents the <a data-link-type="dfn" href="#layer-name" id="ref-for-layer-name④">layer name</a> declared in the at-rule itself, and is an empty string if the layer is anonymous, or null if the at-rule does not declare a layer.</p> <h3 class="heading settled" data-level="8.2" id="the-csslayerblockrule-interface"><span class="secno">8.2. </span><span class="content"> The <code>CSSLayerBlockRule</code> interface</span><a class="self-link" href="#the-csslayerblockrule-interface"></a></h3> <p>The <code class="idl"><a data-link-type="idl" href="#csslayerblockrule" id="ref-for-csslayerblockrule">CSSLayerBlockRule</a></code> interface represents the <a class="css" data-link-type="maybe" href="#at-ruledef-layer" id="ref-for-at-ruledef-layer②①">@layer</a> <a href="#layer-block">block rule</a>:</p> <pre class="idl highlight def">[<a class="idl-code" data-link-type="extended-attribute" href="https://webidl.spec.whatwg.org/#Exposed" id="ref-for-Exposed"><c- g>Exposed</c-></a>=<c- n>Window</c->] <c- b>interface</c-> <dfn class="dfn-paneled idl-code" data-dfn-type="interface" data-export id="csslayerblockrule"><code><c- g>CSSLayerBlockRule</c-></code></dfn> : <a data-link-type="idl-name" href="https://drafts.csswg.org/cssom-1/#cssgroupingrule" id="ref-for-cssgroupingrule"><c- n>CSSGroupingRule</c-></a> { <c- b>readonly</c-> <c- b>attribute</c-> <a data-link-type="idl-name" href="https://drafts.csswg.org/cssom-1/#cssomstring" id="ref-for-cssomstring①"><c- n>CSSOMString</c-></a> <a class="idl-code" data-link-type="attribute" data-readonly data-type="CSSOMString" href="#dom-csslayerblockrule-name" id="ref-for-dom-csslayerblockrule-name"><c- g>name</c-></a>; }; </pre> <p>Its <dfn class="dfn-paneled idl-code" data-dfn-for="CSSLayerBlockRule" data-dfn-type="attribute" data-export id="dom-csslayerblockrule-name"><code>name</code></dfn> attribute represents the <a data-link-type="dfn" href="#layer-name" id="ref-for-layer-name⑤">layer name</a> declared by the at-rule itself, and is an empty string if the layer is anonymous.</p> <div class="example" id="example-1c46cc0f"> <a class="self-link" href="#example-1c46cc0f"></a> For example, additional nested context is not added from wrapping layer rules. <pre class="lang-css highlight"><c- n>@layer</c-> outer <c- p>{</c-> <c- n>@layer</c-> foo.bar <c- p>{</c-> <c- p>}</c-> <c- p>}</c-> </pre> <p>in this case the <code class="idl"><a data-link-type="idl" href="#dom-csslayerblockrule-name" id="ref-for-dom-csslayerblockrule-name①">name</a></code> of the inner <a class="css" data-link-type="maybe" href="#at-ruledef-layer" id="ref-for-at-ruledef-layer②②">@layer</a> rule is “foo.bar” (and not “outer.foo.bar”).</p> </div> <h3 class="heading settled" data-level="8.3" id="the-csslayerstatementrule-interface"><span class="secno">8.3. </span><span class="content"> The <code>CSSLayerStatementRule</code> interface</span><a class="self-link" href="#the-csslayerstatementrule-interface"></a></h3> <p>The <code class="idl"><a data-link-type="idl" href="#csslayerstatementrule" id="ref-for-csslayerstatementrule">CSSLayerStatementRule</a></code> interface represents the <a class="css" data-link-type="maybe" href="#at-ruledef-layer" id="ref-for-at-ruledef-layer②③">@layer</a> <a href="#layer-empty">statement</a>:</p> <pre class="idl highlight def">[<a class="idl-code" data-link-type="extended-attribute" href="https://webidl.spec.whatwg.org/#Exposed" id="ref-for-Exposed①"><c- g>Exposed</c-></a>=<c- n>Window</c->] <c- b>interface</c-> <dfn class="dfn-paneled idl-code" data-dfn-type="interface" data-export id="csslayerstatementrule"><code><c- g>CSSLayerStatementRule</c-></code></dfn> : <a data-link-type="idl-name" href="https://drafts.csswg.org/cssom-1/#cssrule" id="ref-for-cssrule"><c- n>CSSRule</c-></a> { <c- b>readonly</c-> <c- b>attribute</c-> <a class="idl-code" data-link-type="interface" href="https://webidl.spec.whatwg.org/#idl-frozen-array" id="ref-for-idl-frozen-array"><c- b>FrozenArray</c-></a><<a data-link-type="idl-name" href="https://drafts.csswg.org/cssom-1/#cssomstring" id="ref-for-cssomstring②"><c- n>CSSOMString</c-></a>> <a class="idl-code" data-link-type="attribute" data-readonly data-type="FrozenArray<CSSOMString>" href="#dom-csslayerstatementrule-namelist" id="ref-for-dom-csslayerstatementrule-namelist"><c- g>nameList</c-></a>; }; </pre> <p>Its <dfn class="dfn-paneled idl-code" data-dfn-for="CSSLayerStatementRule" data-dfn-type="attribute" data-export id="dom-csslayerstatementrule-namelist"><code>nameList</code></dfn> attribute represents the list of <a data-link-type="dfn" href="#layer-name" id="ref-for-layer-name⑥">layer names</a> declared by the at-rule, normalized following the same rule as the <code class="idl"><a data-link-type="idl" href="#csslayerblockrule" id="ref-for-csslayerblockrule①">CSSLayerBlockRule</a></code>’s <code class="idl"><a data-link-type="idl" href="#dom-csslayerblockrule-name" id="ref-for-dom-csslayerblockrule-name②">name</a></code> attribute.</p> <h2 class="heading settled" data-level="9" id="changes"><span class="secno">9. </span><span class="content"> Changes</span><a class="self-link" href="#changes"></a></h2> <h3 class="heading settled" data-level="9.1" id="changes-2022-01"><span class="secno">9.1. </span><span class="content"> Changes since the 13 Jan 2022 Candidate Recommendation Snapshot</span><a class="self-link" href="#changes-2022-01"></a></h3> <p>Non-trivial changes since the <a href="CSS Cascading and Inheritance Level 5">Candidate Recommendation Snapshot</a>:</p> <ul> <li data-md> <p>Clarify that all “aliases” of a property are reverted by <a class="css" data-link-type="maybe" href="#valdef-all-revert" id="ref-for-valdef-all-revert⑦">revert</a>/<a class="css" data-link-type="maybe" href="#valdef-all-revert-layer" id="ref-for-valdef-all-revert-layer⑦">revert-layer</a>.</p> <li data-md> <p>Clarify that style sheets are ordered in [[final CSS style sheets]] order.</p> </ul> <h3 class="heading settled" data-level="9.2" id="changes-2021-10"><span class="secno">9.2. </span><span class="content"> Changes since the 15 Oct 2021 Working Draft</span><a class="self-link" href="#changes-2021-10"></a></h3> <p>Non-trivial changes since the <a href="https://www.w3.org/TR/2021/WD-css-cascade-5-20211015/">15 October 2021 Working Draft</a>:</p> <ul> <li data-md> <p>Updated grammar style for @import media queries and supports conditions</p> <li data-md> <p>Allowed functional notation parse-time aliases (<a href="https://github.com/w3c/csswg-drafts/issues/6193">Issue 6193</a>)</p> <li data-md> <p>Made CSSImportRule.layerName nullable (<a href="https://github.com/w3c/csswg-drafts/issues/6576">Issue 6576</a>)</p> <li data-md> <p>Clarified that revert-layer in style attr does not revert author layers (<a href="https://github.com/w3c/csswg-drafts/issues/6743">Issue 6743</a>)</p> <li data-md> <p>Clarified revert-layer on style attr and keyframes (<a href="https://github.com/w3c/csswg-drafts/issues/6743">Issue 6743</a>)</p> <li data-md> <p>Added <a href="#value-aliasing">§ 4.1.1 Value Aliasing</a> section. (<a href="https://github.com/w3c/csswg-drafts/issues/6193">Issue 6193</a>)</p> <li data-md> <p>Added <a href="#layer-apis">§ 8 Layer APIs</a> section. (<a href="https://github.com/w3c/csswg-drafts/issues/6576">Issue 6576</a>)</p> <li data-md> <p>Clarified the behavior of <a class="css" data-link-type="maybe" href="#valdef-all-revert-layer" id="ref-for-valdef-all-revert-layer⑧">revert-layer</a> keyword when used in the style attribute or <a class="css" data-link-type="maybe" href="https://drafts.csswg.org/css-animations-1/#at-ruledef-keyframes" id="ref-for-at-ruledef-keyframes①">@keyframes</a> at-rule. (<a href="https://github.com/w3c/csswg-drafts/issues/6743">Issue 6743</a>)</p> <li data-md> <p>Clarified the behavior of the <span class="css">layer</span> keyword and <span class="css">layer()</span> function on <a class="css" data-link-type="maybe" href="#at-ruledef-import" id="ref-for-at-ruledef-import②⑥">@import</a> rules. (<a href="https://github.com/w3c/csswg-drafts/issues/6776">Issue 6776</a>)</p> </ul> <h3 class="heading settled" data-level="9.3" id="changes-2021-08"><span class="secno">9.3. </span><span class="content"> Changes since the 29 August 2021 Working Draft</span><a class="self-link" href="#changes-2021-08"></a></h3> <p>Changes since the <a href="https://www.w3.org/TR/2021/WD-css-cascade-5-20210829/">29 August 2021 Working Draft</a> include:</p> <ul> <li data-md> <p>Revert the ordering of unlayered styles. (See <a href="#changes-2021-06">§ 9.4 Changes since the 8 June 2021 Working Draft</a> and <a href="https://github.com/w3c/csswg-drafts/issues/6284">Issue 6284</a>)</p> <li data-md> <p>Defined presentational hints to use the <a data-link-type="dfn" href="#author-presentational-hint-origin" id="ref-for-author-presentational-hint-origin②">author presentational hint origin</a> instead of layers, matching update to <a data-link-type="biblio" href="#biblio-css-cascade-4">[CSS-CASCADE-4]</a>. (<a href="https://github.com/w3c/csswg-drafts/issues/6659">Issue 6659</a>)</p> </ul> <h3 class="heading settled" data-level="9.4" id="changes-2021-06"><span class="secno">9.4. </span><span class="content"> Changes since the 8 June 2021 Working Draft</span><a class="self-link" href="#changes-2021-06"></a></h3> <p>Significant changes since the <a href="https://www.w3.org/TR/2021/WD-css-cascade-5-20210608/">8 June 2021 Working Draft</a> include:</p> <ul> <li data-md> <p>Reserve the CSS-wide keywords for future use in layer-names. (<a href="https://github.com/w3c/csswg-drafts/issues/6323">Issue 6323</a>)</p> <li data-md> <p>Clarify that <a class="css" data-link-type="maybe" href="#at-ruledef-layer" id="ref-for-at-ruledef-layer②④">@layer</a> rules respect global conditional rules, but are always applied to the layer order when declared in non-global conditions such as a container query. (<a href="https://github.com/w3c/csswg-drafts/issues/6407">Issue 6407</a>)</p> <li data-md> <p>Name-defining at-rules follow layer order for collision resolution, similar to specificity resolution. (<a href="https://github.com/w3c/csswg-drafts/issues/6404">Issue 6404</a>)</p> <li data-md> <p>Disallow interleaving of <a class="css" data-link-type="maybe" href="#at-ruledef-layer" id="ref-for-at-ruledef-layer②⑤">@layer</a> with <a class="css" data-link-type="maybe" href="#at-ruledef-import" id="ref-for-at-ruledef-import②⑦">@import</a> or <span class="css">@namespace</span> rules. (<a href="https://github.com/w3c/csswg-drafts/issues/6522">Issue 6522</a>)</p> </ul> <h3 class="heading settled" data-level="9.5" id="changes-2021-03"><span class="secno">9.5. </span><span class="content"> Changes since the 19 March 2021 Working Draft</span><a class="self-link" href="#changes-2021-03"></a></h3> <p>Significant changes since the <a href="https://www.w3.org/TR/2021/WD-css-cascade-5-20210319/">19 March 2021 Working Draft</a> include:</p> <ul> <li data-md> <p>Switched the ordering of unlayered styles from highest to lowest precedence in the normal origins. (<a href="https://github.com/w3c/csswg-drafts/issues/6284">Issue 6284</a>)</p> </ul> <h3 class="heading settled" data-level="9.6" id="changes-2021-01"><span class="secno">9.6. </span><span class="content"> Changes since the 19 January 2021 Working Draft</span><a class="self-link" href="#changes-2021-01"></a></h3> <p>Significant changes since the <a href="https://www.w3.org/TR/2021/WD-css-cascade-5-20210119/">19 January 2021 First Public Working Draft</a> include:</p> <ul> <li data-md> <p>Switched <a data-link-type="dfn" href="#cascade-layers" id="ref-for-cascade-layers①⑦">layer</a> import syntax from using <a class="css" data-link-type="maybe" href="#at-ruledef-layer" id="ref-for-at-ruledef-layer②⑥">@layer</a> to using <a class="css" data-link-type="maybe" href="#at-ruledef-import" id="ref-for-at-ruledef-import②⑧">@import</a>. (<a href="https://github.com/w3c/csswg-drafts/issues/5681">Issue 5681</a>)</p> <li data-md> <p>Added <a class="css" data-link-type="maybe" href="#valdef-all-revert-layer" id="ref-for-valdef-all-revert-layer⑨">revert-layer</a> keyword. (<a href="https://github.com/w3c/csswg-drafts/issues/5793">Issue 5793</a>)</p> </ul> <h3 class="heading settled" data-level="9.7" id="additions-l4"><span class="secno">9.7. </span><span class="content"> Additions Since Level 4</span><a class="self-link" href="#additions-l4"></a></h3> <p>The following features have been added since <a href="https://www.w3.org/TR/css-cascade-4/">Level 4</a>:</p> <ul> <li data-md> <p>Added <a data-link-type="dfn" href="#cascade-layers" id="ref-for-cascade-layers①⑧">cascade layers</a> to the <a data-link-type="dfn" href="#cascade" id="ref-for-cascade①①">cascade</a> sort criteria (and defined style attributes as a distinct step of the <span id="ref-for-cascade①②">cascade</span> sort criteria so that they interact appropriately).</p> <li data-md> <p>Introduced the <a class="css" data-link-type="maybe" href="#at-ruledef-layer" id="ref-for-at-ruledef-layer②⑦">@layer</a> rule for defining cascade layers.</p> <li data-md> <p>Added <span class="css">layer</span>/<span class="css">layer()</span> option to <a class="css" data-link-type="maybe" href="#at-ruledef-import" id="ref-for-at-ruledef-import②⑨">@import</a> definition.</p> <li data-md> <p>Introduced the <a class="css" data-link-type="maybe" href="#valdef-all-revert-layer" id="ref-for-valdef-all-revert-layer①⓪">revert-layer</a> keyword for rolling back values to previous layers.</p> </ul> <h3 class="heading settled" data-level="9.8" id="additions-l3"><span class="secno">9.8. </span><span class="content"> Additions Since Level 3</span><a class="self-link" href="#additions-l3"></a></h3> <p>The following features have been added since <a href="https://www.w3.org/TR/css-cascade-3/">Level 3</a>:</p> <ul> <li data-md> <p>Introduced <a class="css" data-link-type="maybe" href="#valdef-all-revert" id="ref-for-valdef-all-revert⑧">revert</a> keyword, for rolling back the cascade.</p> <li data-md> <p>Introduced <a class="css" data-link-type="maybe" href="https://drafts.csswg.org/css-conditional-5/#funcdef-supports" id="ref-for-funcdef-supports">supports()</a> syntax for supports-conditional <a class="css" data-link-type="maybe" href="#at-ruledef-import" id="ref-for-at-ruledef-import③⓪">@import</a> rules.</p> <li data-md> <p>Added <a data-link-type="dfn" href="#encapsulation-contexts" id="ref-for-encapsulation-contexts⑤">encapsulation context</a> to the <a data-link-type="dfn" href="#cascade" id="ref-for-cascade①③">cascade</a> sort criteria to accommodate Shadow DOM. <a data-link-type="biblio" href="#biblio-dom">[DOM]</a></p> <li data-md> <p>Defined the property two aliasing mechanisms CSS uses to support legacy syntaxes. See <a href="#aliasing">§ 3.1 Property Aliasing</a>.</p> </ul> <h3 class="heading settled" data-level="9.9" id="changes-2"><span class="secno">9.9. </span><span class="content"> Additions Since Level 2</span><a class="self-link" href="#changes-2"></a></h3> <p>The following features have been added since <a href="http://www.w3.org/TR/CSS2/cascade.html">Level 2</a>:</p> <ul> <li>The <a class="property css" data-link-type="property" href="#propdef-all" id="ref-for-propdef-all③">all</a> shorthand <li>The <a class="css" data-link-type="maybe" href="#valdef-all-initial" id="ref-for-valdef-all-initial③">initial</a> keyword <li>The <a class="css" data-link-type="maybe" href="#valdef-all-unset" id="ref-for-valdef-all-unset②">unset</a> keyword <li>Incorporation of animations and transitions into the <a data-link-type="dfn" href="#cascade" id="ref-for-cascade①④">cascade</a>. </ul> <h2 class="no-num heading settled" id="acknowledgments"><span class="content">Acknowledgments</span><a class="self-link" href="#acknowledgments"></a></h2> <p>David Baron, Tantek Çelik, Florian Rivoal, Noam Rosenthal, Simon Sapin, Jen Simmons, and Boris Zbarsky contributed to this specification.</p> <h2 class="no-num heading settled" id="priv-sec"><span class="content"> Privacy and Security Considerations</span><a class="self-link" href="#priv-sec"></a></h2> <ul> <li data-md> <p>The cascade process does not distinguish between same-origin and cross-origin stylesheets, enabling the content of cross-origin stylesheets to be inferred from the computed styles they apply to a document.</p> <li data-md> <p>User preferences and UA defaults expressed via application of style rules are exposed by the cascade process, and can be inferred from the computed styles they apply to a document.</p> <li data-md> <p>The <a class="css" data-link-type="maybe" href="#at-ruledef-import" id="ref-for-at-ruledef-import③①">@import</a> rule does not apply the <a data-link-type="dfn" href="https://fetch.spec.whatwg.org/#cors-protocol" id="ref-for-cors-protocol">CORS protocol</a> to loading cross-origin stylesheets, instead allowing them to be freely imported and applied.</p> <li data-md> <p>The <a class="css" data-link-type="maybe" href="#at-ruledef-import" id="ref-for-at-ruledef-import③②">@import</a> rule assumes that resources without <a href="https://html.spec.whatwg.org/multipage/urls-and-fetching.html#content-type" id="termref-for-content-type"><code>Content-Type</code> metadata</a> (or any same-origin file if the host document is in quirks mode) are <code>text/css</code>, potentially allowing arbitrary files to be imported into the page and interpreted as CSS, potentially allowing sensitive data to be inferred from the computed styles they apply to a document.</p> </ul> </main> <h2 class="no-ref no-num heading settled" id="w3c-conformance"><span class="content"> Conformance</span><a class="self-link" href="#w3c-conformance"></a></h2> <h3 class="no-ref heading settled" id="w3c-conventions"><span class="content"> Document conventions</span><a class="self-link" href="#w3c-conventions"></a></h3> <p>Conformance requirements are expressed with a combination of descriptive assertions and RFC 2119 terminology. The key words “MUST”, “MUST NOT”, “REQUIRED”, “SHALL”, “SHALL NOT”, “SHOULD”, “SHOULD NOT”, “RECOMMENDED”, “MAY”, and “OPTIONAL” in the normative parts of this document are to be interpreted as described in RFC 2119. However, for readability, these words do not appear in all uppercase letters in this specification. </p> <p>All of the text of this specification is normative except sections explicitly marked as non-normative, examples, and notes. <a data-link-type="biblio" href="#biblio-rfc2119">[RFC2119]</a></p> <p>Examples in this specification are introduced with the words “for example” or are set apart from the normative text with <code>class="example"</code>, like this: </p> <div class="example" id="w3c-example"> <a class="self-link" href="#w3c-example"></a> <p>This is an example of an informative example.</p> </div> <p>Informative notes begin with the word “Note” and are set apart from the normative text with <code>class="note"</code>, like this: </p> <p class="note" role="note">Note, this is an informative note.</p> <p>Advisements are normative sections styled to evoke special attention and are set apart from other normative text with <code><strong class="advisement"></code>, like this: <strong class="advisement"> UAs MUST provide an accessible alternative. </strong></p> <details class="wpt-tests-block" dir="ltr" lang="en" open> <summary>Tests</summary> <p>Tests relating to the content of this specification may be documented in “Tests” blocks like this one. Any such block is non-normative.</p> <ul class="wpt-tests-list"></ul> <hr> </details> <h3 class="no-ref heading settled" id="w3c-conformance-classes"><span class="content"> Conformance classes</span><a class="self-link" href="#w3c-conformance-classes"></a></h3> <p>Conformance to this specification is defined for three conformance classes: </p> <dl> <dt>style sheet <dd>A <a href="http://www.w3.org/TR/CSS21/conform.html#style-sheet">CSS style sheet</a>. <dt>renderer <dd>A <a href="http://www.w3.org/TR/CSS21/conform.html#user-agent">UA</a> that interprets the semantics of a style sheet and renders documents that use them. <dt>authoring tool <dd>A <a href="http://www.w3.org/TR/CSS21/conform.html#user-agent">UA</a> that writes a style sheet. </dl> <p>A style sheet is conformant to this specification if all of its statements that use syntax defined in this module are valid according to the generic CSS grammar and the individual grammars of each feature defined in this module. </p> <p>A renderer is conformant to this specification if, in addition to interpreting the style sheet as defined by the appropriate specifications, it supports all the features defined by this specification by parsing them correctly and rendering the document accordingly. However, the inability of a UA to correctly render a document due to limitations of the device does not make the UA non-conformant. (For example, a UA is not required to render color on a monochrome monitor.) </p> <p>An authoring tool is conformant to this specification if it writes style sheets that are syntactically correct according to the generic CSS grammar and the individual grammars of each feature in this module, and meet all other conformance requirements of style sheets as described in this module. </p> <h3 class="no-ref heading settled" id="w3c-partial"><span class="content"> Partial implementations</span><a class="self-link" href="#w3c-partial"></a></h3> <p>So that authors can exploit the forward-compatible parsing rules to assign fallback values, CSS renderers <strong>must</strong> treat as invalid (and <a href="http://www.w3.org/TR/CSS21/conform.html#ignore">ignore as appropriate</a>) any at-rules, properties, property values, keywords, and other syntactic constructs for which they have no usable level of support. In particular, user agents <strong>must not</strong> selectively ignore unsupported component values and honor supported values in a single multi-value property declaration: if any value is considered invalid (as unsupported values must be), CSS requires that the entire declaration be ignored.</p> <h4 class="heading settled" id="w3c-conform-future-proofing"><span class="content"> Implementations of Unstable and Proprietary Features</span><a class="self-link" href="#w3c-conform-future-proofing"></a></h4> <p>To avoid clashes with future stable CSS features, the CSSWG recommends <a href="http://www.w3.org/TR/CSS/#future-proofing">following best practices</a> for the implementation of <a href="http://www.w3.org/TR/CSS/#unstable">unstable</a> features and <a href="http://www.w3.org/TR/CSS/#proprietary-extension">proprietary extensions</a> to CSS. </p> <h3 class="no-ref heading settled" id="w3c-testing"><span class="content"> Non-experimental implementations</span><a class="self-link" href="#w3c-testing"></a></h3> <p>Once a specification reaches the Candidate Recommendation stage, non-experimental implementations are possible, and implementors should release an unprefixed implementation of any CR-level feature they can demonstrate to be correctly implemented according to spec. </p> <p>To establish and maintain the interoperability of CSS across implementations, the CSS Working Group requests that non-experimental CSS renderers submit an implementation report (and, if necessary, the testcases used for that implementation report) to the W3C before releasing an unprefixed implementation of any CSS features. Testcases submitted to W3C are subject to review and correction by the CSS Working Group. </p> <p>Further information on submitting testcases and implementation reports can be found from on the CSS Working Group’s website at <a href="http://www.w3.org/Style/CSS/Test/">http://www.w3.org/Style/CSS/Test/</a>. Questions should be directed to the <a href="http://lists.w3.org/Archives/Public/public-css-testsuite">public-css-testsuite@w3.org</a> mailing list.</p> <script src="https://www.w3.org/scripts/TR/2021/fixup.js"></script> <aside class="caniuse-status wrapped" data-deco data-dfn-id="all-shorthand"> <input class="caniuse-panel-btn" type="button" value="CanIUse"> <p class="support"><b>Support:</b><span class="android yes"><span>Android Browser</span><span>4.4.3+</span></span><span class="baidu yes"><span>Baidu Browser</span><span>7.12+</span></span><span class="bb no"><span>Blackberry Browser</span><span>None</span></span><span class="chrome yes"><span>Chrome</span><span>37+</span></span><span class="and_chr yes"><span>Chrome for Android</span><span>103+</span></span><span class="edge yes"><span>Edge</span><span>79+</span></span><span class="firefox yes"><span>Firefox</span><span>27+</span></span><span class="and_ff yes"><span>Firefox for Android</span><span>101+</span></span><span class="ie no"><span>IE</span><span>None</span></span><span class="ie_mob no"><span>IE Mobile</span><span>None</span></span><span class="kaios yes"><span>KaiOS Browser</span><span>2.5+</span></span><span class="opera yes"><span>Opera</span><span>24+</span></span><span class="op_mini no"><span>Opera Mini</span><span>None</span></span><span class="op_mob yes"><span>Opera Mobile</span><span>64+</span></span><span class="and_qq yes"><span>QQ Browser</span><span>10.4+</span></span><span class="safari yes"><span>Safari</span><span>9.1+</span></span><span class="ios_saf yes"><span>Safari on iOS</span><span>9.3+</span></span><span class="samsung yes"><span>Samsung Internet</span><span>4+</span></span><span class="and_uc yes"><span>UC Browser for Android</span><span>12.12+</span></span></p> <p class="caniuse">Source: <a href="https://caniuse.com/#feat=css-all">caniuse.com</a> as of 2022-08-04</p> </aside> <aside class="caniuse-status wrapped" data-deco data-dfn-id="valdef-all-initial"> <input class="caniuse-panel-btn" type="button" value="CanIUse"> <p class="support"><b>Support:</b><span class="android yes"><span>Android Browser</span><span>2.3+</span></span><span class="baidu yes"><span>Baidu Browser</span><span>7.12+</span></span><span class="bb yes"><span>Blackberry Browser</span><span>7+</span></span><span class="chrome yes"><span>Chrome</span><span>4+</span></span><span class="and_chr yes"><span>Chrome for Android</span><span>103+</span></span><span class="edge yes"><span>Edge</span><span>12+</span></span><span class="firefox yes"><span>Firefox</span><span>19+</span></span><span class="and_ff yes"><span>Firefox for Android</span><span>101+</span></span><span class="ie no"><span>IE</span><span>None</span></span><span class="ie_mob no"><span>IE Mobile</span><span>None</span></span><span class="kaios yes"><span>KaiOS Browser</span><span>2.5+</span></span><span class="opera yes"><span>Opera</span><span>15+</span></span><span class="op_mini no"><span>Opera Mini</span><span>None</span></span><span class="op_mob yes"><span>Opera Mobile</span><span>64+</span></span><span class="and_qq yes"><span>QQ Browser</span><span>10.4+</span></span><span class="safari yes"><span>Safari</span><span>3.2+</span></span><span class="ios_saf yes"><span>Safari on iOS</span><span>4.0+</span></span><span class="samsung yes"><span>Samsung Internet</span><span>4+</span></span><span class="and_uc yes"><span>UC Browser for Android</span><span>12.12+</span></span></p> <p class="caniuse">Source: <a href="https://caniuse.com/#feat=css-initial-value">caniuse.com</a> as of 2022-08-04</p> </aside> <aside class="caniuse-status wrapped" data-deco data-dfn-id="valdef-all-unset"> <input class="caniuse-panel-btn" type="button" value="CanIUse"> <p class="support"><b>Support:</b><span class="android yes"><span>Android Browser</span><span>103+</span></span><span class="baidu yes"><span>Baidu Browser</span><span>7.12+</span></span><span class="bb no"><span>Blackberry Browser</span><span>None</span></span><span class="chrome yes"><span>Chrome</span><span>41+</span></span><span class="and_chr yes"><span>Chrome for Android</span><span>103+</span></span><span class="edge yes"><span>Edge</span><span>13+</span></span><span class="firefox yes"><span>Firefox</span><span>27+</span></span><span class="and_ff yes"><span>Firefox for Android</span><span>101+</span></span><span class="ie no"><span>IE</span><span>None</span></span><span class="ie_mob no"><span>IE Mobile</span><span>None</span></span><span class="kaios yes"><span>KaiOS Browser</span><span>2.5+</span></span><span class="opera yes"><span>Opera</span><span>28+</span></span><span class="op_mini no"><span>Opera Mini</span><span>None</span></span><span class="op_mob yes"><span>Opera Mobile</span><span>64+</span></span><span class="and_qq yes"><span>QQ Browser</span><span>10.4+</span></span><span class="safari yes"><span>Safari</span><span>9.1+</span></span><span class="ios_saf yes"><span>Safari on iOS</span><span>9.3+</span></span><span class="samsung yes"><span>Samsung Internet</span><span>4+</span></span><span class="and_uc yes"><span>UC Browser for Android</span><span>12.12+</span></span></p> <p class="caniuse">Source: <a href="https://caniuse.com/#feat=css-unset-value">caniuse.com</a> as of 2022-08-04</p> </aside> <aside class="caniuse-status wrapped" data-deco data-dfn-id="valdef-all-revert"> <input class="caniuse-panel-btn" type="button" value="CanIUse"> <p class="support"><b>Support:</b><span class="android yes"><span>Android Browser</span><span>103+</span></span><span class="baidu no"><span>Baidu Browser</span><span>None</span></span><span class="bb no"><span>Blackberry Browser</span><span>None</span></span><span class="chrome yes"><span>Chrome</span><span>84+</span></span><span class="and_chr yes"><span>Chrome for Android</span><span>103+</span></span><span class="edge yes"><span>Edge</span><span>84+</span></span><span class="firefox yes"><span>Firefox</span><span>67+</span></span><span class="and_ff yes"><span>Firefox for Android</span><span>101+</span></span><span class="ie no"><span>IE</span><span>None</span></span><span class="ie_mob no"><span>IE Mobile</span><span>None</span></span><span class="kaios no"><span>KaiOS Browser</span><span>None</span></span><span class="opera yes"><span>Opera</span><span>73+</span></span><span class="op_mini no"><span>Opera Mini</span><span>None</span></span><span class="op_mob yes"><span>Opera Mobile</span><span>64+</span></span><span class="and_qq no"><span>QQ Browser</span><span>None</span></span><span class="safari yes"><span>Safari</span><span>9.1+</span></span><span class="ios_saf yes"><span>Safari on iOS</span><span>9.3+</span></span><span class="samsung yes"><span>Samsung Internet</span><span>14.0+</span></span><span class="and_uc no"><span>UC Browser for Android</span><span>None</span></span></p> <p class="caniuse">Source: <a href="https://caniuse.com/#feat=css-revert-value">caniuse.com</a> as of 2022-08-04</p> </aside> <h2 class="no-num no-ref heading settled" id="index"><span class="content">Index</span><a class="self-link" href="#index"></a></h2> <h3 class="no-num no-ref heading settled" id="index-defined-here"><span class="content">Terms defined by this specification</span><a class="self-link" href="#index-defined-here"></a></h3> <ul class="index"> <li><a href="#actual-value">actual</a><span>, in § 4.6</span> <li><a href="#actual-value">actual value</a><span>, in § 4.6</span> <li><a href="#propdef-all">all</a><span>, in § 3.2</span> <li><a href="#cascade-origin-animation">Animation Origin</a><span>, in § 6.2</span> <li><a href="#apply">apply to</a><span>, in § 4.5.1</span> <li><a href="#cascade-origin-author">author origin</a><span>, in § 6.2</span> <li><a href="#cascade-origin-author">author-origin</a><span>, in § 6.2</span> <li><a href="#author-presentational-hint-origin">author presentational hint origin</a><span>, in § 6.5</span> <li><a href="#cascade-origin-author">author style sheet</a><span>, in § 6.2</span> <li><a href="#cascade">cascade</a><span>, in § 6</span> <li><a href="#cascaded-value">cascaded</a><span>, in § 4.2</span> <li><a href="#cascade-dependent-keyword">cascade-dependent keyword</a><span>, in § 7.3</span> <li><a href="#cascaded-value">cascaded value</a><span>, in § 4.2</span> <li><a href="#cascade-layers">cascade layers</a><span>, in § 6.4</span> <li><a href="#origin">cascade origin</a><span>, in § 6.2</span> <li><a href="#computed-value">computed</a><span>, in § 4.4</span> <li><a href="#computed-value">computed value</a><span>, in § 4.4</span> <li><a href="#encapsulation-contexts">context</a><span>, in § 6.1</span> <li><a href="#csslayerblockrule">CSSLayerBlockRule</a><span>, in § 8.2</span> <li><a href="#csslayerstatementrule">CSSLayerStatementRule</a><span>, in § 8.3</span> <li><a href="#declared-value">declared</a><span>, in § 4.1</span> <li><a href="#declared-value">declared value</a><span>, in § 4.1</span> <li><a href="#encapsulation-contexts">encapsulation contexts</a><span>, in § 6.1</span> <li><a href="#at-ruledef-import">@import</a><span>, in § 2</span> <li><a href="#important">importance</a><span>, in § 6.3</span> <li><a href="#important">important</a><span>, in § 6.3</span> <li><a href="#typedef-import-conditions"><import-conditions></a><span>, in § 2</span> <li><a href="#import-conditions">Import conditions</a><span>, in § 2.1</span> <li> inherit <ul> <li><a href="#inheritance">definition of</a><span>, in § 7.2</span> <li><a href="#valdef-all-inherit">value for all</a><span>, in § 7.3.2</span> </ul> <li><a href="#inheritance">inheritance</a><span>, in § 7.2</span> <li><a href="#inherited-property">inherited property</a><span>, in § 7.2</span> <li><a href="#inherited-value">inherited value</a><span>, in § 7.2</span> <li><a href="#valdef-all-initial">initial</a><span>, in § 7.3.1</span> <li><a href="#initial-value">initial value</a><span>, in § 7.1</span> <li><a href="#at-ruledef-layer">@layer</a><span>, in § 6.4.4</span> <li><a href="#cascade-layers">layer</a><span>, in § 6.4</span> <li><a href="#typedef-layer-name"><layer-name></a><span>, in § 6.4.2</span> <li><a href="#layer-name">layer name</a><span>, in § 6.4.2</span> <li><a href="#dom-cssimportrule-layername">layerName</a><span>, in § 8.1</span> <li><a href="#legacy-name-alias">legacy name alias</a><span>, in § 3.1</span> <li><a href="#legacy-shorthand">legacy shorthand</a><span>, in § 3.1</span> <li><a href="#css-legacy-value-alias">legacy value alias</a><span>, in § 4.1.1</span> <li><a href="#longhand">longhand</a><span>, in § 3</span> <li><a href="#longhand">longhand property</a><span>, in § 3</span> <li><a href="#dom-csslayerblockrule-name">name</a><span>, in § 8.2</span> <li><a href="#dom-csslayerstatementrule-namelist">nameList</a><span>, in § 8.3</span> <li><a href="#normal">normal</a><span>, in § 6.3</span> <li><a href="#origin">origin</a><span>, in § 6.2</span> <li><a href="#output-of-the-cascade">output of the cascade</a><span>, in § 6.1</span> <li><a href="#css-property">property</a><span>, in § 1</span> <li><a href="#reset-only-sub-property">reset-only sub-property</a><span>, in § 3</span> <li><a href="#valdef-all-revert">revert</a><span>, in § 7.3.4</span> <li><a href="#valdef-all-revert-layer">revert-layer</a><span>, in § 7.3.5</span> <li><a href="#shorthand-property">shorthand</a><span>, in § 3</span> <li><a href="#shorthand-property">shorthand property</a><span>, in § 3</span> <li><a href="#specified-value">specified</a><span>, in § 4.3</span> <li><a href="#specified-value">specified value</a><span>, in § 4.3</span> <li><a href="#longhand">sub-property</a><span>, in § 3</span> <li><a href="#cascade-origin-transition">Transition Origin</a><span>, in § 6.2</span> <li><a href="#cascade-origin-ua">UA origin</a><span>, in § 6.2</span> <li><a href="#cascade-origin-ua">UA-origin</a><span>, in § 6.2</span> <li><a href="#cascade-origin-ua">UA style sheet</a><span>, in § 6.2</span> <li><a href="#valdef-all-unset">unset</a><span>, in § 7.3.3</span> <li><a href="#used-value">used</a><span>, in § 4.5</span> <li><a href="#used-value">used value</a><span>, in § 4.5</span> <li><a href="#cascade-origin-ua">user-agent origin</a><span>, in § 6.2</span> <li><a href="#cascade-origin-ua">user-agent style sheet</a><span>, in § 6.2</span> <li><a href="#cascade-origin-user">user origin</a><span>, in § 6.2</span> <li><a href="#cascade-origin-user">user-origin</a><span>, in § 6.2</span> <li><a href="#cascade-origin-user">user style sheet</a><span>, in § 6.2</span> </ul> <aside class="dfn-panel" data-for="term-for-vendor-prefix"> <a href="https://drafts.csswg.org/css-2021/#vendor-prefix">https://drafts.csswg.org/css-2021/#vendor-prefix</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-vendor-prefix">4.1.1. Value Aliasing</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-valdef-justify-self-auto"> <a href="https://drafts.csswg.org/css-align-3/#valdef-justify-self-auto">https://drafts.csswg.org/css-align-3/#valdef-justify-self-auto</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-valdef-justify-self-auto">4.4. Computed Values</a> <li><a href="#ref-for-valdef-justify-self-auto①">4.5. Used Values</a> <a href="#ref-for-valdef-justify-self-auto②">(2)</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-at-ruledef-keyframes"> <a href="https://drafts.csswg.org/css-animations-1/#at-ruledef-keyframes">https://drafts.csswg.org/css-animations-1/#at-ruledef-keyframes</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-at-ruledef-keyframes">6.4. Cascade Layers</a> <li><a href="#ref-for-at-ruledef-keyframes①">9.2. Changes since the 15 Oct 2021 Working Draft</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-propdef-background"> <a href="https://drafts.csswg.org/css-backgrounds-3/#propdef-background">https://drafts.csswg.org/css-backgrounds-3/#propdef-background</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-propdef-background">3. Shorthand Properties</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-propdef-background-color"> <a href="https://drafts.csswg.org/css-backgrounds-3/#propdef-background-color">https://drafts.csswg.org/css-backgrounds-3/#propdef-background-color</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-propdef-background-color">3. Shorthand Properties</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-propdef-background-image"> <a href="https://drafts.csswg.org/css-backgrounds-3/#propdef-background-image">https://drafts.csswg.org/css-backgrounds-3/#propdef-background-image</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-propdef-background-image">3. Shorthand Properties</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-propdef-border"> <a href="https://drafts.csswg.org/css-backgrounds-3/#propdef-border">https://drafts.csswg.org/css-backgrounds-3/#propdef-border</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-propdef-border">3. Shorthand Properties</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-propdef-border-bottom-width"> <a href="https://drafts.csswg.org/css-backgrounds-3/#propdef-border-bottom-width">https://drafts.csswg.org/css-backgrounds-3/#propdef-border-bottom-width</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-propdef-border-bottom-width">4.7. Examples</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-propdef-border-color"> <a href="https://drafts.csswg.org/css-backgrounds-3/#propdef-border-color">https://drafts.csswg.org/css-backgrounds-3/#propdef-border-color</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-propdef-border-color">4.8. Per-Fragment Value Processing</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-propdef-border-image"> <a href="https://drafts.csswg.org/css-backgrounds-3/#propdef-border-image">https://drafts.csswg.org/css-backgrounds-3/#propdef-border-image</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-propdef-border-image">3. Shorthand Properties</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-propdef-border-left-width"> <a href="https://drafts.csswg.org/css-backgrounds-3/#propdef-border-left-width">https://drafts.csswg.org/css-backgrounds-3/#propdef-border-left-width</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-propdef-border-left-width">4.7. Examples</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-propdef-border-right-width"> <a href="https://drafts.csswg.org/css-backgrounds-3/#propdef-border-right-width">https://drafts.csswg.org/css-backgrounds-3/#propdef-border-right-width</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-propdef-border-right-width">4.7. Examples</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-propdef-border-style"> <a href="https://drafts.csswg.org/css-backgrounds-3/#propdef-border-style">https://drafts.csswg.org/css-backgrounds-3/#propdef-border-style</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-propdef-border-style">1. Introduction</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-propdef-border-top-width"> <a href="https://drafts.csswg.org/css-backgrounds-3/#propdef-border-top-width">https://drafts.csswg.org/css-backgrounds-3/#propdef-border-top-width</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-propdef-border-top-width">4.7. Examples</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-valdef-line-style-dotted"> <a href="https://drafts.csswg.org/css-backgrounds-3/#valdef-line-style-dotted">https://drafts.csswg.org/css-backgrounds-3/#valdef-line-style-dotted</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-valdef-line-style-dotted">1. Introduction</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-propdef-break-before"> <a href="https://drafts.csswg.org/css-break-3/#propdef-break-before">https://drafts.csswg.org/css-break-3/#propdef-break-before</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-propdef-break-before">3.1. Property Aliasing</a> <a href="#ref-for-propdef-break-before①">(2)</a> <a href="#ref-for-propdef-break-before②">(3)</a> <a href="#ref-for-propdef-break-before③">(4)</a> <li><a href="#ref-for-propdef-break-before④">4.5. Used Values</a> <a href="#ref-for-propdef-break-before⑤">(2)</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-propdef-orphans"> <a href="https://drafts.csswg.org/css-break-3/#propdef-orphans">https://drafts.csswg.org/css-break-3/#propdef-orphans</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-propdef-orphans">4.6. Actual Values</a> <li><a href="#ref-for-propdef-orphans①">4.7. Examples</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-box-fragment"> <a href="https://drafts.csswg.org/css-break-4/#box-fragment">https://drafts.csswg.org/css-break-4/#box-fragment</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-box-fragment">4.8. Per-Fragment Value Processing</a> <a href="#ref-for-box-fragment①">(2)</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-valdef-break-before-page"> <a href="https://drafts.csswg.org/css-break-4/#valdef-break-before-page">https://drafts.csswg.org/css-break-4/#valdef-break-before-page</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-valdef-break-before-page">4.5. Used Values</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-typedef-color"> <a href="https://drafts.csswg.org/css-color-4/#typedef-color">https://drafts.csswg.org/css-color-4/#typedef-color</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-typedef-color">1. Introduction</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-propdef-color"> <a href="https://drafts.csswg.org/css-color-4/#propdef-color">https://drafts.csswg.org/css-color-4/#propdef-color</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-propdef-color">1. Introduction</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-valdef-color-currentcolor"> <a href="https://drafts.csswg.org/css-color-4/#valdef-color-currentcolor">https://drafts.csswg.org/css-color-4/#valdef-color-currentcolor</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-valdef-color-currentcolor">4.8. Per-Fragment Value Processing</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-valdef-color-red"> <a href="https://drafts.csswg.org/css-color-4/#valdef-color-red">https://drafts.csswg.org/css-color-4/#valdef-color-red</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-valdef-color-red">1. Introduction</a> <li><a href="#ref-for-valdef-color-red①">4.4. Computed Values</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-typedef-supports-condition"> <a href="https://drafts.csswg.org/css-conditional-3/#typedef-supports-condition">https://drafts.csswg.org/css-conditional-3/#typedef-supports-condition</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-typedef-supports-condition">2. Importing Style Sheets: the @import rule</a> <li><a href="#ref-for-typedef-supports-condition①">2.1. Conditional @import Rules</a> <a href="#ref-for-typedef-supports-condition②">(2)</a> <a href="#ref-for-typedef-supports-condition③">(3)</a> <a href="#ref-for-typedef-supports-condition④">(4)</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-typedef-supports-decl"> <a href="https://drafts.csswg.org/css-conditional-3/#typedef-supports-decl">https://drafts.csswg.org/css-conditional-3/#typedef-supports-decl</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-typedef-supports-decl">2.1. Conditional @import Rules</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-at-ruledef-media"> <a href="https://drafts.csswg.org/css-conditional-3/#at-ruledef-media">https://drafts.csswg.org/css-conditional-3/#at-ruledef-media</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-at-ruledef-media">2.1. Conditional @import Rules</a> <li><a href="#ref-for-at-ruledef-media①">6.4.3. Layer Ordering</a> <li><a href="#ref-for-at-ruledef-media②">6.4.4.1. Assigning Styles Inline: the @layer block at-rule</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-at-ruledef-supports"> <a href="https://drafts.csswg.org/css-conditional-3/#at-ruledef-supports">https://drafts.csswg.org/css-conditional-3/#at-ruledef-supports</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-at-ruledef-supports">2.1. Conditional @import Rules</a> <li><a href="#ref-for-at-ruledef-supports①">6.4.3. Layer Ordering</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-conditional-group-rule"> <a href="https://drafts.csswg.org/css-conditional-3/#conditional-group-rule">https://drafts.csswg.org/css-conditional-3/#conditional-group-rule</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-conditional-group-rule">2. Importing Style Sheets: the @import rule</a> <li><a href="#ref-for-conditional-group-rule①">6.4.3. Layer Ordering</a> <a href="#ref-for-conditional-group-rule②">(2)</a> <a href="#ref-for-conditional-group-rule③">(3)</a> <li><a href="#ref-for-conditional-group-rule④">6.4.4.1. Assigning Styles Inline: the @layer block at-rule</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-funcdef-supports"> <a href="https://drafts.csswg.org/css-conditional-5/#funcdef-supports">https://drafts.csswg.org/css-conditional-5/#funcdef-supports</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-funcdef-supports">9.8. Additions Since Level 3</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-valdef-contain-layout"> <a href="https://drafts.csswg.org/css-contain-2/#valdef-contain-layout">https://drafts.csswg.org/css-contain-2/#valdef-contain-layout</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-valdef-contain-layout">6.4.3. Layer Ordering</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-box"> <a href="https://drafts.csswg.org/css-display-3/#box">https://drafts.csswg.org/css-display-3/#box</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-box">4.8. Per-Fragment Value Processing</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-propdef-display"> <a href="https://drafts.csswg.org/css-display-3/#propdef-display">https://drafts.csswg.org/css-display-3/#propdef-display</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-propdef-display">2. Importing Style Sheets: the @import rule</a> <li><a href="#ref-for-propdef-display①">3.2. Resetting All Properties: the all property</a> <li><a href="#ref-for-propdef-display②">4.5.1. Applicable Properties</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-display-type"> <a href="https://drafts.csswg.org/css-display-3/#display-type">https://drafts.csswg.org/css-display-3/#display-type</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-display-type">4.5.1. Applicable Properties</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-elements"> <a href="https://drafts.csswg.org/css-display-3/#elements">https://drafts.csswg.org/css-display-3/#elements</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-elements">1.1. Module Interactions</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-inline-box"> <a href="https://drafts.csswg.org/css-display-3/#inline-box">https://drafts.csswg.org/css-display-3/#inline-box</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-inline-box">4.5.1. Applicable Properties</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-text-nodes"> <a href="https://drafts.csswg.org/css-display-3/#text-nodes">https://drafts.csswg.org/css-display-3/#text-nodes</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-text-nodes">1.1. Module Interactions</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-propdef-flex"> <a href="https://drafts.csswg.org/css-flexbox-1/#propdef-flex">https://drafts.csswg.org/css-flexbox-1/#propdef-flex</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-propdef-flex">4.5. Used Values</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-flex-item"> <a href="https://drafts.csswg.org/css-flexbox-1/#flex-item">https://drafts.csswg.org/css-flexbox-1/#flex-item</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-flex-item">4.5. Used Values</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-valdef-font-weight-bolder"> <a href="https://drafts.csswg.org/css-fonts-4/#valdef-font-weight-bolder">https://drafts.csswg.org/css-fonts-4/#valdef-font-weight-bolder</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-valdef-font-weight-bolder">4.4. Computed Values</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-propdef-font"> <a href="https://drafts.csswg.org/css-fonts-4/#propdef-font">https://drafts.csswg.org/css-fonts-4/#propdef-font</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-propdef-font">3. Shorthand Properties</a> <a href="#ref-for-propdef-font①">(2)</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-propdef-font-family"> <a href="https://drafts.csswg.org/css-fonts-4/#propdef-font-family">https://drafts.csswg.org/css-fonts-4/#propdef-font-family</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-propdef-font-family">3. Shorthand Properties</a> <li><a href="#ref-for-propdef-font-family①">6.3. Important Declarations: the !important annotation</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-propdef-font-size"> <a href="https://drafts.csswg.org/css-fonts-4/#propdef-font-size">https://drafts.csswg.org/css-fonts-4/#propdef-font-size</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-propdef-font-size">1. Introduction</a> <li><a href="#ref-for-propdef-font-size①">3. Shorthand Properties</a> <li><a href="#ref-for-propdef-font-size②">4.7. Examples</a> <li><a href="#ref-for-propdef-font-size③">6.3. Important Declarations: the !important annotation</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-propdef-font-style"> <a href="https://drafts.csswg.org/css-fonts-4/#propdef-font-style">https://drafts.csswg.org/css-fonts-4/#propdef-font-style</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-propdef-font-style">3. Shorthand Properties</a> <li><a href="#ref-for-propdef-font-style①">6.3. Important Declarations: the !important annotation</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-propdef-font-variant"> <a href="https://drafts.csswg.org/css-fonts-4/#propdef-font-variant">https://drafts.csswg.org/css-fonts-4/#propdef-font-variant</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-propdef-font-variant">3. Shorthand Properties</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-propdef-font-weight"> <a href="https://drafts.csswg.org/css-fonts-4/#propdef-font-weight">https://drafts.csswg.org/css-fonts-4/#propdef-font-weight</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-propdef-font-weight">3. Shorthand Properties</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-valdef-font-style-italic"> <a href="https://drafts.csswg.org/css-fonts-4/#valdef-font-style-italic">https://drafts.csswg.org/css-fonts-4/#valdef-font-style-italic</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-valdef-font-style-italic">6.3. Important Declarations: the !important annotation</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-valdef-font-family-sans-serif"> <a href="https://drafts.csswg.org/css-fonts-4/#valdef-font-family-sans-serif">https://drafts.csswg.org/css-fonts-4/#valdef-font-family-sans-serif</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-valdef-font-family-sans-serif">6.3. Important Declarations: the !important annotation</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-at-font-face-rule"> <a href="https://drafts.csswg.org/css-fonts-5/#at-font-face-rule">https://drafts.csswg.org/css-fonts-5/#at-font-face-rule</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-at-font-face-rule">6.4. Cascade Layers</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-propdef-font-size-adjust"> <a href="https://drafts.csswg.org/css-fonts-5/#propdef-font-size-adjust">https://drafts.csswg.org/css-fonts-5/#propdef-font-size-adjust</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-propdef-font-size-adjust">4.6. Actual Values</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-root-inline-box"> <a href="https://drafts.csswg.org/css-inline-3/#root-inline-box">https://drafts.csswg.org/css-inline-3/#root-inline-box</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-root-inline-box">4.5.1. Applicable Properties</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-propdef-list-style-position"> <a href="https://drafts.csswg.org/css-lists-3/#propdef-list-style-position">https://drafts.csswg.org/css-lists-3/#propdef-list-style-position</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-propdef-list-style-position">4.7. Examples</a> <a href="#ref-for-propdef-list-style-position①">(2)</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-logical-property-group"> <a href="https://drafts.csswg.org/css-logical-1/#logical-property-group">https://drafts.csswg.org/css-logical-1/#logical-property-group</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-logical-property-group">7.3.4. Rolling Back Cascade Origins: the revert keyword</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-selectordef-after"> <a href="https://drafts.csswg.org/css-pseudo-4/#selectordef-after">https://drafts.csswg.org/css-pseudo-4/#selectordef-after</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-selectordef-after">4.5.1. Applicable Properties</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-selectordef-before"> <a href="https://drafts.csswg.org/css-pseudo-4/#selectordef-before">https://drafts.csswg.org/css-pseudo-4/#selectordef-before</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-selectordef-before">4.5.1. Applicable Properties</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-selectordef-first-line"> <a href="https://drafts.csswg.org/css-pseudo-4/#selectordef-first-line">https://drafts.csswg.org/css-pseudo-4/#selectordef-first-line</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-selectordef-first-line">4.8. Per-Fragment Value Processing</a> <a href="#ref-for-selectordef-first-line①">(2)</a> <a href="#ref-for-selectordef-first-line②">(3)</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-tree-abiding"> <a href="https://drafts.csswg.org/css-pseudo-4/#tree-abiding">https://drafts.csswg.org/css-pseudo-4/#tree-abiding</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-tree-abiding">4.8. Per-Fragment Value Processing</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-flat-tree"> <a href="https://drafts.csswg.org/css-scoping-1/#flat-tree">https://drafts.csswg.org/css-scoping-1/#flat-tree</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-flat-tree">4. Value Processing</a> <a href="#ref-for-flat-tree①">(2)</a> <li><a href="#ref-for-flat-tree②">7.2. Inheritance</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-flat-tree"> <a href="https://drafts.csswg.org/css-scoping-1/#flat-tree">https://drafts.csswg.org/css-scoping-1/#flat-tree</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-flat-tree">4. Value Processing</a> <a href="#ref-for-flat-tree①">(2)</a> <li><a href="#ref-for-flat-tree②">7.2. Inheritance</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-tree-context"> <a href="https://drafts.csswg.org/css-scoping-1/#tree-context">https://drafts.csswg.org/css-scoping-1/#tree-context</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-tree-context">6.1. Cascade Sorting Order</a> <a href="#ref-for-tree-context①">(2)</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-propdef-height"> <a href="https://drafts.csswg.org/css-sizing-3/#propdef-height">https://drafts.csswg.org/css-sizing-3/#propdef-height</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-propdef-height">4.7. Examples</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-propdef-width"> <a href="https://drafts.csswg.org/css-sizing-3/#propdef-width">https://drafts.csswg.org/css-sizing-3/#propdef-width</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-propdef-width">4.5. Used Values</a> <li><a href="#ref-for-propdef-width①">4.7. Examples</a> <a href="#ref-for-propdef-width②">(2)</a> <a href="#ref-for-propdef-width③">(3)</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-typedef-stylesheet"> <a href="https://drafts.csswg.org/css-syntax-3/#typedef-stylesheet">https://drafts.csswg.org/css-syntax-3/#typedef-stylesheet</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-typedef-stylesheet">6.4.4.1. Assigning Styles Inline: the @layer block at-rule</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-at-ruledef-charset"> <a href="https://drafts.csswg.org/css-syntax-3/#at-ruledef-charset">https://drafts.csswg.org/css-syntax-3/#at-ruledef-charset</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-at-ruledef-charset">2. Importing Style Sheets: the @import rule</a> <li><a href="#ref-for-at-ruledef-charset①">6.4.4.2. Declaring Without Styles: the @layer statement at-rule</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-at-rule"> <a href="https://drafts.csswg.org/css-syntax-3/#at-rule">https://drafts.csswg.org/css-syntax-3/#at-rule</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-at-rule">6.4. Cascade Layers</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-block-at-rule"> <a href="https://drafts.csswg.org/css-syntax-3/#block-at-rule">https://drafts.csswg.org/css-syntax-3/#block-at-rule</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-block-at-rule">6.4.4.1. Assigning Styles Inline: the @layer block at-rule</a> <a href="#ref-for-block-at-rule①">(2)</a> <li><a href="#ref-for-block-at-rule②">6.4.4.2. Declaring Without Styles: the @layer statement at-rule</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-declaration"> <a href="https://drafts.csswg.org/css-syntax-3/#declaration">https://drafts.csswg.org/css-syntax-3/#declaration</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-declaration">3. Shorthand Properties</a> <li><a href="#ref-for-declaration①">6. Cascading</a> <li><a href="#ref-for-declaration②">6.1. Cascade Sorting Order</a> <a href="#ref-for-declaration③">(2)</a> <a href="#ref-for-declaration④">(3)</a> <li><a href="#ref-for-declaration⑤">6.3. Important Declarations: the !important annotation</a> <a href="#ref-for-declaration⑥">(2)</a> <li><a href="#ref-for-declaration⑦">7.3.4. Rolling Back Cascade Origins: the revert keyword</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-environment-encoding"> <a href="https://drafts.csswg.org/css-syntax-3/#environment-encoding">https://drafts.csswg.org/css-syntax-3/#environment-encoding</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-environment-encoding">2.2. Processing Stylesheet Imports</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-css-property-declarations"> <a href="https://drafts.csswg.org/css-syntax-3/#css-property-declarations">https://drafts.csswg.org/css-syntax-3/#css-property-declarations</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-css-property-declarations">1. Introduction</a> <li><a href="#ref-for-css-property-declarations①">3. Shorthand Properties</a> <li><a href="#ref-for-css-property-declarations②">4.1. Declared Values</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-propdef-text-align"> <a href="https://drafts.csswg.org/css-text-3/#propdef-text-align">https://drafts.csswg.org/css-text-3/#propdef-text-align</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-propdef-text-align">4.7. Examples</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-propdef-text-indent"> <a href="https://drafts.csswg.org/css-text-4/#propdef-text-indent">https://drafts.csswg.org/css-text-4/#propdef-text-indent</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-propdef-text-indent">6.3. Important Declarations: the !important annotation</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-propdef-text-transform"> <a href="https://drafts.csswg.org/css-text-4/#propdef-text-transform">https://drafts.csswg.org/css-text-4/#propdef-text-transform</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-propdef-text-transform">4.5.1. Applicable Properties</a> <a href="#ref-for-propdef-text-transform①">(2)</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-ex"> <a href="https://drafts.csswg.org/css-values-3/#ex">https://drafts.csswg.org/css-values-3/#ex</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-ex">4.4. Computed Values</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-mult-comma"> <a href="https://drafts.csswg.org/css-values-4/#mult-comma">https://drafts.csswg.org/css-values-4/#mult-comma</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-mult-comma">6.4.4.2. Declaring Without Styles: the @layer statement at-rule</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-mult-zero-plus"> <a href="https://drafts.csswg.org/css-values-4/#mult-zero-plus">https://drafts.csswg.org/css-values-4/#mult-zero-plus</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-mult-zero-plus">6.4.2. Layer Naming and Nesting</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-typedef-ident"> <a href="https://drafts.csswg.org/css-values-4/#typedef-ident">https://drafts.csswg.org/css-values-4/#typedef-ident</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-typedef-ident">6.4.2. Layer Naming and Nesting</a> <a href="#ref-for-typedef-ident①">(2)</a> <a href="#ref-for-typedef-ident②">(3)</a> <a href="#ref-for-typedef-ident③">(4)</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-typedef-length-percentage"> <a href="https://drafts.csswg.org/css-values-4/#typedef-length-percentage">https://drafts.csswg.org/css-values-4/#typedef-length-percentage</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-typedef-length-percentage">1. Introduction</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-length-value"> <a href="https://drafts.csswg.org/css-values-4/#length-value">https://drafts.csswg.org/css-values-4/#length-value</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-length-value">4.5.1. Applicable Properties</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-string-value"> <a href="https://drafts.csswg.org/css-values-4/#string-value">https://drafts.csswg.org/css-values-4/#string-value</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-string-value">2. Importing Style Sheets: the @import rule</a> <a href="#ref-for-string-value①">(2)</a> <a href="#ref-for-string-value②">(3)</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-url-value"> <a href="https://drafts.csswg.org/css-values-4/#url-value">https://drafts.csswg.org/css-values-4/#url-value</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-url-value">2. Importing Style Sheets: the @import rule</a> <a href="#ref-for-url-value①">(2)</a> <a href="#ref-for-url-value②">(3)</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-mult-opt"> <a href="https://drafts.csswg.org/css-values-4/#mult-opt">https://drafts.csswg.org/css-values-4/#mult-opt</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-mult-opt">2. Importing Style Sheets: the @import rule</a> <a href="#ref-for-mult-opt①">(2)</a> <a href="#ref-for-mult-opt②">(3)</a> <li><a href="#ref-for-mult-opt③">6.4.4.1. Assigning Styles Inline: the @layer block at-rule</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-ch"> <a href="https://drafts.csswg.org/css-values-4/#ch">https://drafts.csswg.org/css-values-4/#ch</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-ch">4.5.1. Applicable Properties</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-css-css-identifier"> <a href="https://drafts.csswg.org/css-values-4/#css-css-identifier">https://drafts.csswg.org/css-values-4/#css-css-identifier</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-css-css-identifier">6.4.2. Layer Naming and Nesting</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-css-wide-keywords"> <a href="https://drafts.csswg.org/css-values-4/#css-wide-keywords">https://drafts.csswg.org/css-values-4/#css-wide-keywords</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-css-wide-keywords">4.3. Specified Values</a> <li><a href="#ref-for-css-wide-keywords①">6.4.2. Layer Naming and Nesting</a> <li><a href="#ref-for-css-wide-keywords②">7.3. Explicit Defaulting</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-em"> <a href="https://drafts.csswg.org/css-values-4/#em">https://drafts.csswg.org/css-values-4/#em</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-em">4.4. Computed Values</a> <li><a href="#ref-for-em①">4.8. Per-Fragment Value Processing</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-funcdef-url"> <a href="https://drafts.csswg.org/css-values-4/#funcdef-url">https://drafts.csswg.org/css-values-4/#funcdef-url</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-funcdef-url">2. Importing Style Sheets: the @import rule</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-valdef-length-vh"> <a href="https://drafts.csswg.org/css-values-4/#valdef-length-vh">https://drafts.csswg.org/css-values-4/#valdef-length-vh</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-valdef-length-vh">4.4. Computed Values</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-valdef-length-vw"> <a href="https://drafts.csswg.org/css-values-4/#valdef-length-vw">https://drafts.csswg.org/css-values-4/#valdef-length-vw</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-valdef-length-vw">4.4. Computed Values</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-comb-one"> <a href="https://drafts.csswg.org/css-values-4/#comb-one">https://drafts.csswg.org/css-values-4/#comb-one</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-comb-one">2. Importing Style Sheets: the @import rule</a> <a href="#ref-for-comb-one①">(2)</a> <a href="#ref-for-comb-one②">(3)</a> <li><a href="#ref-for-comb-one③">3.2. Resetting All Properties: the all property</a> <a href="#ref-for-comb-one④">(2)</a> <a href="#ref-for-comb-one⑤">(3)</a> <a href="#ref-for-comb-one⑥">(4)</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-custom-property"> <a href="https://drafts.csswg.org/css-variables-1/#custom-property">https://drafts.csswg.org/css-variables-1/#custom-property</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-custom-property">3.2. Resetting All Properties: the all property</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-propdef-direction"> <a href="https://drafts.csswg.org/css-writing-modes-3/#propdef-direction">https://drafts.csswg.org/css-writing-modes-3/#propdef-direction</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-propdef-direction">3.2. Resetting All Properties: the all property</a> <a href="#ref-for-propdef-direction①">(2)</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-propdef-unicode-bidi"> <a href="https://drafts.csswg.org/css-writing-modes-3/#propdef-unicode-bidi">https://drafts.csswg.org/css-writing-modes-3/#propdef-unicode-bidi</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-propdef-unicode-bidi">3.2. Resetting All Properties: the all property</a> <a href="#ref-for-propdef-unicode-bidi①">(2)</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-propdef-text-orientation"> <a href="https://drafts.csswg.org/css-writing-modes-4/#propdef-text-orientation">https://drafts.csswg.org/css-writing-modes-4/#propdef-text-orientation</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-propdef-text-orientation">4.5.1. Applicable Properties</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-propdef-writing-mode"> <a href="https://drafts.csswg.org/css-writing-modes-4/#propdef-writing-mode">https://drafts.csswg.org/css-writing-modes-4/#propdef-writing-mode</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-propdef-writing-mode">4.5.1. Applicable Properties</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-propdef-line-height"> <a href="https://drafts.csswg.org/css2/#propdef-line-height">https://drafts.csswg.org/css2/#propdef-line-height</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-propdef-line-height">3. Shorthand Properties</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-propdef-page-break-after"> <a href="https://drafts.csswg.org/css2/#propdef-page-break-after">https://drafts.csswg.org/css2/#propdef-page-break-after</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-propdef-page-break-after">4.6. Actual Values</a> <li><a href="#ref-for-propdef-page-break-after①">4.7. Examples</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-propdef-page-break-before"> <a href="https://drafts.csswg.org/css2/#propdef-page-break-before">https://drafts.csswg.org/css2/#propdef-page-break-before</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-propdef-page-break-before">3.1. Property Aliasing</a> <a href="#ref-for-propdef-page-break-before①">(2)</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-cssgroupingrule"> <a href="https://drafts.csswg.org/cssom-1/#cssgroupingrule">https://drafts.csswg.org/cssom-1/#cssgroupingrule</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-cssgroupingrule">8.2. The CSSLayerBlockRule interface</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-cssimportrule"> <a href="https://drafts.csswg.org/cssom-1/#cssimportrule">https://drafts.csswg.org/cssom-1/#cssimportrule</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-cssimportrule">8.1. Extensions to the CSSImportRule interface</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-cssomstring"> <a href="https://drafts.csswg.org/cssom-1/#cssomstring">https://drafts.csswg.org/cssom-1/#cssomstring</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-cssomstring">8.1. Extensions to the CSSImportRule interface</a> <li><a href="#ref-for-cssomstring①">8.2. The CSSLayerBlockRule interface</a> <li><a href="#ref-for-cssomstring②">8.3. The CSSLayerStatementRule interface</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-cssrule"> <a href="https://drafts.csswg.org/cssom-1/#cssrule">https://drafts.csswg.org/cssom-1/#cssrule</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-cssrule">8.3. The CSSLayerStatementRule interface</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-cssstyledeclaration-declarations"> <a href="https://drafts.csswg.org/cssom-1/#cssstyledeclaration-declarations">https://drafts.csswg.org/cssom-1/#cssstyledeclaration-declarations</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-cssstyledeclaration-declarations">1. Introduction</a> <a href="#ref-for-cssstyledeclaration-declarations①">(2)</a> <a href="#ref-for-cssstyledeclaration-declarations②">(3)</a> <li><a href="#ref-for-cssstyledeclaration-declarations③">2. Importing Style Sheets: the @import rule</a> <li><a href="#ref-for-cssstyledeclaration-declarations④">3. Shorthand Properties</a> <li><a href="#ref-for-cssstyledeclaration-declarations⑤">4. Value Processing</a> <li><a href="#ref-for-cssstyledeclaration-declarations⑥">5. Filtering</a> <a href="#ref-for-cssstyledeclaration-declarations⑦">(2)</a> <li><a href="#ref-for-cssstyledeclaration-declarations⑧">6.1. Cascade Sorting Order</a> <a href="#ref-for-cssstyledeclaration-declarations⑨">(2)</a> <a href="#ref-for-cssstyledeclaration-declarations①⓪">(3)</a> <a href="#ref-for-cssstyledeclaration-declarations①①">(4)</a> <li><a href="#ref-for-cssstyledeclaration-declarations①②">7.3.5. Rolling Back Cascade Layers: the revert-layer keyword</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-dom-window-getcomputedstyle"> <a href="https://drafts.csswg.org/cssom-1/#dom-window-getcomputedstyle">https://drafts.csswg.org/cssom-1/#dom-window-getcomputedstyle</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-dom-window-getcomputedstyle">4.4. Computed Values</a> <li><a href="#ref-for-dom-window-getcomputedstyle①">4.8. Per-Fragment Value Processing</a> <a href="#ref-for-dom-window-getcomputedstyle②">(2)</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-connected"> <a href="https://dom.spec.whatwg.org/#connected">https://dom.spec.whatwg.org/#connected</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-connected">4. Value Processing</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-concept-light-tree"> <a href="https://dom.spec.whatwg.org/#concept-light-tree">https://dom.spec.whatwg.org/#concept-light-tree</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-concept-light-tree">7.2. Inheritance</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-concept-document-quirks"> <a href="https://dom.spec.whatwg.org/#concept-document-quirks">https://dom.spec.whatwg.org/#concept-document-quirks</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-concept-document-quirks">2.3. Content-Type of CSS Style Sheets</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-concept-shadow-tree"> <a href="https://dom.spec.whatwg.org/#concept-shadow-tree">https://dom.spec.whatwg.org/#concept-shadow-tree</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-concept-shadow-tree">6.1. Cascade Sorting Order</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-concept-shadow-including-tree-order"> <a href="https://dom.spec.whatwg.org/#concept-shadow-including-tree-order">https://dom.spec.whatwg.org/#concept-shadow-including-tree-order</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-concept-shadow-including-tree-order">6.1. Cascade Sorting Order</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-cors-protocol"> <a href="https://fetch.spec.whatwg.org/#cors-protocol">https://fetch.spec.whatwg.org/#cors-protocol</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-cors-protocol"> Privacy and Security Considerations</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-concept-response"> <a href="https://fetch.spec.whatwg.org/#concept-response">https://fetch.spec.whatwg.org/#concept-response</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-concept-response">2.3. Content-Type of CSS Style Sheets</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-concept-response-url"> <a href="https://fetch.spec.whatwg.org/#concept-response-url">https://fetch.spec.whatwg.org/#concept-response-url</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-concept-response-url">2.3. Content-Type of CSS Style Sheets</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-audio"> <a href="https://html.spec.whatwg.org/multipage/media.html#audio">https://html.spec.whatwg.org/multipage/media.html#audio</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-audio">6.4. Cascade Layers</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-content-type"> <a href="https://html.spec.whatwg.org/multipage/urls-and-fetching.html#content-type">https://html.spec.whatwg.org/multipage/urls-and-fetching.html#content-type</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-content-type">2.3. Content-Type of CSS Style Sheets</a> <a href="#ref-for-content-type①">(2)</a> <li><a href="#termref-for-content-type"> Privacy and Security Considerations</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-the-div-element"> <a href="https://html.spec.whatwg.org/multipage/grouping-content.html#the-div-element">https://html.spec.whatwg.org/multipage/grouping-content.html#the-div-element</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-the-div-element">4.8. Per-Fragment Value Processing</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-the-p-element"> <a href="https://html.spec.whatwg.org/multipage/grouping-content.html#the-p-element">https://html.spec.whatwg.org/multipage/grouping-content.html#the-p-element</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-the-p-element">4.5.1. Applicable Properties</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-the-s-element"> <a href="https://html.spec.whatwg.org/multipage/text-level-semantics.html#the-s-element">https://html.spec.whatwg.org/multipage/text-level-semantics.html#the-s-element</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-the-s-element">6.5. Precedence of Non-CSS Presentational Hints</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-same-origin"> <a href="https://html.spec.whatwg.org/multipage/origin.html#same-origin">https://html.spec.whatwg.org/multipage/origin.html#same-origin</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-same-origin">2.3. Content-Type of CSS Style Sheets</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-the-slot-element"> <a href="https://html.spec.whatwg.org/multipage/scripting.html#the-slot-element">https://html.spec.whatwg.org/multipage/scripting.html#the-slot-element</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-the-slot-element">7.2. Inheritance</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-the-span-element"> <a href="https://html.spec.whatwg.org/multipage/text-level-semantics.html#the-span-element">https://html.spec.whatwg.org/multipage/text-level-semantics.html#the-span-element</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-the-span-element">4.8. Per-Fragment Value Processing</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-typedef-media-query-list"> <a href="https://drafts.csswg.org/mediaqueries-4/#typedef-media-query-list">https://drafts.csswg.org/mediaqueries-4/#typedef-media-query-list</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-typedef-media-query-list">2. Importing Style Sheets: the @import rule</a> <li><a href="#ref-for-typedef-media-query-list①">2.1. Conditional @import Rules</a> <a href="#ref-for-typedef-media-query-list②">(2)</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-typedef-media-query"> <a href="https://drafts.csswg.org/mediaqueries-4/#typedef-media-query">https://drafts.csswg.org/mediaqueries-4/#typedef-media-query</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-typedef-media-query">1.1. Module Interactions</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-media-query-list"> <a href="https://drafts.csswg.org/mediaqueries-4/#media-query-list">https://drafts.csswg.org/mediaqueries-4/#media-query-list</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-media-query-list">2.1. Conditional @import Rules</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-pseudo-element"> <a href="https://drafts.csswg.org/selectors-4/#pseudo-element">https://drafts.csswg.org/selectors-4/#pseudo-element</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-pseudo-element">4.5.1. Applicable Properties</a> <a href="#ref-for-pseudo-element①">(2)</a> <li><a href="#ref-for-pseudo-element②">4.8. Per-Fragment Value Processing</a> <li><a href="#ref-for-pseudo-element③">7.2. Inheritance</a> <a href="#ref-for-pseudo-element④">(2)</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-Exposed"> <a href="https://webidl.spec.whatwg.org/#Exposed">https://webidl.spec.whatwg.org/#Exposed</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-Exposed">8.2. The CSSLayerBlockRule interface</a> <li><a href="#ref-for-Exposed①">8.3. The CSSLayerStatementRule interface</a> </ul> </aside> <aside class="dfn-panel" data-for="term-for-idl-frozen-array"> <a href="https://webidl.spec.whatwg.org/#idl-frozen-array">https://webidl.spec.whatwg.org/#idl-frozen-array</a><b>Referenced in:</b> <ul> <li><a href="#ref-for-idl-frozen-array">8.3. The CSSLayerStatementRule interface</a> </ul> </aside> <h3 class="no-num no-ref heading settled" id="index-defined-elsewhere"><span class="content">Terms defined by reference</span><a class="self-link" href="#index-defined-elsewhere"></a></h3> <ul class="index"> <li> <a data-link-type="biblio">[CSS-2021]</a> defines the following terms: <ul> <li><span class="dfn-paneled" id="term-for-vendor-prefix">vendor-prefixed</span> </ul> <li> <a data-link-type="biblio">[CSS-ALIGN-3]</a> defines the following terms: <ul> <li><span class="dfn-paneled" id="term-for-valdef-justify-self-auto">auto</span> </ul> <li> <a data-link-type="biblio">[CSS-ANIMATIONS-1]</a> defines the following terms: <ul> <li><span class="dfn-paneled" id="term-for-at-ruledef-keyframes">@keyframes</span> </ul> <li> <a data-link-type="biblio">[CSS-BACKGROUNDS-3]</a> defines the following terms: <ul> <li><span class="dfn-paneled" id="term-for-propdef-background">background</span> <li><span class="dfn-paneled" id="term-for-propdef-background-color">background-color</span> <li><span class="dfn-paneled" id="term-for-propdef-background-image">background-image</span> <li><span class="dfn-paneled" id="term-for-propdef-border">border</span> <li><span class="dfn-paneled" id="term-for-propdef-border-bottom-width">border-bottom-width</span> <li><span class="dfn-paneled" id="term-for-propdef-border-color">border-color</span> <li><span class="dfn-paneled" id="term-for-propdef-border-image">border-image</span> <li><span class="dfn-paneled" id="term-for-propdef-border-left-width">border-left-width</span> <li><span class="dfn-paneled" id="term-for-propdef-border-right-width">border-right-width</span> <li><span class="dfn-paneled" id="term-for-propdef-border-style">border-style</span> <li><span class="dfn-paneled" id="term-for-propdef-border-top-width">border-top-width</span> <li><span class="dfn-paneled" id="term-for-valdef-line-style-dotted">dotted</span> </ul> <li> <a data-link-type="biblio">[CSS-BREAK-3]</a> defines the following terms: <ul> <li><span class="dfn-paneled" id="term-for-propdef-break-before">break-before</span> <li><span class="dfn-paneled" id="term-for-propdef-orphans">orphans</span> </ul> <li> <a data-link-type="biblio">[CSS-BREAK-4]</a> defines the following terms: <ul> <li><span class="dfn-paneled" id="term-for-box-fragment">box fragment</span> <li><span class="dfn-paneled" id="term-for-valdef-break-before-page">page</span> </ul> <li> <a data-link-type="biblio">[CSS-COLOR-4]</a> defines the following terms: <ul> <li><span class="dfn-paneled" id="term-for-typedef-color"><color></span> <li><span class="dfn-paneled" id="term-for-propdef-color">color</span> <li><span class="dfn-paneled" id="term-for-valdef-color-currentcolor">currentcolor</span> <li><span class="dfn-paneled" id="term-for-valdef-color-red">red</span> </ul> <li> <a data-link-type="biblio">[CSS-CONDITIONAL-3]</a> defines the following terms: <ul> <li><span class="dfn-paneled" id="term-for-typedef-supports-condition"><supports-condition></span> <li><span class="dfn-paneled" id="term-for-typedef-supports-decl"><supports-decl></span> <li><span class="dfn-paneled" id="term-for-at-ruledef-media">@media</span> <li><span class="dfn-paneled" id="term-for-at-ruledef-supports">@supports</span> <li><span class="dfn-paneled" id="term-for-conditional-group-rule">conditional group rule</span> </ul> <li> <a data-link-type="biblio">[CSS-CONDITIONAL-5]</a> defines the following terms: <ul> <li><span class="dfn-paneled" id="term-for-funcdef-supports">supports()</span> </ul> <li> <a data-link-type="biblio">[CSS-CONTAIN-2]</a> defines the following terms: <ul> <li><span class="dfn-paneled" id="term-for-valdef-contain-layout">layout</span> </ul> <li> <a data-link-type="biblio">[CSS-DISPLAY-3]</a> defines the following terms: <ul> <li><span class="dfn-paneled" id="term-for-box">box</span> <li><span class="dfn-paneled" id="term-for-propdef-display">display</span> <li><span class="dfn-paneled" id="term-for-display-type">display type</span> <li><span class="dfn-paneled" id="term-for-elements">element</span> <li><span class="dfn-paneled" id="term-for-inline-box">inline box</span> <li><span class="dfn-paneled" id="term-for-text-nodes">text node</span> </ul> <li> <a data-link-type="biblio">[CSS-FLEXBOX-1]</a> defines the following terms: <ul> <li><span class="dfn-paneled" id="term-for-propdef-flex">flex</span> <li><span class="dfn-paneled" id="term-for-flex-item">flex item</span> </ul> <li> <a data-link-type="biblio">[CSS-FONTS-4]</a> defines the following terms: <ul> <li><span class="dfn-paneled" id="term-for-valdef-font-weight-bolder">bolder</span> <li><span class="dfn-paneled" id="term-for-propdef-font">font</span> <li><span class="dfn-paneled" id="term-for-propdef-font-family">font-family</span> <li><span class="dfn-paneled" id="term-for-propdef-font-size">font-size</span> <li><span class="dfn-paneled" id="term-for-propdef-font-style">font-style</span> <li><span class="dfn-paneled" id="term-for-propdef-font-variant">font-variant</span> <li><span class="dfn-paneled" id="term-for-propdef-font-weight">font-weight</span> <li><span class="dfn-paneled" id="term-for-valdef-font-style-italic">italic</span> <li><span class="dfn-paneled" id="term-for-valdef-font-family-sans-serif">sans-serif</span> </ul> <li> <a data-link-type="biblio">[CSS-FONTS-5]</a> defines the following terms: <ul> <li><span class="dfn-paneled" id="term-for-at-font-face-rule">@font-face</span> <li><span class="dfn-paneled" id="term-for-propdef-font-size-adjust">font-size-adjust</span> </ul> <li> <a data-link-type="biblio">[CSS-INLINE-3]</a> defines the following terms: <ul> <li><span class="dfn-paneled" id="term-for-root-inline-box">root inline box</span> </ul> <li> <a data-link-type="biblio">[CSS-LISTS-3]</a> defines the following terms: <ul> <li><span class="dfn-paneled" id="term-for-propdef-list-style-position">list-style-position</span> </ul> <li> <a data-link-type="biblio">[CSS-LOGICAL-1]</a> defines the following terms: <ul> <li><span class="dfn-paneled" id="term-for-logical-property-group">logical property group</span> </ul> <li> <a data-link-type="biblio">[CSS-PSEUDO-4]</a> defines the following terms: <ul> <li><span class="dfn-paneled" id="term-for-selectordef-after">::after</span> <li><span class="dfn-paneled" id="term-for-selectordef-before">::before</span> <li><span class="dfn-paneled" id="term-for-selectordef-first-line">::first-line</span> <li><span class="dfn-paneled" id="term-for-tree-abiding">tree-abiding</span> </ul> <li> <a data-link-type="biblio">[CSS-SCOPING-1]</a> defines the following terms: <ul> <li><span class="dfn-paneled" id="term-for-flat-tree">flat tree</span> <li><span class="dfn-paneled" id="term-for-flat-tree①">flattened element tree</span> <li><span class="dfn-paneled" id="term-for-tree-context">tree context</span> </ul> <li> <a data-link-type="biblio">[CSS-SIZING-3]</a> defines the following terms: <ul> <li><span class="dfn-paneled" id="term-for-propdef-height">height</span> <li><span class="dfn-paneled" id="term-for-propdef-width">width</span> </ul> <li> <a data-link-type="biblio">[CSS-SYNTAX-3]</a> defines the following terms: <ul> <li><span class="dfn-paneled" id="term-for-typedef-stylesheet"><stylesheet></span> <li><span class="dfn-paneled" id="term-for-at-ruledef-charset">@charset</span> <li><span class="dfn-paneled" id="term-for-at-rule">at-rule</span> <li><span class="dfn-paneled" id="term-for-block-at-rule">block at-rule</span> <li><span class="dfn-paneled" id="term-for-declaration">declaration</span> <li><span class="dfn-paneled" id="term-for-environment-encoding">environment encoding</span> <li><span class="dfn-paneled" id="term-for-css-property-declarations">property declarations</span> </ul> <li> <a data-link-type="biblio">[CSS-TEXT-3]</a> defines the following terms: <ul> <li><span class="dfn-paneled" id="term-for-propdef-text-align">text-align</span> </ul> <li> <a data-link-type="biblio">[CSS-TEXT-4]</a> defines the following terms: <ul> <li><span class="dfn-paneled" id="term-for-propdef-text-indent">text-indent</span> <li><span class="dfn-paneled" id="term-for-propdef-text-transform">text-transform</span> </ul> <li> <a data-link-type="biblio">[CSS-VALUES-3]</a> defines the following terms: <ul> <li><span class="dfn-paneled" id="term-for-ex">ex</span> </ul> <li> <a data-link-type="biblio">[CSS-VALUES-4]</a> defines the following terms: <ul> <li><span class="dfn-paneled" id="term-for-mult-comma">#</span> <li><span class="dfn-paneled" id="term-for-mult-zero-plus">*</span> <li><span class="dfn-paneled" id="term-for-typedef-ident"><ident></span> <li><span class="dfn-paneled" id="term-for-typedef-length-percentage"><length-percentage></span> <li><span class="dfn-paneled" id="term-for-length-value"><length></span> <li><span class="dfn-paneled" id="term-for-string-value"><string></span> <li><span class="dfn-paneled" id="term-for-url-value"><url></span> <li><span class="dfn-paneled" id="term-for-mult-opt">?</span> <li><span class="dfn-paneled" id="term-for-ch">ch</span> <li><span class="dfn-paneled" id="term-for-css-css-identifier">css identifier</span> <li><span class="dfn-paneled" id="term-for-css-wide-keywords">css-wide keywords</span> <li><span class="dfn-paneled" id="term-for-em">em</span> <li><span class="dfn-paneled" id="term-for-funcdef-url">url()</span> <li><span class="dfn-paneled" id="term-for-valdef-length-vh">vh</span> <li><span class="dfn-paneled" id="term-for-valdef-length-vw">vw</span> <li><span class="dfn-paneled" id="term-for-comb-one">|</span> </ul> <li> <a data-link-type="biblio">[CSS-VARIABLES-1]</a> defines the following terms: <ul> <li><span class="dfn-paneled" id="term-for-custom-property">custom property</span> </ul> <li> <a data-link-type="biblio">[CSS-WRITING-MODES-3]</a> defines the following terms: <ul> <li><span class="dfn-paneled" id="term-for-propdef-direction">direction</span> <li><span class="dfn-paneled" id="term-for-propdef-unicode-bidi">unicode-bidi</span> </ul> <li> <a data-link-type="biblio">[CSS-WRITING-MODES-4]</a> defines the following terms: <ul> <li><span class="dfn-paneled" id="term-for-propdef-text-orientation">text-orientation</span> <li><span class="dfn-paneled" id="term-for-propdef-writing-mode">writing-mode</span> </ul> <li> <a data-link-type="biblio">[CSS2]</a> defines the following terms: <ul> <li><span class="dfn-paneled" id="term-for-propdef-line-height">line-height</span> <li><span class="dfn-paneled" id="term-for-propdef-page-break-after">page-break-after</span> <li><span class="dfn-paneled" id="term-for-propdef-page-break-before">page-break-before</span> </ul> <li> <a data-link-type="biblio">[CSSOM]</a> defines the following terms: <ul> <li><span class="dfn-paneled" id="term-for-cssgroupingrule">CSSGroupingRule</span> <li><span class="dfn-paneled" id="term-for-cssimportrule">CSSImportRule</span> <li><span class="dfn-paneled" id="term-for-cssomstring">CSSOMString</span> <li><span class="dfn-paneled" id="term-for-cssrule">CSSRule</span> <li><span class="dfn-paneled" id="term-for-cssstyledeclaration-declarations">declarations</span> <li><span class="dfn-paneled" id="term-for-dom-window-getcomputedstyle">getComputedStyle(elt)</span> </ul> <li> <a data-link-type="biblio">[DOM]</a> defines the following terms: <ul> <li><span class="dfn-paneled" id="term-for-connected">connected</span> <li><span class="dfn-paneled" id="term-for-concept-light-tree">light tree</span> <li><span class="dfn-paneled" id="term-for-concept-document-quirks">quirks mode</span> <li><span class="dfn-paneled" id="term-for-concept-shadow-tree">shadow tree</span> <li><span class="dfn-paneled" id="term-for-concept-shadow-including-tree-order">shadow-including tree order</span> </ul> <li> <a data-link-type="biblio">[FETCH]</a> defines the following terms: <ul> <li><span class="dfn-paneled" id="term-for-cors-protocol">cors protocol</span> <li><span class="dfn-paneled" id="term-for-concept-response">response</span> <li><span class="dfn-paneled" id="term-for-concept-response-url">url</span> </ul> <li> <a data-link-type="biblio">[HTML]</a> defines the following terms: <ul> <li><span class="dfn-paneled" id="term-for-audio">audio</span> <li><span class="dfn-paneled" id="term-for-content-type">content-type metadata</span> <li><span class="dfn-paneled" id="term-for-the-div-element">div</span> <li><span class="dfn-paneled" id="term-for-the-p-element">p</span> <li><span class="dfn-paneled" id="term-for-the-s-element">s</span> <li><span class="dfn-paneled" id="term-for-same-origin">same origin</span> <li><span class="dfn-paneled" id="term-for-the-slot-element">slot</span> <li><span class="dfn-paneled" id="term-for-the-span-element">span</span> </ul> <li> <a data-link-type="biblio">[MEDIAQ]</a> defines the following terms: <ul> <li><span class="dfn-paneled" id="term-for-typedef-media-query-list"><media-query-list></span> <li><span class="dfn-paneled" id="term-for-typedef-media-query"><media-query></span> <li><span class="dfn-paneled" id="term-for-media-query-list">media query list</span> </ul> <li> <a data-link-type="biblio">[SELECTORS-4]</a> defines the following terms: <ul> <li><span class="dfn-paneled" id="term-for-pseudo-element">pseudo-element</span> </ul> <li> <a data-link-type="biblio">[WEBIDL]</a> defines the following terms: <ul> <li><span class="dfn-paneled" id="term-for-Exposed">Exposed</span> <li><span class="dfn-paneled" id="term-for-idl-frozen-array">FrozenArray</span> </ul> </ul> <h2 class="no-num no-ref heading settled" id="references"><span class="content">References</span><a class="self-link" href="#references"></a></h2> <h3 class="no-num no-ref heading settled" id="normative"><span class="content">Normative References</span><a class="self-link" href="#normative"></a></h3> <dl> <dt id="biblio-css-2021">[CSS-2021] <dd>Tab Atkins Jr.; Elika Etemad; Florian Rivoal. <a href="https://drafts.csswg.org/css-2021/"><cite>CSS Snapshot 2021</cite></a>. URL: <a href="https://drafts.csswg.org/css-2021/">https://drafts.csswg.org/css-2021/</a> <dt id="biblio-css-animations-1">[CSS-ANIMATIONS-1] <dd>Dean Jackson; et al. <a href="https://drafts.csswg.org/css-animations/"><cite>CSS Animations Level 1</cite></a>. URL: <a href="https://drafts.csswg.org/css-animations/">https://drafts.csswg.org/css-animations/</a> <dt id="biblio-css-backgrounds-3">[CSS-BACKGROUNDS-3] <dd>Bert Bos; Elika Etemad; Brad Kemper. <a href="https://drafts.csswg.org/css-backgrounds/"><cite>CSS Backgrounds and Borders Module Level 3</cite></a>. URL: <a href="https://drafts.csswg.org/css-backgrounds/">https://drafts.csswg.org/css-backgrounds/</a> <dt id="biblio-css-break-4">[CSS-BREAK-4] <dd>Rossen Atanassov; Elika Etemad. <a href="https://drafts.csswg.org/css-break-4/"><cite>CSS Fragmentation Module Level 4</cite></a>. URL: <a href="https://drafts.csswg.org/css-break-4/">https://drafts.csswg.org/css-break-4/</a> <dt id="biblio-css-color-4">[CSS-COLOR-4] <dd>Tab Atkins Jr.; Chris Lilley; Lea Verou. <a href="https://drafts.csswg.org/css-color/"><cite>CSS Color Module Level 4</cite></a>. URL: <a href="https://drafts.csswg.org/css-color/">https://drafts.csswg.org/css-color/</a> <dt id="biblio-css-conditional-3">[CSS-CONDITIONAL-3] <dd>David Baron; Elika Etemad; Chris Lilley. <a href="https://drafts.csswg.org/css-conditional-3/"><cite>CSS Conditional Rules Module Level 3</cite></a>. URL: <a href="https://drafts.csswg.org/css-conditional-3/">https://drafts.csswg.org/css-conditional-3/</a> <dt id="biblio-css-conditional-5">[CSS-CONDITIONAL-5] <dd>David Baron; Elika Etemad; Chris Lilley. <a href="https://drafts.csswg.org/css-conditional-5/"><cite>CSS Conditional Rules Module Level 5</cite></a>. URL: <a href="https://drafts.csswg.org/css-conditional-5/">https://drafts.csswg.org/css-conditional-5/</a> <dt id="biblio-css-display-3">[CSS-DISPLAY-3] <dd>Tab Atkins Jr.; Elika Etemad. <a href="https://drafts.csswg.org/css-display/"><cite>CSS Display Module Level 3</cite></a>. URL: <a href="https://drafts.csswg.org/css-display/">https://drafts.csswg.org/css-display/</a> <dt id="biblio-css-fonts-4">[CSS-FONTS-4] <dd>John Daggett; Myles Maxfield; Chris Lilley. <a href="https://drafts.csswg.org/css-fonts-4/"><cite>CSS Fonts Module Level 4</cite></a>. URL: <a href="https://drafts.csswg.org/css-fonts-4/">https://drafts.csswg.org/css-fonts-4/</a> <dt id="biblio-css-fonts-5">[CSS-FONTS-5] <dd>Myles Maxfield; Chris Lilley. <a href="https://drafts.csswg.org/css-fonts-5/"><cite>CSS Fonts Module Level 5</cite></a>. URL: <a href="https://drafts.csswg.org/css-fonts-5/">https://drafts.csswg.org/css-fonts-5/</a> <dt id="biblio-css-pseudo-4">[CSS-PSEUDO-4] <dd>CSS Pseudo-Elements Module Level 4 URL: <a href="https://www.w3.org/TR/css-pseudo-4/">https://www.w3.org/TR/css-pseudo-4/</a> <dt id="biblio-css-scoping-1">[CSS-SCOPING-1] <dd>Tab Atkins Jr.; Elika Etemad. <a href="https://drafts.csswg.org/css-scoping/"><cite>CSS Scoping Module Level 1</cite></a>. URL: <a href="https://drafts.csswg.org/css-scoping/">https://drafts.csswg.org/css-scoping/</a> <dt id="biblio-css-syntax-3">[CSS-SYNTAX-3] <dd>Tab Atkins Jr.; Simon Sapin. <a href="https://drafts.csswg.org/css-syntax/"><cite>CSS Syntax Module Level 3</cite></a>. URL: <a href="https://drafts.csswg.org/css-syntax/">https://drafts.csswg.org/css-syntax/</a> <dt id="biblio-css-transitions-1">[CSS-TRANSITIONS-1] <dd>David Baron; et al. <a href="https://drafts.csswg.org/css-transitions/"><cite>CSS Transitions</cite></a>. URL: <a href="https://drafts.csswg.org/css-transitions/">https://drafts.csswg.org/css-transitions/</a> <dt id="biblio-css-values-3">[CSS-VALUES-3] <dd>Tab Atkins Jr.; Elika Etemad. <a href="https://drafts.csswg.org/css-values-3/"><cite>CSS Values and Units Module Level 3</cite></a>. URL: <a href="https://drafts.csswg.org/css-values-3/">https://drafts.csswg.org/css-values-3/</a> <dt id="biblio-css-values-4">[CSS-VALUES-4] <dd>Tab Atkins Jr.; Elika Etemad. <a href="https://drafts.csswg.org/css-values-4/"><cite>CSS Values and Units Module Level 4</cite></a>. URL: <a href="https://drafts.csswg.org/css-values-4/">https://drafts.csswg.org/css-values-4/</a> <dt id="biblio-css-variables-1">[CSS-VARIABLES-1] <dd>Tab Atkins Jr.. <a href="https://drafts.csswg.org/css-variables/"><cite>CSS Custom Properties for Cascading Variables Module Level 1</cite></a>. URL: <a href="https://drafts.csswg.org/css-variables/">https://drafts.csswg.org/css-variables/</a> <dt id="biblio-css-writing-modes-3">[CSS-WRITING-MODES-3] <dd>Elika Etemad; Koji Ishii. <a href="https://drafts.csswg.org/css-writing-modes-3/"><cite>CSS Writing Modes Level 3</cite></a>. URL: <a href="https://drafts.csswg.org/css-writing-modes-3/">https://drafts.csswg.org/css-writing-modes-3/</a> <dt id="biblio-css2">[CSS2] <dd>Bert Bos; et al. <a href="https://drafts.csswg.org/css2/"><cite>Cascading Style Sheets Level 2 Revision 1 (CSS 2.1) Specification</cite></a>. URL: <a href="https://drafts.csswg.org/css2/">https://drafts.csswg.org/css2/</a> <dt id="biblio-cssom">[CSSOM] <dd>Daniel Glazman; Emilio Cobos Álvarez. <a href="https://drafts.csswg.org/cssom/"><cite>CSS Object Model (CSSOM)</cite></a>. URL: <a href="https://drafts.csswg.org/cssom/">https://drafts.csswg.org/cssom/</a> <dt id="biblio-cssstyleattr">[CSSSTYLEATTR] <dd>Tantek Çelik; Elika Etemad. <a href="https://drafts.csswg.org/css-style-attr/"><cite>CSS Style Attributes</cite></a>. URL: <a href="https://drafts.csswg.org/css-style-attr/">https://drafts.csswg.org/css-style-attr/</a> <dt id="biblio-dom">[DOM] <dd>Anne van Kesteren. <a href="https://dom.spec.whatwg.org/"><cite>DOM Standard</cite></a>. Living Standard. URL: <a href="https://dom.spec.whatwg.org/">https://dom.spec.whatwg.org/</a> <dt id="biblio-fetch">[FETCH] <dd>Anne van Kesteren. <a href="https://fetch.spec.whatwg.org/"><cite>Fetch Standard</cite></a>. Living Standard. URL: <a href="https://fetch.spec.whatwg.org/">https://fetch.spec.whatwg.org/</a> <dt id="biblio-html">[HTML] <dd>Anne van Kesteren; et al. <a href="https://html.spec.whatwg.org/multipage/"><cite>HTML Standard</cite></a>. Living Standard. URL: <a href="https://html.spec.whatwg.org/multipage/">https://html.spec.whatwg.org/multipage/</a> <dt id="biblio-mediaq">[MEDIAQ] <dd>Florian Rivoal; Tab Atkins Jr.. <a href="https://drafts.csswg.org/mediaqueries-4/"><cite>Media Queries Level 4</cite></a>. URL: <a href="https://drafts.csswg.org/mediaqueries-4/">https://drafts.csswg.org/mediaqueries-4/</a> <dt id="biblio-rfc2119">[RFC2119] <dd>S. Bradner. <a href="https://datatracker.ietf.org/doc/html/rfc2119"><cite>Key words for use in RFCs to Indicate Requirement Levels</cite></a>. March 1997. Best Current Practice. URL: <a href="https://datatracker.ietf.org/doc/html/rfc2119">https://datatracker.ietf.org/doc/html/rfc2119</a> <dt id="biblio-select">[SELECT] <dd>Tantek Çelik; et al. <a href="https://drafts.csswg.org/selectors-3/"><cite>Selectors Level 3</cite></a>. URL: <a href="https://drafts.csswg.org/selectors-3/">https://drafts.csswg.org/selectors-3/</a> <dt id="biblio-selectors-4">[SELECTORS-4] <dd>Elika Etemad; Tab Atkins Jr.. <a href="https://drafts.csswg.org/selectors/"><cite>Selectors Level 4</cite></a>. URL: <a href="https://drafts.csswg.org/selectors/">https://drafts.csswg.org/selectors/</a> <dt id="biblio-webidl">[WEBIDL] <dd>Edgar Chen; Timothy Gu. <a href="https://webidl.spec.whatwg.org/"><cite>Web IDL Standard</cite></a>. Living Standard. URL: <a href="https://webidl.spec.whatwg.org/">https://webidl.spec.whatwg.org/</a> </dl> <h3 class="no-num no-ref heading settled" id="informative"><span class="content">Informative References</span><a class="self-link" href="#informative"></a></h3> <dl> <dt id="biblio-css-align-3">[CSS-ALIGN-3] <dd>Elika Etemad; Tab Atkins Jr.. <a href="https://drafts.csswg.org/css-align/"><cite>CSS Box Alignment Module Level 3</cite></a>. URL: <a href="https://drafts.csswg.org/css-align/">https://drafts.csswg.org/css-align/</a> <dt id="biblio-css-break-3">[CSS-BREAK-3] <dd>CSS Fragmentation Module Level 3 URL: <a href="https://www.w3.org/TR/css-break-3/">https://www.w3.org/TR/css-break-3/</a> <dt id="biblio-css-cascade-4">[CSS-CASCADE-4] <dd>Elika Etemad; Tab Atkins Jr.. <a href="https://drafts.csswg.org/css-cascade-4/"><cite>CSS Cascading and Inheritance Level 4</cite></a>. URL: <a href="https://drafts.csswg.org/css-cascade-4/">https://drafts.csswg.org/css-cascade-4/</a> <dt id="biblio-css-contain-2">[CSS-CONTAIN-2] <dd>Tab Atkins Jr.; Florian Rivoal; Vladimir Levin. <a href="https://drafts.csswg.org/css-contain-2/"><cite>CSS Containment Module Level 2</cite></a>. URL: <a href="https://drafts.csswg.org/css-contain-2/">https://drafts.csswg.org/css-contain-2/</a> <dt id="biblio-css-flexbox-1">[CSS-FLEXBOX-1] <dd>Tab Atkins Jr.; et al. <a href="https://drafts.csswg.org/css-flexbox-1/"><cite>CSS Flexible Box Layout Module Level 1</cite></a>. URL: <a href="https://drafts.csswg.org/css-flexbox-1/">https://drafts.csswg.org/css-flexbox-1/</a> <dt id="biblio-css-inline-3">[CSS-INLINE-3] <dd>Dave Cramer; Elika Etemad; Steve Zilles. <a href="https://drafts.csswg.org/css-inline-3/"><cite>CSS Inline Layout Module Level 3</cite></a>. URL: <a href="https://drafts.csswg.org/css-inline-3/">https://drafts.csswg.org/css-inline-3/</a> <dt id="biblio-css-lists-3">[CSS-LISTS-3] <dd>Elika Etemad; Tab Atkins Jr.. <a href="https://drafts.csswg.org/css-lists-3/"><cite>CSS Lists and Counters Module Level 3</cite></a>. URL: <a href="https://drafts.csswg.org/css-lists-3/">https://drafts.csswg.org/css-lists-3/</a> <dt id="biblio-css-logical-1">[CSS-LOGICAL-1] <dd>Rossen Atanassov; Elika Etemad. <a href="https://drafts.csswg.org/css-logical-1/"><cite>CSS Logical Properties and Values Level 1</cite></a>. URL: <a href="https://drafts.csswg.org/css-logical-1/">https://drafts.csswg.org/css-logical-1/</a> <dt id="biblio-css-page-3">[CSS-PAGE-3] <dd>Elika Etemad; Simon Sapin. <a href="https://drafts.csswg.org/css-page-3/"><cite>CSS Paged Media Module Level 3</cite></a>. URL: <a href="https://drafts.csswg.org/css-page-3/">https://drafts.csswg.org/css-page-3/</a> <dt id="biblio-css-sizing-3">[CSS-SIZING-3] <dd>Tab Atkins Jr.; Elika Etemad. <a href="https://drafts.csswg.org/css-sizing-3/"><cite>CSS Box Sizing Module Level 3</cite></a>. URL: <a href="https://drafts.csswg.org/css-sizing-3/">https://drafts.csswg.org/css-sizing-3/</a> <dt id="biblio-css-text-3">[CSS-TEXT-3] <dd>Elika Etemad; Koji Ishii; Florian Rivoal. <a href="https://drafts.csswg.org/css-text-3/"><cite>CSS Text Module Level 3</cite></a>. URL: <a href="https://drafts.csswg.org/css-text-3/">https://drafts.csswg.org/css-text-3/</a> <dt id="biblio-css-text-4">[CSS-TEXT-4] <dd>Elika Etemad; et al. <a href="https://drafts.csswg.org/css-text-4/"><cite>CSS Text Module Level 4</cite></a>. URL: <a href="https://drafts.csswg.org/css-text-4/">https://drafts.csswg.org/css-text-4/</a> <dt id="biblio-css-writing-modes-4">[CSS-WRITING-MODES-4] <dd>Elika Etemad; Koji Ishii. <a href="https://drafts.csswg.org/css-writing-modes-4/"><cite>CSS Writing Modes Level 4</cite></a>. URL: <a href="https://drafts.csswg.org/css-writing-modes-4/">https://drafts.csswg.org/css-writing-modes-4/</a> <dt id="biblio-cssom-1">[CSSOM-1] <dd>CSS Object Model Level 1 URL: <a href="https://www.w3.org/TR/cssom-1/">https://www.w3.org/TR/cssom-1/</a> <dt id="biblio-svg11">[SVG11] <dd>Erik Dahlström; et al. <a href="https://www.w3.org/TR/SVG11/"><cite>Scalable Vector Graphics (SVG) 1.1 (Second Edition)</cite></a>. 16 August 2011. REC. URL: <a href="https://www.w3.org/TR/SVG11/">https://www.w3.org/TR/SVG11/</a> </dl> <h2 class="no-num no-ref heading settled" id="property-index"><span class="content">Property Index</span><a class="self-link" href="#property-index"></a></h2> <div class="big-element-wrapper"> <table class="index"> <thead> <tr> <th scope="col">Name <th scope="col">Value <th scope="col">Initial <th scope="col">Applies to <th scope="col">Inh. <th scope="col">%ages <th scope="col">Animation type <th scope="col">Canonical order <th scope="col">Computed value <tbody> <tr> <th scope="row"><a class="css" data-link-type="property" href="#propdef-all" id="ref-for-propdef-all④">all</a> <td>initial | inherit | unset | revert | revert-layer <td>see individual properties <td>see individual properties <td>see individual properties <td>see individual properties <td>see individual properties <td>per grammar <td>see individual properties </table> </div> <h2 class="no-num no-ref heading settled" id="idl-index"><span class="content">IDL Index</span><a class="self-link" href="#idl-index"></a></h2> <pre class="idl highlight def"><c- b>partial</c-> <c- b>interface</c-> <a class="idl-code" data-link-type="interface" href="https://drafts.csswg.org/cssom-1/#cssimportrule"><c- g>CSSImportRule</c-></a> { <c- b>readonly</c-> <c- b>attribute</c-> <a data-link-type="idl-name" href="https://drafts.csswg.org/cssom-1/#cssomstring"><c- n>CSSOMString</c-></a>? <a class="idl-code" data-link-type="attribute" data-readonly data-type="CSSOMString?" href="#dom-cssimportrule-layername"><c- g>layerName</c-></a>; }; [<a class="idl-code" data-link-type="extended-attribute" href="https://webidl.spec.whatwg.org/#Exposed"><c- g>Exposed</c-></a>=<c- n>Window</c->] <c- b>interface</c-> <a href="#csslayerblockrule"><code><c- g>CSSLayerBlockRule</c-></code></a> : <a data-link-type="idl-name" href="https://drafts.csswg.org/cssom-1/#cssgroupingrule"><c- n>CSSGroupingRule</c-></a> { <c- b>readonly</c-> <c- b>attribute</c-> <a data-link-type="idl-name" href="https://drafts.csswg.org/cssom-1/#cssomstring"><c- n>CSSOMString</c-></a> <a class="idl-code" data-link-type="attribute" data-readonly data-type="CSSOMString" href="#dom-csslayerblockrule-name"><c- g>name</c-></a>; }; [<a class="idl-code" data-link-type="extended-attribute" href="https://webidl.spec.whatwg.org/#Exposed"><c- g>Exposed</c-></a>=<c- n>Window</c->] <c- b>interface</c-> <a href="#csslayerstatementrule"><code><c- g>CSSLayerStatementRule</c-></code></a> : <a data-link-type="idl-name" href="https://drafts.csswg.org/cssom-1/#cssrule"><c- n>CSSRule</c-></a> { <c- b>readonly</c-> <c- b>attribute</c-> <a class="idl-code" data-link-type="interface" href="https://webidl.spec.whatwg.org/#idl-frozen-array"><c- b>FrozenArray</c-></a><<a data-link-type="idl-name" href="https://drafts.csswg.org/cssom-1/#cssomstring"><c- n>CSSOMString</c-></a>> <a class="idl-code" data-link-type="attribute" data-readonly data-type="FrozenArray<CSSOMString>" href="#dom-csslayerstatementrule-namelist"><c- g>nameList</c-></a>; }; </pre> <h2 class="no-num no-ref heading settled" id="issues-index"><span class="content">Issues Index</span><a class="self-link" href="#issues-index"></a></h2> <div style="counter-reset:issue"> <div class="issue"> Provide an attribute for assigning link or style elements to cascade layers? <a href="https://github.com/w3c/csswg-drafts/issues/5853">[Issue #w3c/csswg-drafts#5853]</a> <a class="issue-return" href="#issue-3d8c81e9" title="Jump to section">↵</a></div> <div class="issue"> Allow authors to explicitly place unlayered styles in the layer order <a href="https://github.com/w3c/csswg-drafts/issues/6323">[Issue #6323]</a> <a class="issue-return" href="#issue-e29f5f96" title="Jump to section">↵</a></div> </div> <aside class="dfn-panel" data-for="css-property"> <b><a href="#css-property">#css-property</a></b><b>Referenced in:</b> <ul> <li><a href="#ref-for-css-property">1. Introduction</a> </ul> </aside> <aside class="dfn-panel" data-for="at-ruledef-import"> <b><a href="#at-ruledef-import">#at-ruledef-import</a></b><b>Referenced in:</b> <ul> <li><a href="#ref-for-at-ruledef-import">2. Importing Style Sheets: the @import rule</a> <a href="#ref-for-at-ruledef-import①">(2)</a> <a href="#ref-for-at-ruledef-import②">(3)</a> <a href="#ref-for-at-ruledef-import③">(4)</a> <a href="#ref-for-at-ruledef-import④">(5)</a> <a href="#ref-for-at-ruledef-import⑤">(6)</a> <a href="#ref-for-at-ruledef-import⑥">(7)</a> <a href="#ref-for-at-ruledef-import⑦">(8)</a> <a href="#ref-for-at-ruledef-import⑧">(9)</a> <a href="#ref-for-at-ruledef-import⑨">(10)</a> <li><a href="#ref-for-at-ruledef-import①⓪">2.1. Conditional @import Rules</a> <a href="#ref-for-at-ruledef-import①①">(2)</a> <li><a href="#ref-for-at-ruledef-import①②">6.1. Cascade Sorting Order</a> <a href="#ref-for-at-ruledef-import①③">(2)</a> <li><a href="#ref-for-at-ruledef-import①④">6.4.1. Declaring Cascade Layers</a> <li><a href="#ref-for-at-ruledef-import①⑤">6.4.2. Layer Naming and Nesting</a> <a href="#ref-for-at-ruledef-import①⑥">(2)</a> <li><a href="#ref-for-at-ruledef-import①⑦">6.4.2.1. Anonymous Layers</a> <li><a href="#ref-for-at-ruledef-import①⑧">6.4.4.1. Assigning Styles Inline: the @layer block at-rule</a> <li><a href="#ref-for-at-ruledef-import①⑨">6.4.4.2. Declaring Without Styles: the @layer statement at-rule</a> <a href="#ref-for-at-ruledef-import②⓪">(2)</a> <a href="#ref-for-at-ruledef-import②①">(3)</a> <a href="#ref-for-at-ruledef-import②②">(4)</a> <a href="#ref-for-at-ruledef-import②③">(5)</a> <a href="#ref-for-at-ruledef-import②④">(6)</a> <a href="#ref-for-at-ruledef-import②⑤">(7)</a> <li><a href="#ref-for-at-ruledef-import②⑥">9.2. Changes since the 15 Oct 2021 Working Draft</a> <li><a href="#ref-for-at-ruledef-import②⑦">9.4. Changes since the 8 June 2021 Working Draft</a> <li><a href="#ref-for-at-ruledef-import②⑧">9.6. Changes since the 19 January 2021 Working Draft</a> <li><a href="#ref-for-at-ruledef-import②⑨">9.7. Additions Since Level 4</a> <li><a href="#ref-for-at-ruledef-import③⓪">9.8. Additions Since Level 3</a> <li><a href="#ref-for-at-ruledef-import③①"> Privacy and Security Considerations</a> <a href="#ref-for-at-ruledef-import③②">(2)</a> </ul> </aside> <aside class="dfn-panel" data-for="typedef-import-conditions"> <b><a href="#typedef-import-conditions">#typedef-import-conditions</a></b><b>Referenced in:</b> <ul> <li><a href="#ref-for-typedef-import-conditions">2. Importing Style Sheets: the @import rule</a> </ul> </aside> <aside class="dfn-panel" data-for="import-conditions"> <b><a href="#import-conditions">#import-conditions</a></b><b>Referenced in:</b> <ul> <li><a href="#ref-for-import-conditions">2. Importing Style Sheets: the @import rule</a> <a href="#ref-for-import-conditions①">(2)</a> <li><a href="#ref-for-import-conditions②">2.1. Conditional @import Rules</a> <a href="#ref-for-import-conditions③">(2)</a> <a href="#ref-for-import-conditions④">(3)</a> <a href="#ref-for-import-conditions⑤">(4)</a> <a href="#ref-for-import-conditions⑥">(5)</a> </ul> </aside> <aside class="dfn-panel" data-for="shorthand-property"> <b><a href="#shorthand-property">#shorthand-property</a></b><b>Referenced in:</b> <ul> <li><a href="#ref-for-shorthand-property">3. Shorthand Properties</a> <a href="#ref-for-shorthand-property①">(2)</a> <a href="#ref-for-shorthand-property②">(3)</a> <a href="#ref-for-shorthand-property③">(4)</a> <a href="#ref-for-shorthand-property④">(5)</a> <a href="#ref-for-shorthand-property⑤">(6)</a> <a href="#ref-for-shorthand-property⑥">(7)</a> <a href="#ref-for-shorthand-property⑦">(8)</a> <a href="#ref-for-shorthand-property⑧">(9)</a> <li><a href="#ref-for-shorthand-property⑨">3.1. Property Aliasing</a> <li><a href="#ref-for-shorthand-property①⓪">3.2. Resetting All Properties: the all property</a> <li><a href="#ref-for-shorthand-property①①">6.3. Important Declarations: the !important annotation</a> <li><a href="#ref-for-shorthand-property①②">7.3.3. Erasing All Declarations: the unset keyword</a> <li><a href="#ref-for-shorthand-property①③">7.3.4. Rolling Back Cascade Origins: the revert keyword</a> </ul> </aside> <aside class="dfn-panel" data-for="longhand"> <b><a href="#longhand">#longhand</a></b><b>Referenced in:</b> <ul> <li><a href="#ref-for-longhand">3. Shorthand Properties</a> <a href="#ref-for-longhand①">(2)</a> <a href="#ref-for-longhand②">(3)</a> <a href="#ref-for-longhand③">(4)</a> <a href="#ref-for-longhand④">(5)</a> <a href="#ref-for-longhand⑤">(6)</a> <a href="#ref-for-longhand⑥">(7)</a> <a href="#ref-for-longhand⑦">(8)</a> <a href="#ref-for-longhand⑧">(9)</a> <a href="#ref-for-longhand⑨">(10)</a> </ul> </aside> <aside class="dfn-panel" data-for="reset-only-sub-property"> <b><a href="#reset-only-sub-property">#reset-only-sub-property</a></b><b>Referenced in:</b> <ul> <li><a href="#ref-for-reset-only-sub-property">3. Shorthand Properties</a> </ul> </aside> <aside class="dfn-panel" data-for="legacy-name-alias"> <b><a href="#legacy-name-alias">#legacy-name-alias</a></b><b>Referenced in:</b> <ul> <li><a href="#ref-for-legacy-name-alias">3.1. Property Aliasing</a> </ul> </aside> <aside class="dfn-panel" data-for="legacy-shorthand"> <b><a href="#legacy-shorthand">#legacy-shorthand</a></b><b>Referenced in:</b> <ul> <li><a href="#ref-for-legacy-shorthand">3.1. Property Aliasing</a> <a href="#ref-for-legacy-shorthand①">(2)</a> </ul> </aside> <aside class="dfn-panel" data-for="propdef-all"> <b><a href="#propdef-all">#propdef-all</a></b><b>Referenced in:</b> <ul> <li><a href="#ref-for-propdef-all">3.2. Resetting All Properties: the all property</a> <a href="#ref-for-propdef-all①">(2)</a> <a href="#ref-for-propdef-all②">(3)</a> <li><a href="#ref-for-propdef-all③">9.9. Additions Since Level 2</a> </ul> </aside> <aside class="dfn-panel" data-for="declared-value"> <b><a href="#declared-value">#declared-value</a></b><b>Referenced in:</b> <ul> <li><a href="#ref-for-declared-value">4. Value Processing</a> <a href="#ref-for-declared-value①">(2)</a> <a href="#ref-for-declared-value②">(3)</a> <li><a href="#ref-for-declared-value③">4.1.1. Value Aliasing</a> <li><a href="#ref-for-declared-value④">4.2. Cascaded Values</a> <li><a href="#ref-for-declared-value⑤">5. Filtering</a> <a href="#ref-for-declared-value⑥">(2)</a> <li><a href="#ref-for-declared-value⑦">6. Cascading</a> <li><a href="#ref-for-declared-value⑧">6.1. Cascade Sorting Order</a> <li><a href="#ref-for-declared-value⑨">7.3.3. Erasing All Declarations: the unset keyword</a> </ul> </aside> <aside class="dfn-panel" data-for="cascaded-value"> <b><a href="#cascaded-value">#cascaded-value</a></b><b>Referenced in:</b> <ul> <li><a href="#ref-for-cascaded-value">4. Value Processing</a> <a href="#ref-for-cascaded-value①">(2)</a> <a href="#ref-for-cascaded-value②">(3)</a> <li><a href="#ref-for-cascaded-value③">4.2. Cascaded Values</a> <li><a href="#ref-for-cascaded-value④">4.3. Specified Values</a> <a href="#ref-for-cascaded-value⑤">(2)</a> <a href="#ref-for-cascaded-value⑥">(3)</a> <a href="#ref-for-cascaded-value⑦">(4)</a> <li><a href="#ref-for-cascaded-value⑧">6. Cascading</a> <li><a href="#ref-for-cascaded-value⑨">7.3.1. Resetting a Property: the initial keyword</a> <li><a href="#ref-for-cascaded-value①⓪">7.3.2. Explicit Inheritance: the inherit keyword</a> <li><a href="#ref-for-cascaded-value①①">7.3.3. Erasing All Declarations: the unset keyword</a> <li><a href="#ref-for-cascaded-value①②">7.3.4. Rolling Back Cascade Origins: the revert keyword</a> <a href="#ref-for-cascaded-value①③">(2)</a> <a href="#ref-for-cascaded-value①④">(3)</a> <li><a href="#ref-for-cascaded-value①⑤">7.3.5. Rolling Back Cascade Layers: the revert-layer keyword</a> <a href="#ref-for-cascaded-value①⑥">(2)</a> <a href="#ref-for-cascaded-value①⑦">(3)</a> </ul> </aside> <aside class="dfn-panel" data-for="specified-value"> <b><a href="#specified-value">#specified-value</a></b><b>Referenced in:</b> <ul> <li><a href="#ref-for-specified-value">1. Introduction</a> <li><a href="#ref-for-specified-value①">4. Value Processing</a> <a href="#ref-for-specified-value②">(2)</a> <a href="#ref-for-specified-value③">(3)</a> <li><a href="#ref-for-specified-value④">4.3. Specified Values</a> <a href="#ref-for-specified-value⑤">(2)</a> <a href="#ref-for-specified-value⑥">(3)</a> <a href="#ref-for-specified-value⑦">(4)</a> <li><a href="#ref-for-specified-value⑧">4.4. Computed Values</a> <a href="#ref-for-specified-value⑨">(2)</a> <a href="#ref-for-specified-value①⓪">(3)</a> <li><a href="#ref-for-specified-value①①">4.8. Per-Fragment Value Processing</a> <li><a href="#ref-for-specified-value①②">7. Defaulting</a> <li><a href="#ref-for-specified-value①③">7.1. Initial Values</a> <li><a href="#ref-for-specified-value①④">7.3.1. Resetting a Property: the initial keyword</a> <li><a href="#ref-for-specified-value①⑤">7.3.2. Explicit Inheritance: the inherit keyword</a> <li><a href="#ref-for-specified-value①⑥">7.3.4. Rolling Back Cascade Origins: the revert keyword</a> <a href="#ref-for-specified-value①⑦">(2)</a> <li><a href="#ref-for-specified-value①⑧">7.3.5. Rolling Back Cascade Layers: the revert-layer keyword</a> </ul> </aside> <aside class="dfn-panel" data-for="computed-value"> <b><a href="#computed-value">#computed-value</a></b><b>Referenced in:</b> <ul> <li><a href="#ref-for-computed-value">4. Value Processing</a> <a href="#ref-for-computed-value①">(2)</a> <a href="#ref-for-computed-value②">(3)</a> <li><a href="#ref-for-computed-value③">4.4. Computed Values</a> <a href="#ref-for-computed-value④">(2)</a> <a href="#ref-for-computed-value⑤">(3)</a> <a href="#ref-for-computed-value⑥">(4)</a> <a href="#ref-for-computed-value⑦">(5)</a> <a href="#ref-for-computed-value⑧">(6)</a> <li><a href="#ref-for-computed-value⑨">4.5. Used Values</a> <a href="#ref-for-computed-value①⓪">(2)</a> <li><a href="#ref-for-computed-value①①">4.5.1. Applicable Properties</a> <li><a href="#ref-for-computed-value①②">4.8. Per-Fragment Value Processing</a> <li><a href="#ref-for-computed-value①③">7.2. Inheritance</a> <li><a href="#ref-for-computed-value①④">7.3.2. Explicit Inheritance: the inherit keyword</a> </ul> </aside> <aside class="dfn-panel" data-for="used-value"> <b><a href="#used-value">#used-value</a></b><b>Referenced in:</b> <ul> <li><a href="#ref-for-used-value">4. Value Processing</a> <a href="#ref-for-used-value①">(2)</a> <a href="#ref-for-used-value②">(3)</a> <a href="#ref-for-used-value③">(4)</a> <li><a href="#ref-for-used-value④">4.4. Computed Values</a> <li><a href="#ref-for-used-value⑤">4.5. Used Values</a> <a href="#ref-for-used-value⑥">(2)</a> <a href="#ref-for-used-value⑦">(3)</a> <li><a href="#ref-for-used-value⑧">4.6. Actual Values</a> <a href="#ref-for-used-value⑨">(2)</a> </ul> </aside> <aside class="dfn-panel" data-for="apply"> <b><a href="#apply">#apply</a></b><b>Referenced in:</b> <ul> <li><a href="#ref-for-apply">4.4. Computed Values</a> <li><a href="#ref-for-apply①">4.5. Used Values</a> </ul> </aside> <aside class="dfn-panel" data-for="actual-value"> <b><a href="#actual-value">#actual-value</a></b><b>Referenced in:</b> <ul> <li><a href="#ref-for-actual-value">4. Value Processing</a> <a href="#ref-for-actual-value①">(2)</a> <a href="#ref-for-actual-value②">(3)</a> </ul> </aside> <aside class="dfn-panel" data-for="cascade"> <b><a href="#cascade">#cascade</a></b><b>Referenced in:</b> <ul> <li><a href="#ref-for-cascade">1. Introduction</a> <a href="#ref-for-cascade">(2)</a> <li><a href="#ref-for-cascade①">4.1. Declared Values</a> <li><a href="#ref-for-cascade">4.2. Cascaded Values</a> <li><a href="#ref-for-cascade②">5. Filtering</a> <li><a href="#ref-for-cascade③">6.5. Precedence of Non-CSS Presentational Hints</a> <a href="#ref-for-cascade④">(2)</a> <a href="#ref-for-cascade⑤">(3)</a> <li><a href="#ref-for-cascade⑥">7. Defaulting</a> <li><a href="#ref-for-cascade⑦">7.1. Initial Values</a> <li><a href="#ref-for-cascade⑧">7.2. Inheritance</a> <li><a href="#ref-for-cascade⑨">7.3.3. Erasing All Declarations: the unset keyword</a> <li><a href="#ref-for-cascade①⓪">7.3.5. Rolling Back Cascade Layers: the revert-layer keyword</a> <li><a href="#ref-for-cascade①①">9.7. Additions Since Level 4</a> <a href="#ref-for-cascade①②">(2)</a> <li><a href="#ref-for-cascade①③">9.8. Additions Since Level 3</a> <li><a href="#ref-for-cascade①④">9.9. Additions Since Level 2</a> </ul> </aside> <aside class="dfn-panel" data-for="encapsulation-contexts"> <b><a href="#encapsulation-contexts">#encapsulation-contexts</a></b><b>Referenced in:</b> <ul> <li><a href="#ref-for-encapsulation-contexts">6.1. Cascade Sorting Order</a> <a href="#ref-for-encapsulation-contexts①">(2)</a> <a href="#ref-for-encapsulation-contexts②">(3)</a> <a href="#ref-for-encapsulation-contexts③">(4)</a> <li><a href="#ref-for-encapsulation-contexts④">6.4.3. Layer Ordering</a> <li><a href="#ref-for-encapsulation-contexts⑤">9.8. Additions Since Level 3</a> </ul> </aside> <aside class="dfn-panel" data-for="output-of-the-cascade"> <b><a href="#output-of-the-cascade">#output-of-the-cascade</a></b><b>Referenced in:</b> <ul> <li><a href="#ref-for-output-of-the-cascade">4.2. Cascaded Values</a> <a href="#ref-for-output-of-the-cascade①">(2)</a> </ul> </aside> <aside class="dfn-panel" data-for="origin"> <b><a href="#origin">#origin</a></b><b>Referenced in:</b> <ul> <li><a href="#ref-for-origin">2.2. Processing Stylesheet Imports</a> <a href="#ref-for-origin①">(2)</a> <li><a href="#ref-for-origin②">6.1. Cascade Sorting Order</a> <a href="#ref-for-origin③">(2)</a> <a href="#ref-for-origin④">(3)</a> <a href="#ref-for-origin⑤">(4)</a> <a href="#ref-for-origin⑥">(5)</a> <a href="#ref-for-origin⑦">(6)</a> <li><a href="#ref-for-origin⑧">6.2. Cascading Origins</a> <a href="#ref-for-origin⑨">(2)</a> <li><a href="#ref-for-origin①⓪">6.4. Cascade Layers</a> <li><a href="#ref-for-origin①①">6.4.3. Layer Ordering</a> <li><a href="#ref-for-origin①②">6.5. Precedence of Non-CSS Presentational Hints</a> <li><a href="#ref-for-origin①③">7.3.4. Rolling Back Cascade Origins: the revert keyword</a> <a href="#ref-for-origin①④">(2)</a> <a href="#ref-for-origin①⑤">(3)</a> <li><a href="#ref-for-origin①⑥">7.3.5. Rolling Back Cascade Layers: the revert-layer keyword</a> <a href="#ref-for-origin①⑦">(2)</a> </ul> </aside> <aside class="dfn-panel" data-for="cascade-origin-author"> <b><a href="#cascade-origin-author">#cascade-origin-author</a></b><b>Referenced in:</b> <ul> <li><a href="#ref-for-cascade-origin-author">6.1. Cascade Sorting Order</a> <a href="#ref-for-cascade-origin-author①">(2)</a> <li><a href="#ref-for-cascade-origin-author②">6.3. Important Declarations: the !important annotation</a> <a href="#ref-for-cascade-origin-author③">(2)</a> <li><a href="#ref-for-cascade-origin-author④">6.5. Precedence of Non-CSS Presentational Hints</a> <a href="#ref-for-cascade-origin-author⑤">(2)</a> <a href="#ref-for-cascade-origin-author⑥">(3)</a> <a href="#ref-for-cascade-origin-author⑦">(4)</a> <a href="#ref-for-cascade-origin-author⑧">(5)</a> <a href="#ref-for-cascade-origin-author⑨">(6)</a> <li><a href="#ref-for-cascade-origin-author①⓪">7.3.4. Rolling Back Cascade Origins: the revert keyword</a> <a href="#ref-for-cascade-origin-author①①">(2)</a> <a href="#ref-for-cascade-origin-author①②">(3)</a> <li><a href="#ref-for-cascade-origin-author①③">7.3.5. Rolling Back Cascade Layers: the revert-layer keyword</a> <a href="#ref-for-cascade-origin-author①④">(2)</a> </ul> </aside> <aside class="dfn-panel" data-for="cascade-origin-user"> <b><a href="#cascade-origin-user">#cascade-origin-user</a></b><b>Referenced in:</b> <ul> <li><a href="#ref-for-cascade-origin-user">6.1. Cascade Sorting Order</a> <a href="#ref-for-cascade-origin-user①">(2)</a> <li><a href="#ref-for-cascade-origin-user②">6.3. Important Declarations: the !important annotation</a> <a href="#ref-for-cascade-origin-user③">(2)</a> <li><a href="#ref-for-cascade-origin-user④">6.5. Precedence of Non-CSS Presentational Hints</a> <a href="#ref-for-cascade-origin-user⑤">(2)</a> <a href="#ref-for-cascade-origin-user⑥">(3)</a> <li><a href="#ref-for-cascade-origin-user⑦">7.3.4. Rolling Back Cascade Origins: the revert keyword</a> <a href="#ref-for-cascade-origin-user⑧">(2)</a> </ul> </aside> <aside class="dfn-panel" data-for="cascade-origin-ua"> <b><a href="#cascade-origin-ua">#cascade-origin-ua</a></b><b>Referenced in:</b> <ul> <li><a href="#ref-for-cascade-origin-ua">6.1. Cascade Sorting Order</a> <a href="#ref-for-cascade-origin-ua①">(2)</a> <li><a href="#ref-for-cascade-origin-ua②">6.3. Important Declarations: the !important annotation</a> <li><a href="#ref-for-cascade-origin-ua③">6.5. Precedence of Non-CSS Presentational Hints</a> <a href="#ref-for-cascade-origin-ua④">(2)</a> <a href="#ref-for-cascade-origin-ua⑤">(3)</a> <li><a href="#ref-for-cascade-origin-ua⑥">7.3.4. Rolling Back Cascade Origins: the revert keyword</a> </ul> </aside> <aside class="dfn-panel" data-for="cascade-origin-animation"> <b><a href="#cascade-origin-animation">#cascade-origin-animation</a></b><b>Referenced in:</b> <ul> <li><a href="#ref-for-cascade-origin-animation">7.3.5. Rolling Back Cascade Layers: the revert-layer keyword</a> <a href="#ref-for-cascade-origin-animation①">(2)</a> </ul> </aside> <aside class="dfn-panel" data-for="important"> <b><a href="#important">#important</a></b><b>Referenced in:</b> <ul> <li><a href="#ref-for-important">6.1. Cascade Sorting Order</a> <a href="#ref-for-important①">(2)</a> <a href="#ref-for-important②">(3)</a> <a href="#ref-for-important③">(4)</a> <a href="#ref-for-important④">(5)</a> <a href="#ref-for-important⑤">(6)</a> <a href="#ref-for-important⑥">(7)</a> <a href="#ref-for-important⑦">(8)</a> <a href="#ref-for-important⑧">(9)</a> <a href="#ref-for-important⑨">(10)</a> <li><a href="#ref-for-important①⓪">6.3. Important Declarations: the !important annotation</a> <a href="#ref-for-important①①">(2)</a> <a href="#ref-for-important①②">(3)</a> <a href="#ref-for-important①③">(4)</a> <a href="#ref-for-important①④">(5)</a> <a href="#ref-for-important①⑤">(6)</a> <a href="#ref-for-important①⑥">(7)</a> <a href="#ref-for-important①⑦">(8)</a> <li><a href="#ref-for-important①⑧">6.5. Precedence of Non-CSS Presentational Hints</a> <li><a href="#ref-for-important①⑨">7.3.5. Rolling Back Cascade Layers: the revert-layer keyword</a> <a href="#ref-for-important②⓪">(2)</a> <a href="#ref-for-important②①">(3)</a> </ul> </aside> <aside class="dfn-panel" data-for="normal"> <b><a href="#normal">#normal</a></b><b>Referenced in:</b> <ul> <li><a href="#ref-for-normal">6.1. Cascade Sorting Order</a> <a href="#ref-for-normal①">(2)</a> <a href="#ref-for-normal②">(3)</a> <a href="#ref-for-normal③">(4)</a> <a href="#ref-for-normal④">(5)</a> <a href="#ref-for-normal⑤">(6)</a> <a href="#ref-for-normal⑥">(7)</a> <a href="#ref-for-normal⑦">(8)</a> <li><a href="#ref-for-normal⑧">6.3. Important Declarations: the !important annotation</a> <li><a href="#ref-for-normal⑨">7.3.5. Rolling Back Cascade Layers: the revert-layer keyword</a> </ul> </aside> <aside class="dfn-panel" data-for="cascade-layers"> <b><a href="#cascade-layers">#cascade-layers</a></b><b>Referenced in:</b> <ul> <li><a href="#ref-for-cascade-layers①">2. Importing Style Sheets: the @import rule</a> <a href="#ref-for-cascade-layers②">(2)</a> <li><a href="#ref-for-cascade-layers③">6.1. Cascade Sorting Order</a> <a href="#ref-for-cascade-layers④">(2)</a> <a href="#ref-for-cascade-layers⑤">(3)</a> <li><a href="#ref-for-cascade-layers⑥">6.4. Cascade Layers</a> <a href="#ref-for-cascade-layers⑦">(2)</a> <li><a href="#ref-for-cascade-layers⑧">6.4.2. Layer Naming and Nesting</a> <a href="#ref-for-cascade-layers⑨">(2)</a> <li><a href="#ref-for-cascade-layers①⓪">6.4.3. Layer Ordering</a> <li><a href="#ref-for-cascade-layers①①">6.4.4. Declaring Layers Inline: the @layer rule</a> <li><a href="#ref-for-cascade-layers①②">6.4.4.1. Assigning Styles Inline: the @layer block at-rule</a> <li><a href="#ref-for-cascade-layers①③">7.3.5. Rolling Back Cascade Layers: the revert-layer keyword</a> <a href="#ref-for-cascade-layers①④">(2)</a> <a href="#ref-for-cascade-layers①⑤">(3)</a> <a href="#ref-for-cascade-layers①⑥">(4)</a> <li><a href="#ref-for-cascade-layers①⑦">9.6. Changes since the 19 January 2021 Working Draft</a> <li><a href="#ref-for-cascade-layers①⑧">9.7. Additions Since Level 4</a> </ul> </aside> <aside class="dfn-panel" data-for="layer-name"> <b><a href="#layer-name">#layer-name</a></b><b>Referenced in:</b> <ul> <li><a href="#ref-for-layer-name">6.4.2. Layer Naming and Nesting</a> <a href="#ref-for-layer-name①">(2)</a> <li><a href="#ref-for-layer-name②">6.4.2.1. Anonymous Layers</a> <li><a href="#ref-for-layer-name③">6.4.4.2. Declaring Without Styles: the @layer statement at-rule</a> <li><a href="#ref-for-layer-name④">8.1. Extensions to the CSSImportRule interface</a> <li><a href="#ref-for-layer-name⑤">8.2. The CSSLayerBlockRule interface</a> <li><a href="#ref-for-layer-name⑥">8.3. The CSSLayerStatementRule interface</a> </ul> </aside> <aside class="dfn-panel" data-for="typedef-layer-name"> <b><a href="#typedef-layer-name">#typedef-layer-name</a></b><b>Referenced in:</b> <ul> <li><a href="#ref-for-typedef-layer-name">2. Importing Style Sheets: the @import rule</a> <li><a href="#ref-for-typedef-layer-name①">6.4.2. Layer Naming and Nesting</a> <a href="#ref-for-typedef-layer-name②">(2)</a> <a href="#ref-for-typedef-layer-name③">(3)</a> <li><a href="#ref-for-typedef-layer-name④">6.4.2.1. Anonymous Layers</a> <a href="#ref-for-typedef-layer-name⑤">(2)</a> <a href="#ref-for-typedef-layer-name⑥">(3)</a> <li><a href="#ref-for-typedef-layer-name⑦">6.4.4.1. Assigning Styles Inline: the @layer block at-rule</a> <li><a href="#ref-for-typedef-layer-name⑧">6.4.4.2. Declaring Without Styles: the @layer statement at-rule</a> </ul> </aside> <aside class="dfn-panel" data-for="at-ruledef-layer"> <b><a href="#at-ruledef-layer">#at-ruledef-layer</a></b><b>Referenced in:</b> <ul> <li><a href="#ref-for-at-ruledef-layer">2. Importing Style Sheets: the @import rule</a> <a href="#ref-for-at-ruledef-layer①">(2)</a> <li><a href="#ref-for-at-ruledef-layer②">6.4.2. Layer Naming and Nesting</a> <a href="#ref-for-at-ruledef-layer③">(2)</a> <a href="#ref-for-at-ruledef-layer④">(3)</a> <a href="#ref-for-at-ruledef-layer⑤">(4)</a> <li><a href="#ref-for-at-ruledef-layer⑥">6.4.2.1. Anonymous Layers</a> <li><a href="#ref-for-at-ruledef-layer⑦">6.4.3. Layer Ordering</a> <li><a href="#ref-for-at-ruledef-layer⑧">6.4.4. Declaring Layers Inline: the @layer rule</a> <li><a href="#ref-for-at-ruledef-layer⑨">6.4.4.1. Assigning Styles Inline: the @layer block at-rule</a> <a href="#ref-for-at-ruledef-layer①⓪">(2)</a> <a href="#ref-for-at-ruledef-layer①①">(3)</a> <a href="#ref-for-at-ruledef-layer①②">(4)</a> <a href="#ref-for-at-ruledef-layer①③">(5)</a> <li><a href="#ref-for-at-ruledef-layer①④">6.4.4.2. Declaring Without Styles: the @layer statement at-rule</a> <a href="#ref-for-at-ruledef-layer①⑤">(2)</a> <a href="#ref-for-at-ruledef-layer①⑥">(3)</a> <a href="#ref-for-at-ruledef-layer①⑦">(4)</a> <a href="#ref-for-at-ruledef-layer①⑧">(5)</a> <a href="#ref-for-at-ruledef-layer①⑨">(6)</a> <a href="#ref-for-at-ruledef-layer②⓪">(7)</a> <li><a href="#ref-for-at-ruledef-layer②①">8.2. The CSSLayerBlockRule interface</a> <a href="#ref-for-at-ruledef-layer②②">(2)</a> <li><a href="#ref-for-at-ruledef-layer②③">8.3. The CSSLayerStatementRule interface</a> <li><a href="#ref-for-at-ruledef-layer②④">9.4. Changes since the 8 June 2021 Working Draft</a> <a href="#ref-for-at-ruledef-layer②⑤">(2)</a> <li><a href="#ref-for-at-ruledef-layer②⑥">9.6. Changes since the 19 January 2021 Working Draft</a> <li><a href="#ref-for-at-ruledef-layer②⑦">9.7. Additions Since Level 4</a> </ul> </aside> <aside class="dfn-panel" data-for="author-presentational-hint-origin"> <b><a href="#author-presentational-hint-origin">#author-presentational-hint-origin</a></b><b>Referenced in:</b> <ul> <li><a href="#ref-for-author-presentational-hint-origin">6.5. Precedence of Non-CSS Presentational Hints</a> <a href="#ref-for-author-presentational-hint-origin①">(2)</a> <li><a href="#ref-for-author-presentational-hint-origin②">9.3. Changes since the 29 August 2021 Working Draft</a> </ul> </aside> <aside class="dfn-panel" data-for="initial-value"> <b><a href="#initial-value">#initial-value</a></b><b>Referenced in:</b> <ul> <li><a href="#ref-for-initial-value">1. Introduction</a> <li><a href="#ref-for-initial-value①">3. Shorthand Properties</a> <li><a href="#ref-for-initial-value②">7. Defaulting</a> <li><a href="#ref-for-initial-value③">7.1. Initial Values</a> <li><a href="#ref-for-initial-value④">7.2. Inheritance</a> <li><a href="#ref-for-initial-value⑤">7.3.1. Resetting a Property: the initial keyword</a> </ul> </aside> <aside class="dfn-panel" data-for="inheritance"> <b><a href="#inheritance">#inheritance</a></b><b>Referenced in:</b> <ul> <li><a href="#ref-for-inheritance">1. Introduction</a> <li><a href="#ref-for-inheritance①">4.4. Computed Values</a> <a href="#ref-for-inheritance②">(2)</a> <li><a href="#ref-for-inheritance③">7. Defaulting</a> <li><a href="#ref-for-inheritance④">7.2. Inheritance</a> </ul> </aside> <aside class="dfn-panel" data-for="inherited-value"> <b><a href="#inherited-value">#inherited-value</a></b><b>Referenced in:</b> <ul> <li><a href="#ref-for-inherited-value">7.2. Inheritance</a> <li><a href="#ref-for-inherited-value①">7.3.2. Explicit Inheritance: the inherit keyword</a> </ul> </aside> <aside class="dfn-panel" data-for="inherited-property"> <b><a href="#inherited-property">#inherited-property</a></b><b>Referenced in:</b> <ul> <li><a href="#ref-for-inherited-property">7. Defaulting</a> <li><a href="#ref-for-inherited-property①">7.1. Initial Values</a> </ul> </aside> <aside class="dfn-panel" data-for="valdef-all-initial"> <b><a href="#valdef-all-initial">#valdef-all-initial</a></b><b>Referenced in:</b> <ul> <li><a href="#ref-for-valdef-all-initial">7. Defaulting</a> <li><a href="#ref-for-valdef-all-initial①">7.3.1. Resetting a Property: the initial keyword</a> <li><a href="#ref-for-valdef-all-initial②">7.3.3. Erasing All Declarations: the unset keyword</a> <li><a href="#ref-for-valdef-all-initial③">9.9. Additions Since Level 2</a> </ul> </aside> <aside class="dfn-panel" data-for="valdef-all-inherit"> <b><a href="#valdef-all-inherit">#valdef-all-inherit</a></b><b>Referenced in:</b> <ul> <li><a href="#ref-for-valdef-all-inherit">7. Defaulting</a> <li><a href="#ref-for-valdef-all-inherit①">7.2. Inheritance</a> <li><a href="#ref-for-valdef-all-inherit②">7.3.2. Explicit Inheritance: the inherit keyword</a> <li><a href="#ref-for-valdef-all-inherit③">7.3.3. Erasing All Declarations: the unset keyword</a> </ul> </aside> <aside class="dfn-panel" data-for="valdef-all-unset"> <b><a href="#valdef-all-unset">#valdef-all-unset</a></b><b>Referenced in:</b> <ul> <li><a href="#ref-for-valdef-all-unset">7.3.3. Erasing All Declarations: the unset keyword</a> <li><a href="#ref-for-valdef-all-unset①">7.3.4. Rolling Back Cascade Origins: the revert keyword</a> <li><a href="#ref-for-valdef-all-unset②">9.9. Additions Since Level 2</a> </ul> </aside> <aside class="dfn-panel" data-for="valdef-all-revert"> <b><a href="#valdef-all-revert">#valdef-all-revert</a></b><b>Referenced in:</b> <ul> <li><a href="#ref-for-valdef-all-revert">6.5. Precedence of Non-CSS Presentational Hints</a> <li><a href="#ref-for-valdef-all-revert①">7.3. Explicit Defaulting</a> <li><a href="#ref-for-valdef-all-revert②">7.3.4. Rolling Back Cascade Origins: the revert keyword</a> <a href="#ref-for-valdef-all-revert③">(2)</a> <a href="#ref-for-valdef-all-revert④">(3)</a> <li><a href="#ref-for-valdef-all-revert⑤">7.3.5. Rolling Back Cascade Layers: the revert-layer keyword</a> <a href="#ref-for-valdef-all-revert⑥">(2)</a> <li><a href="#ref-for-valdef-all-revert⑦">9.1. Changes since the 13 Jan 2022 Candidate Recommendation Snapshot</a> <li><a href="#ref-for-valdef-all-revert⑧">9.8. Additions Since Level 3</a> </ul> </aside> <aside class="dfn-panel" data-for="valdef-all-revert-layer"> <b><a href="#valdef-all-revert-layer">#valdef-all-revert-layer</a></b><b>Referenced in:</b> <ul> <li><a href="#ref-for-valdef-all-revert-layer①">6.5. Precedence of Non-CSS Presentational Hints</a> <li><a href="#ref-for-valdef-all-revert-layer②">7.3. Explicit Defaulting</a> <li><a href="#ref-for-valdef-all-revert-layer③">7.3.5. Rolling Back Cascade Layers: the revert-layer keyword</a> <a href="#ref-for-valdef-all-revert-layer④">(2)</a> <a href="#ref-for-valdef-all-revert-layer⑤">(3)</a> <a href="#ref-for-valdef-all-revert-layer⑥">(4)</a> <li><a href="#ref-for-valdef-all-revert-layer⑦">9.1. Changes since the 13 Jan 2022 Candidate Recommendation Snapshot</a> <li><a href="#ref-for-valdef-all-revert-layer⑧">9.2. Changes since the 15 Oct 2021 Working Draft</a> <li><a href="#ref-for-valdef-all-revert-layer⑨">9.6. Changes since the 19 January 2021 Working Draft</a> <li><a href="#ref-for-valdef-all-revert-layer①⓪">9.7. Additions Since Level 4</a> </ul> </aside> <aside class="dfn-panel" data-for="dom-cssimportrule-layername"> <b><a href="#dom-cssimportrule-layername">#dom-cssimportrule-layername</a></b><b>Referenced in:</b> <ul> <li><a href="#ref-for-dom-cssimportrule-layername">8.1. Extensions to the CSSImportRule interface</a> </ul> </aside> <aside class="dfn-panel" data-for="csslayerblockrule"> <b><a href="#csslayerblockrule">#csslayerblockrule</a></b><b>Referenced in:</b> <ul> <li><a href="#ref-for-csslayerblockrule">8.2. The CSSLayerBlockRule interface</a> <li><a href="#ref-for-csslayerblockrule①">8.3. The CSSLayerStatementRule interface</a> </ul> </aside> <aside class="dfn-panel" data-for="dom-csslayerblockrule-name"> <b><a href="#dom-csslayerblockrule-name">#dom-csslayerblockrule-name</a></b><b>Referenced in:</b> <ul> <li><a href="#ref-for-dom-csslayerblockrule-name">8.2. The CSSLayerBlockRule interface</a> <a href="#ref-for-dom-csslayerblockrule-name①">(2)</a> <li><a href="#ref-for-dom-csslayerblockrule-name②">8.3. The CSSLayerStatementRule interface</a> </ul> </aside> <aside class="dfn-panel" data-for="csslayerstatementrule"> <b><a href="#csslayerstatementrule">#csslayerstatementrule</a></b><b>Referenced in:</b> <ul> <li><a href="#ref-for-csslayerstatementrule">8.3. The CSSLayerStatementRule interface</a> </ul> </aside> <aside class="dfn-panel" data-for="dom-csslayerstatementrule-namelist"> <b><a href="#dom-csslayerstatementrule-namelist">#dom-csslayerstatementrule-namelist</a></b><b>Referenced in:</b> <ul> <li><a href="#ref-for-dom-csslayerstatementrule-namelist">8.3. The CSSLayerStatementRule interface</a> </ul> </aside> <script>/* script-caniuse-panel */ window.addEventListener("load", function(){ var panels = [].slice.call(document.querySelectorAll(".caniuse-status")); for(var i = 0; i < panels.length; i++) { var panel = panels[i]; var dfn = document.querySelector("#" + panel.getAttribute("data-dfn-id")); var rect = dfn.getBoundingClientRect(); panel.style.top = (window.scrollY + rect.top) + "px"; } }); document.body.addEventListener("click", function(e) { if(e.target.classList.contains("caniuse-panel-btn")) { e.target.parentNode.classList.toggle("wrapped"); } });</script> <script>/* script-dfn-panel */ document.body.addEventListener("click", function(e) { var queryAll = function(sel) { return [].slice.call(document.querySelectorAll(sel)); } // Find the dfn element or panel, if any, that was clicked on. var el = e.target; var target; var hitALink = false; while(el.parentElement) { if(el.tagName == "A") { // Clicking on a link in a <dfn> shouldn't summon the panel hitALink = true; } if(el.classList.contains("dfn-paneled")) { target = "dfn"; break; } if(el.classList.contains("dfn-panel")) { target = "dfn-panel"; break; } el = el.parentElement; } if(target != "dfn-panel") { // Turn off any currently "on" or "activated" panels. queryAll(".dfn-panel.on, .dfn-panel.activated").forEach(function(el){ el.classList.remove("on"); el.classList.remove("activated"); }); } if(target == "dfn" && !hitALink) { // open the panel var dfnPanel = document.querySelector(".dfn-panel[data-for='" + el.id + "']"); if(dfnPanel) { dfnPanel.classList.add("on"); var rect = el.getBoundingClientRect(); dfnPanel.style.left = window.scrollX + rect.right + 5 + "px"; dfnPanel.style.top = window.scrollY + rect.top + "px"; var panelRect = dfnPanel.getBoundingClientRect(); var panelWidth = panelRect.right - panelRect.left; if(panelRect.right > document.body.scrollWidth && (rect.left - (panelWidth + 5)) > 0) { // Reposition, because the panel is overflowing dfnPanel.style.left = window.scrollX + rect.left - (panelWidth + 5) + "px"; } } else { console.log("Couldn't find .dfn-panel[data-for='" + el.id + "']"); } } else if(target == "dfn-panel") { // Switch it to "activated" state, which pins it. el.classList.add("activated"); el.style.left = null; el.style.top = null; } }); </script> <script>/* script-mdn-anno */ document.body.addEventListener("click", (e) => { if(e.target.closest(".mdn-anno-btn")) { e.target.closest(".mdn-anno").classList.toggle("wrapped"); } }); </script><a class='link-error' href='/date/2022-08-04T14:57:41/bikeshed/css-cascade-5/' id='generator' title='Bikeshed Link Errors'><svg height='24' viewbox='0 0 100 100' width='24'><g stroke="blue" stroke-width="6" fill="none"><path fill="blue" stroke="none" d="M 5 95 L 5 35 L 50 10 L 50 95"/><path d="M 1 37 L 54 8"/><path fill="blue" stroke="none" d="M 1 40 v -6 l 60 -32 v 6 z" /><circle cx="75" cy="79" r="15" /><circle fill="blue" stroke="none" cx="75" cy="79" r="4" /><path d="M 75 79 L 65 49 L 55 49" /><path d="M 67 55 L 48 69" /></g></svg></a>