clones/sass
1
0
Fork 0
mirror of https://github.com/sass/sass.git synced 2024-09-21 10:37:22 +00:00
Code Issues Packages Projects Releases Wiki Activity
c338c4511c
sass/spec/style-rules.md
Natalie Weizenbaum d47003033f
Fix some bugs in the style rule and extend specs (#3847) 
* Adds style rules to the stylesheet when they're encountered rather
  than after all their children have run, so that nested rules appear
  after their parents.

* Removes private placeholder selectors from style rules *after*
  they've been extended by local extensions.

* Explicitly handle omitting placeholder-only selectors from the CSS
  generated by Resolving Extensions.

* Allow the current selector to come from copies created by bubbling.

* Properly handle keyframe blocks.
2024-04-23 23:41:03 +00:00

2.7 KiB
Raw Blame History

Style Rules

Table of Contents

Definitions

Current Style Rule

The current style rule is the CSS style rule that was created by the innermost execution of a style rule, @media rule, @supports rule, or unknown at-rule.

Current Keyframe Block

The current keyframe block is the CSS keyframe block that was created by the innermost execution of a style rule.

Semantics

To execute a style rule rule:

  • Let selector-text be the result of evaluating all interpolation in rule's selector.

  • Let parent be the current style rule, at-rule, or keyframe block if one exists, or the innermost if multiple exist.

  • If parent is a keyframe block, throw an error.

  • Otherwise, if parent is an unknown at-rule whose name without vendor prefixes is "keyframes":

    • Let selector be the result of parsing selector-text as a keyframe selector.

    • Append a keyframe block with selector selector to parent.

    • Evaluate each child of rule.

    • Cease evaluating rule.

  • Otherwise, if parent is a style rule whose stylesheet wasn't parsed as CSS:

    Checking whether rule's stylesheet is CSS ensures that the plain CSS behavior occurs even when plain CSS is evaluated in a Sass context, such as through a nested @import or a meta.load-css() call.

    • If selector contains one or more parent selectors and rule's stylesheet wasn't parsed as CSS, replace those parent selectors with the current style rule's selector and set selector to the result.

    • Otherwise, nest selector within the current style rule's selector using the descendant combinator and set selector to the result.

  • Otherwise, if selector contains one or more parent selectors and rule's stylesheet wasn't parsed as CSS, throw an error.

  • Let css be a CSS style rule with selector selector.

  • If parent is set and its stylesheet was parsed as CSS, append css to parent.

  • Otherwise, if there is a current at-rule, append css to its children.

  • Otherwise, append css to the current module's CSS.

  • Execute each child of rule.

  • If css contains any children and selector is bogus, throw an error.

  • Otherwise, if css contains no children, remove it from the current module's CSS.