sass:string
- Dart Sass
- since 1.23.0
- LibSass
- ✗
- Ruby Sass
- ✗
Only Dart Sass currently supports loading built-in modules with @use
. Users of other implementations must call functions using their global names instead.
string.quote($string)
quote($string) //=> string
Returns $string
as a quoted string.
string.insert($string, $insert, $index)
str-insert($string, $insert, $index) //=> string
Returns a copy of $string
with $insert
inserted at $index
.
SCSS Syntax
@debug string.insert("Roboto Bold", " Mono", 7); // "Roboto Mono Bold"
@debug string.insert("Roboto Bold", " Mono", -6); // "Roboto Mono Bold"
Sass Syntax
@debug string.insert("Roboto Bold", " Mono", 7) // "Roboto Mono Bold"
@debug string.insert("Roboto Bold", " Mono", -6) // "Roboto Mono Bold"
If of $index
is higher than the length of $string
, $insert
is added to the end. If $index
is smaller than the negative length of the string, $insert
is added to the beginning.
string.length($string)
str-length($string) //=> number
Returns the number of characters in $string
.
string.slice($string, $start-at, $end-at: -1)
str-slice($string, $start-at, $end-at: -1) //=> string
Returns the slice of $string
starting at index $start-at
and ending at index $end-at
(both inclusive).
SCSS Syntax
@debug string.slice("Helvetica Neue", 11); // "Neue"
@debug string.slice("Helvetica Neue", 1, 3); // "Hel"
@debug string.slice("Helvetica Neue", 1, -6); // "Helvetica"
Sass Syntax
@debug string.slice("Helvetica Neue", 11) // "Neue"
@debug string.slice("Helvetica Neue", 1, 3) // "Hel"
@debug string.slice("Helvetica Neue", 1, -6) // "Helvetica"
string.to-upper-case($string)
to-upper-case($string) //=> string
Returns a copy of $string
with the ASCII letters converted to upper case.
string.to-lower-case($string)
to-lower-case($string) //=> string
Returns a copy of $string
with the ASCII letters converted to lower case.
string.unique-id()
unique-id() //=> string
Returns a randomly-generated unquoted string that’s guaranteed to be a valid CSS identifier and to be unique within the current Sass compilation.
string.unquote($string)
unquote($string) //=> string
Returns $string
as an unquoted string. This can produce strings that aren’t valid CSS, so use with caution.