Booleans are the logical values true
and false
. In addition their literal forms, booleans are returned by equality and relational operators, as well as many built-in functions like math.comparable()
and map.has-key()
.
@use "sass:math"; @debug 1px == 2px; // false @debug 1px == 1px; // true @debug 10px < 3px; // false @debug math.comparable(100px, 3in); // true
@use "sass:math" @debug 1px == 2px // false @debug 1px == 1px // true @debug 10px < 3px // false @debug math.comparable(100px, 3in) // true
You can work with booleans using boolean operators. The and
operator returns true
if both sides are true
, and the or
operator returns true
if either side is true
. The not
operator returns the opposite of a single boolean value.
@debug true and true; // true @debug true and false; // false @debug true or false; // true @debug false or false; // false @debug not true; // false @debug not false; // true
@debug true and true // true @debug true and false // false @debug true or false // true @debug false or false // false @debug not true // false @debug not false // true
You can use booleans to choose whether or not to do various things in Sass. The @if
rule evaluates a block of styles if its argument is true
:
@mixin avatar($size, $circle: false) { width: $size; height: $size; @if $circle { border-radius: $size / 2; } } .square-av { @include avatar(100px, $circle: false); } .circle-av { @include avatar(100px, $circle: true); }
@mixin avatar($size, $circle: false) width: $size height: $size @if $circle border-radius: $size / 2 .square-av @include avatar(100px, $circle: false) .circle-av @include avatar(100px, $circle: true)
.square-av { width: 100px; height: 100px; } .circle-av { width: 100px; height: 100px; border-radius: 50px; }
The if()
function returns one value if its argument is true
and another if its argument is false
:
@debug if(true, 10px, 30px); // 10px @debug if(false, 10px, 30px); // 30px
@debug if(true, 10px, 30px) // 10px @debug if(false, 10px, 30px) // 30px
Anywhere true
or false
are allowed, you can use other values as well. The values false
and null
are falsey, which means Sass considers them to indicate falsehood and cause conditions to fail. Every other value is considered truthy, so Sass considers them to work like true
and cause conditions to succeed.
For example, if you want to check if a string contains a space, you can just write string.index($string, " ")
. The string.index()
function returns null
if the string isn’t found and a number otherwise.
Some languages consider more values falsey than just false
and null
. Sass isn’t one of those languages! Empty strings, empty lists, and the number 0
are all truthy in Sass.
© 2006–2022 the Sass team, and numerous contributors
Licensed under the MIT License.
https://sass-lang.com/documentation/values/booleans