Tutorial

Sass Lists

While this tutorial has content that we believe is of great benefit to our community, we have not yet tested or edited it to ensure you have an error-free learning experience. It's on our list, and we're working on it! You can help us out by using the "report an issue" button at the bottom of the tutorial.

Lists in Sass are very simply a series of items stored within a variable. Using a list enables you to keep words or keywords together. You can then access any of these items using the nth() function.

Lists can be delimited by either spaces or commas, and list items can either be unquoted, wrapped in single ’ or double quotes “. (Note: if you do wrap them in quotes you’ll need to use the unquote() function to remove them:

$colours: red green blue;
$padding: '10px', '20px', '30px';
$border: "solid" "dotted";

// nth takes the list name as 1st param
// and list item as the 2nd
div {
  background: nth($colours, 3);
  padding: nth($padding, 2); // "20px"
  border: 2px unquote(nth($border, 1));
}

Accessing each of the properties by remembering their position is not very efficient. If you wish to group similar variables (for example colours) then Sass Maps are better suited for this. Lists can be extremely useful when using Sass Loops.

Creative Commons License