sass:string module

Introduction

The sass:string module helps you work with text in your stylesheets. It lets you change, check, and combine words easily.

You want to join two words or phrases to make a new style name.

You need to check if a color name or keyword is part of a string.

You want to change text to uppercase or lowercase for consistency.

You want to cut a part of a string to use it somewhere else.

You want to count how many characters or words are in a string.

Syntax

SASS

@use 'sass:string';

string.function-name(arguments...)

Always start by loading the module with @use 'sass:string';.

Functions like string.length() or string.uppercase() help you work with text.

Examples

This changes 'hello' to 'HELLO'.

SASS

@use 'sass:string';

$string: string.uppercase('hello');

This counts how many characters are in 'Sass', which is 4.

SASS

@use 'sass:string';

$length: string.length('Sass');

This joins three strings into 'good morning'.

SASS

@use 'sass:string';

$joined: string.join(('good', ' ', 'morning'), '');

This finds where 'world' starts in the string, returning 7.

SASS

@use 'sass:string';

$contains: string.index('hello world', 'world');

Sample Program

This example uses the sass:string module to change text to uppercase, count characters, and join words. The results appear on the page using CSS content property.

SASS

@use 'sass:string';

$greeting: 'hello';
$shout: string.uppercase($greeting);
$length: string.length($greeting);
$full: string.join(($greeting, ' ', 'Sass learner!'), '');

body {
  font-family: Arial, sans-serif;
  padding: 1rem;
}

h1 {
  color: blue;
  content: $shout;
}

p {
  font-size: 1.2rem;
  color: gray;
}

/* Using CSS custom property to show length */
:root {
  --greeting-length: #{$length};
}

footer::after {
  content: 'Length of greeting: ' var(--greeting-length);
  display: block;
  margin-top: 1rem;
  font-style: italic;
  color: darkgreen;
}

/* Show full greeting in a paragraph */
p::before {
  content: "#{$full}";
}

Important Notes

Remember to always @use 'sass:string'; before calling its functions.

Functions return new strings; they do not change the original text.

You can combine these functions to create dynamic and flexible styles.

Summary

The sass:string module helps you work with text in Sass.

Use it to change case, join, find, or measure strings.

It makes your styles smarter and easier to manage.

Practice

1. What is the main purpose of the sass:string module in Sass?

easy

A. To handle layout grids and flexbox

B. To create animations using keyframes

C. To manipulate and work with text strings in Sass stylesheets

D. To manage colors and gradients

Solution

1. Step 1: Understand the module's role

   The sass:string module provides functions to work with text strings, such as changing case or joining strings.

2. Step 2: Compare with other options

   Options A, B, and C relate to layout, animations, and colors, which are not the focus of the string module.

3. Final Answer:

   To manipulate and work with text strings in Sass stylesheets -> Option C

4. Quick Check:

   sass:string = text manipulation [OK]

Hint: Remember sass:string is for text, not colors or layout [OK]

Common Mistakes:

• Confusing string module with color or layout modules
• Thinking it handles animations
• Assuming it manages Sass variables

2. Which of the following is the correct way to import the string module in Sass?

easy

A. @use 'sass:string';

B. @import 'string';

C. @require 'sass:string';

D. @include 'string';

Solution

1. Step 1: Recall Sass module import syntax

   Modern Sass uses @use to import modules, so @use 'sass:string'; is correct.

2. Step 2: Identify incorrect options

   @import is deprecated for modules, @require and @include are invalid for importing modules.

3. Final Answer:

   @use 'sass:string'; -> Option A

4. Quick Check:

   Use @use for modules [OK]

Hint: Use @use 'sass:string'; to import string module [OK]

Common Mistakes:

• Using @import instead of @use
• Trying @require or @include which are invalid
• Forgetting quotes around module name

3. What will be the output of this Sass code?

@use 'sass:string';

$word: 'Hello';
$result: string.to-upper-case($word);

.test {
  content: $result;
}

medium

A. .test { content: 'HELLO'; }

B. .test { content: 'hello'; }

C. .test { content: 'Hello'; }

D. Error: to-upper-case is not a function

Solution

1. Step 1: Understand the function used

   string.to-upper-case() converts all letters in the string to uppercase.

2. Step 2: Apply function to input

   Input is 'Hello', output becomes 'HELLO'. The CSS rule sets content to 'HELLO'.

3. Final Answer:

   .test { content: 'HELLO'; } -> Option A

4. Quick Check:

   to-upper-case('Hello') = 'HELLO' [OK]

Hint: to-upper-case makes all letters uppercase [OK]

Common Mistakes:

• Confusing to-upper-case with to-lower-case
• Expecting original string unchanged
• Thinking function is undefined

4. Identify the error in this Sass code using the string module:

@use 'sass:string';

$greeting: 'Hi';
$new: string.append($greeting, 123);

.test {
  content: $new;
}

medium

A. Missing semicolon after $greeting declaration

B. Cannot append a number directly to a string

C. Module name should be 'string-module' not 'sass:string'

D. Function name should be string.concat, not string.append

Solution

1. Step 1: Check function usage

   string.append() expects string arguments, but 123 is a number, causing a type error.

2. Step 2: Verify other syntax

   Semicolons are correct, module name and function name are valid as per Sass string module.

3. Final Answer:

   Cannot append a number directly to a string -> Option B

4. Quick Check:

   string.append needs strings, not numbers [OK]

Hint: Append only strings, convert numbers first [OK]

Common Mistakes:

• Passing numbers without converting to strings
• Confusing function names
• Incorrect module import syntax

5. You want to create a Sass function that takes a string and returns it with the first letter capitalized and the rest lowercase. Which of these code snippets correctly uses the sass:string module to achieve this?

hard

A. @use 'sass:string';

@function capitalize($text) {
@return string.to-lower-case($text);
}

B. @use 'sass:string';

@function capitalize($text) {
@return string.to-lower-case(string.slice($text, 1, 1)) + string.to-upper-case(string.slice($text, 2));
}

C. @use 'sass:string';

@function capitalize($text) {
@return string.to-upper-case($text);
}

D. @use 'sass:string';

@function capitalize($text) {
@return string.to-upper-case(string.slice($text, 1, 1)) + string.to-lower-case(string.slice($text, 2));
}

Solution

1. Step 1: Understand the goal

   The function must uppercase the first letter and lowercase the rest of the string.

2. Step 2: Analyze each option

   @use 'sass:string'; @function capitalize($text) { @return string.to-upper-case(string.slice($text, 1, 1)) + string.to-lower-case(string.slice($text, 2)); } correctly slices the first character, uppercases it, then slices the rest and lowercases it, joining both parts.
   @use 'sass:string'; @function capitalize($text) { @return string.to-lower-case(string.slice($text, 1, 1)) + string.to-upper-case(string.slice($text, 2)); } reverses cases incorrectly.
   @use 'sass:string'; @function capitalize($text) { @return string.to-upper-case($text); } uppercases whole string.
   @use 'sass:string'; @function capitalize($text) { @return string.to-lower-case($text); } lowercases whole string.

3. Final Answer:

   Capitalizes the first letter and lowercases the rest -> Option D

4. Quick Check:

   First letter uppercase + rest lowercase = slice(1,1) upper + slice(2) lower [OK]

Hint: Slice first char uppercase, rest lowercase, then join [OK]

Common Mistakes:

• Applying case functions to whole string only
• Mixing up upper and lower case parts
• Not slicing string correctly