Recursive mixins in SASS

Introduction

Recursive mixins help you repeat a style or calculation many times without writing it over and over. They save time and keep your code clean.

When you want to create repeating patterns like nested boxes or shapes.

When you need to generate a series of styles that depend on a number, like spacing or colors.

When you want to build complex layouts that grow step by step.

When you want to avoid writing the same code multiple times for similar elements.

When you want to create animations or effects that repeat with small changes.

Syntax

SASS

@mixin mixin-name($count) {
  @if $count > 0 {
    // Your styles here
    @include mixin-name($count - 1);
  }
}

The mixin calls itself with a smaller number until it reaches zero.

Use @if to stop the recursion and avoid infinite loops.

Examples

This mixin demonstrates recursion by setting box-shadow with decreasing blur radius ($count * 2px) each time. However, only the final declaration (smallest blur when $count=1) applies, as later ones override earlier ones.

SASS

@mixin box-shadow-recursive($count) {
  @if $count > 0 {
    box-shadow: 0 0 #{ $count * 2 }px rgba(0, 0, 0, 0.1);
    @include box-shadow-recursive($count - 1);
  }
}

This mixin demonstrates recursion by setting decreasing padding values ($count rem). However, only the final (smallest) padding applies due to overriding.

SASS

@mixin padding-recursive($count) {
  @if $count > 0 {
    padding: #{ $count }rem;
    @include padding-recursive($count - 1);
  }
}

Shows what happens if no styles are added during recursion (nothing visible).

SASS

@mixin empty-recursive($count) {
  @if $count > 0 {
    // No styles here
    @include empty-recursive($count - 1);
  }
}

Sample Program

This code applies a recursive mixin to create multiple border and padding declarations with lightness scaled by $count (higher count = lighter). Due to CSS overriding, only the deepest recursion's styles apply: 1px solid border at ~10% lightness (dark gray) and 0.5rem padding.

SASS

@use "sass:color";

@mixin recursive-border($count) {
  @if $count > 0 {
    border: 1px solid color.scale(black, $lightness: $count * 10%);
    padding: 0.5rem;
    @include recursive-border($count - 1);
  }
}

.box {
  @include recursive-border(3);
  background-color: #eee;
  width: 10rem;
  height: 10rem;
}

Important Notes

Recursive mixins run until the stop condition is met, so always include a condition like @if $count > 0.

Too many recursive calls can slow down your CSS compilation.

Use recursion when you want to generate repeated styles that depend on a number, but for simple repeats, loops might be easier.

Summary

Recursive mixins call themselves to repeat styles multiple times.

Always include a stop condition to avoid infinite loops.

Useful for creating layered or repeated styles that change step by step.

Practice

1. What is the main purpose of a recursive mixin in sass?

easy

A. To call itself repeatedly to apply styles multiple times

B. To import external CSS files

C. To define variables for colors

D. To create animations with keyframes

Solution

1. Step 1: Understand what recursion means in programming

   Recursion means a function or mixin calls itself to repeat an action.

2. Step 2: Apply this to sass mixins

   A recursive mixin calls itself to repeat styles multiple times, often with changes each time.

3. Final Answer:

   To call itself repeatedly to apply styles multiple times -> Option A

4. Quick Check:

   Recursive mixin = repeated self-call [OK]

Hint: Recursive mixins repeat styles by calling themselves [OK]

Common Mistakes:

• Confusing recursion with importing files
• Thinking mixins only define variables
• Mixing up animations with recursion

2. Which of the following is the correct syntax to define a recursive mixin in sass?

easy

A. @mixin repeat($n) { color: red; @include repeat($n + 1); }

B. @mixin repeat($n) { @if $n > 0 { color: red; @include repeat($n - 1); } }

C. @mixin repeat { @include repeat; }

D. @mixin repeat($n) { @if $n < 0 { @include repeat($n - 1); } }

Solution

1. Step 1: Check for stop condition in mixin

   @mixin repeat($n) { @if $n > 0 { color: red; @include repeat($n - 1); } } uses @if $n > 0 to stop recursion when $n reaches 0.

2. Step 2: Verify recursive call decreases $n

   @mixin repeat($n) { @if $n > 0 { color: red; @include repeat($n - 1); } } calls itself with $n - 1, moving towards stop condition.

3. Final Answer:

   @mixin repeat($n) { @if $n > 0 { color: red; @include repeat($n - 1); } } -> Option B

