@forward directive for re-exporting in SASS

Introduction

The @forward directive lets you share styles from one Sass file to another easily. It helps organize your styles by re-exporting them.

You want to create a single file that gathers styles from many Sass files.

You want to hide some details but still share main styles with others.

You want to keep your styles organized in small files but use them together.

You want to avoid repeating imports in many files by forwarding them once.

Syntax

SASS

@forward "filename";

Use quotes around the filename, just like with @use.

The filename should be a Sass partial or full Sass file without the extension.

Examples

This forwards all styles from _colors.scss, making them available to other files that @use this file.

SASS

@forward "colors";

This forwards styles from _buttons.scss, so other files can use them by @use-ing this file.

SASS

@forward "buttons";

This forwards mixins from _mixins.scss for reuse.

SASS

@forward "mixins";

Sample Program

This example shows a main Sass file forwarding variables from _colors.scss. The button style uses the forwarded $primary-color variable.

SASS

@forward "colors";

.button {
  background-color: $primary-color;
  color: white;
  padding: 1rem 2rem;
  border-radius: 0.5rem;
}

/* _colors.scss file content:
$primary-color: #3498db;
*/

Important Notes

Forwarding is different from importing: @forward re-exports styles for others to use, while @use imports styles for the current file.

You can forward multiple files in one file to create a style library.

Use partial files (starting with underscore) for files you forward.

Summary

@forward shares styles from one Sass file to another.

It helps organize and reuse styles without repeating imports.

Use it to create clean, maintainable style libraries.

Practice

1. What is the main purpose of the @forward directive in Sass?

easy

A. To share styles from one Sass file to another without importing repeatedly

B. To import CSS files directly into Sass

C. To compile Sass files into CSS

D. To define variables inside a Sass file

Solution

1. Step 1: Understand the role of @forward

   The @forward directive allows one Sass file to share its styles with another file, acting like a re-export.

2. Step 2: Compare with other options

   Options B, C, and D describe different Sass features: importing CSS, compiling Sass, and defining variables, which are not the main purpose of @forward.

3. Final Answer:

   To share styles from one Sass file to another without importing repeatedly -> Option A

4. Quick Check:

   @forward shares styles = A [OK]

Hint: Remember: @forward re-exports styles, not imports or compiles [OK]

Common Mistakes:

• Confusing @forward with @import
• Thinking @forward compiles Sass
• Assuming @forward defines variables

2. Which of the following is the correct syntax to forward a Sass file named _buttons.scss from _index.scss?

easy

A. @use "buttons";

B. @forward "_buttons.scss";

C. @forward "buttons";

D. @import "buttons";

Solution

1. Step 1: Identify correct syntax for @forward

   The @forward directive uses the file name without underscore and extension, so @forward "buttons"; is correct.

2. Step 2: Eliminate other options

   @forward "_buttons.scss"; incorrectly includes underscore and extension. @import "buttons"; uses @import, and @use "buttons"; uses @use, both different directives.

3. Final Answer:

   @forward "buttons"; -> Option C

4. Quick Check:

   Forward syntax excludes underscore and extension = D [OK]

Hint: Use file name without underscore or extension in @forward [OK]

Common Mistakes:

• Including underscore or .scss extension in @forward
• Confusing @forward with @import or @use
• Using wrong quotes or missing semicolon

3. Given these Sass files:

// _colors.scss
$primary: blue;

// _index.scss
@forward "colors";

// main.scss
@use "index";
.button {
  color: index.$primary;
}

What color will the button text be when compiled to CSS?

medium

A. undefined variable error

B. index.$primary

C. blue

D. red

Solution

1. Step 1: Understand @forward and @use interaction

   The @forward "colors"; in _index.scss re-exports mixins, functions, and styles from colors, but NOT variables. Variables are never forwarded.

2. Step 2: Check variable access

   index.$primary is undefined because variables aren't forwarded. Compilation fails with an undefined variable error.

3. Final Answer:

   undefined variable error -> Option A

4. Quick Check:

   @forward does NOT forward variables = A [OK]

Hint: @forward shares mixins/functions/styles, NOT variables [OK]

Common Mistakes:

• Thinking @forward forwards variables
• Thinking @forward imports variables directly
• Confusing variable name with string

4. Consider this Sass code in _index.scss:

@forward "buttons";
@forward "buttons";

What will happen when compiling this Sass file?

medium

A. Styles from buttons are forwarded twice without error

B. Compilation error due to duplicate @forward

C. Only the first @forward works, second is ignored

D. Warning about duplicate forwarding but compiles

Solution

1. Step 1: Identify duplicate @forward usage

   Using @forward twice for the same file causes a compilation error because Sass forbids forwarding the same module multiple times.

2. Step 2: Understand Sass error behavior

   Sass will stop compiling and show an error about duplicate forwarding, so no styles are output.

3. Final Answer:

   Compilation error due to duplicate @forward -> Option B

4. Quick Check:

   Duplicate @forward causes error = B [OK]

Hint: Avoid forwarding the same file twice to prevent errors [OK]

Common Mistakes:

• Assuming duplicate forwards are ignored
• Expecting warnings instead of errors
• Confusing @forward with multiple imports

5. You have three Sass files:

// _colors.scss
$primary: blue;

// _buttons.scss
@forward "colors";

// _index.scss
@forward "buttons";

// main.scss
@use "index";
.button-special {
  color: index.$primary;
}

Why does main.scss fail to compile with an undefined variable error for index.$primary?

hard

A. Because _colors.scss is missing from @use in main.scss

B. Because @use cannot access variables from forwarded files

C. Because @forward only works with mixins, not variables

D. Because $primary is not forwarded from _buttons.scss explicitly

Solution

1. Step 1: Trace variable forwarding chain

   The variable $primary is defined in _colors.scss. _buttons.scss forwards colors but does not re-forward $primary explicitly to _index.scss.

2. Step 2: Understand forwarding visibility

   Since _buttons.scss forwards colors, but _index.scss only forwards buttons, $primary is not visible to main.scss via index namespace.

3. Final Answer:

   Because $primary is not forwarded from _buttons.scss explicitly -> Option D

4. Quick Check:

   Forward chain must include variable = A [OK]

Hint: Forward variables explicitly through each file to share them [OK]

Common Mistakes:

• Assuming forwarding is automatic through all layers
• Confusing @use with @forward behavior
• Thinking @forward shares all contents without explicit forwarding