4. Quick Check:

   Stop condition + decrement = correct recursion [OK]

Hint: Look for stop condition and decrement in recursive mixin [OK]

Common Mistakes:

• Missing stop condition causing infinite loop
• Incrementing instead of decrementing parameter
• Calling mixin without parameters

3. Given the following recursive mixin, what will be the color of the text inside .box after compilation?

@mixin colorLayers($n) {
  @if $n > 0 {
    color: lighten(blue, $n * 10%);
    @include colorLayers($n - 1);
  }
}

.box {
  @include colorLayers(2);
}

medium

A. The text color will be pure blue

B. There will be a syntax error and no color applied

C. The text color will be dark blue

D. The text color will be a light blue shade (lightened twice)

Solution

1. Step 1: Understand the recursion steps

   The mixin calls itself twice: first with $n=2, then $n=1, then stops at 0.

2. Step 2: Analyze color changes

   Each call applies color: lighten(blue, $n * 10%). So first lighten by 20%, then by 10%.

3. Final Answer:

   The text color will be a light blue shade (lightened twice) -> Option D

4. Quick Check:

   Recursive lighten steps = light blue [OK]

Hint: Trace recursive calls and their style effects stepwise [OK]

Common Mistakes:

• Assuming only one color applied
• Ignoring recursive layering of styles
• Thinking recursion causes error here

4. Identify the error in this recursive mixin and choose the fix:

@mixin borderLayers($count) {
  border: 1px solid black;
  @include borderLayers($count - 1);
}

medium

A. Missing stop condition; add @if $count > 0 before recursive call

B. Wrong parameter name; change $count to $n

C. Use @extend instead of @include

D. No error; code is correct

Solution

1. Step 1: Check for stop condition

   The mixin calls itself without any condition, causing infinite recursion.

2. Step 2: Fix by adding stop condition

   Adding @if $count > 0 before recursive call stops recursion when count reaches 0.

3. Final Answer:

   Missing stop condition; add @if $count > 0 before recursive call -> Option A

4. Quick Check:

   Stop condition prevents infinite recursion [OK]

Hint: Always add stop condition to recursive mixins [OK]

Common Mistakes:

• Forgetting stop condition
• Confusing @include with @extend
• Changing parameter names unnecessarily

5. You want to create a recursive mixin that adds nested box shadows with increasing blur. Which of these mixins correctly applies 3 layers of shadows with blur increasing by 2px each time?

hard

A. @mixin shadowLayers($n, $blur: 2) { @if $n < 0 { box-shadow: 0 0 #{$blur}px rgba(0,0,0,0.3); @include shadowLayers($n + 1, $blur + 2); } }

B. @mixin shadowLayers($n) { box-shadow: 0 0 2px rgba(0,0,0,0.3); @include shadowLayers($n - 1); }

C. @mixin shadowLayers($n, $blur: 2) { @if $n > 0 { box-shadow: 0 0 #{$blur}px rgba(0,0,0,0.3); @include shadowLayers($n - 1, $blur + 2); } }

D. @mixin shadowLayers($n, $blur: 2) { box-shadow: 0 0 #{$blur}px rgba(0,0,0,0.3); }

Solution

1. Step 1: Check for stop condition and parameter updates

   @mixin shadowLayers($n, $blur: 2) { @if $n > 0 { box-shadow: 0 0 #{$blur}px rgba(0,0,0,0.3); @include shadowLayers($n - 1, $blur + 2); } } has @if $n > 0 to stop recursion and increments blur by 2 each call.

2. Step 2: Verify recursive call and shadow layering

   @mixin shadowLayers($n, $blur: 2) { @if $n > 0 { box-shadow: 0 0 #{$blur}px rgba(0,0,0,0.3); @include shadowLayers($n - 1, $blur + 2); } } calls itself with $n - 1 and increasing blur, layering shadows correctly 3 times.

3. Final Answer:

   @mixin shadowLayers($n, $blur: 2) { @if $n > 0 { box-shadow: 0 0 #{$blur}px rgba(0,0,0,0.3); @include shadowLayers($n - 1, $blur + 2); } } -> Option C

4. Quick Check:

   Stop condition + parameter increment = correct recursive layering [OK]

Hint: Use stop condition and increment parameters in recursion [OK]

Common Mistakes:

• No stop condition causing infinite recursion
• Wrong comparison operator in stop condition
• Not incrementing blur value each recursion