sass:string

Compatibilidade:
Sass de Dart
since 1.23.0
LibSass
✗
Sass de Ruby
✗

Atualmente apenas a Sass de Dart suporta carregar módulos embutidos com a @use. Os utilizadores de outras implementações devem chamar as funções usando os seus nomes globais.

string.quote($string)
quote($string) //=> string

Retorna $string como uma sequência de caracteres com aspas.

SCSS Syntax

@debug string.quote(Helvetica); // "Helvetica"
@debug string.quote("Helvetica"); // "Helvetica"

Sass Syntax

@debug string.quote(Helvetica)  // "Helvetica"
@debug string.quote("Helvetica")  // "Helvetica"

string.index($string, $substring)
str-index($string, $substring) //=> number

Retorna o primeiro índice da $substring na $string, ou null se $string não contiver a $substring.

SCSS Syntax

@debug string.index("Helvetica Neue", "Helvetica"); // 1
@debug string.index("Helvetica Neue", "Neue"); // 11

Sass Syntax

@debug string.index("Helvetica Neue", "Helvetica")  // 1
@debug string.index("Helvetica Neue", "Neue")  // 11

string.insert($string, $insert, $index)
str-insert($string, $insert, $index) //=> string

Retorna uma cópia da $string com $insert inserido no $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"

Se $index for maior do que o comprimento da $string, $insert é adicionado ao final. Se $index for menor do que o comprimento negativo da sequência de caracteres, $insert é adicionado ao início.

SCSS Syntax

@debug string.insert("Roboto", " Bold", 100); // "Roboto Bold"
@debug string.insert("Bold", "Roboto ", -100); // "Roboto Bold"

Sass Syntax

@debug string.insert("Roboto", " Bold", 100)  // "Roboto Bold"
@debug string.insert("Bold", "Roboto ", -100)  // "Roboto Bold"

string.length($string)
str-length($string) //=> number

Retorna o número de caracteres na $string.

SCSS Syntax

@debug string.length("Helvetica Neue"); // 14
@debug string.length(bold); // 4
@debug string.length(""); // 0

Sass Syntax

@debug string.length("Helvetica Neue")  // 14
@debug string.length(bold)  // 4
@debug string.length("")  // 0

string.slice($string, $start-at, $end-at: -1)
str-slice($string, $start-at, $end-at: -1) //=> string

Retorna a fatia da $string começando no índice $start-at e terminando no índice $end-at (ambos inclusos).

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.split($string, $separator, $limit: null) //=> list
Compatibilidade:
Sass de Dart
since 1.57.0
LibSass
✗
Sass de Ruby
✗

Retorna uma lista separada por vírgula de subsequência de caracteres de $string entre parênteses reto que são separados pelo $separator. Os $separator não são incluído nestas subsequência de caracteres.

Se $limit for um número 1 ou superior, este separa no máximo de $separator (se então retorna no máximo sequências de caracteres de $limit + 1). A última subsequência de caracteres contém o resto da sequência de caracteres, incluindo quaisquer $separator restantes:

SCSS Syntax

@debug string.split("Segoe UI Emoji", " "); // ["Segoe", "UI", "Emoji"]
@debug string.split("Segoe UI Emoji", " ", $limit: 1); // ["Segoe", "UI Emoji"]

Sass Syntax

@debug string.split("Segoe UI Emoji", " ")  // ["Segoe", "UI", "Emoji"]
@debug string.split("Segoe UI Emoji", " ", $limit: 1)  // ["Segoe", "UI Emoji"]

string.to-upper-case($string)
to-upper-case($string) //=> string

Retorna uma cópia de $string com as letras de ASCII convertidas para maiúsculas.

SCSS Syntax

@debug string.to-upper-case("Bold"); // "BOLD"
@debug string.to-upper-case(sans-serif); // SANS-SERIF

Sass Syntax

@debug string.to-upper-case("Bold")  // "BOLD"
@debug string.to-upper-case(sans-serif)  // SANS-SERIF

string.to-lower-case($string)
to-lower-case($string) //=> string

Retorna uma cópia de $string com as letras ASCII convertidas para minúsculas.

SCSS Syntax

@debug string.to-lower-case("Bold"); // "bold"
@debug string.to-lower-case(SANS-SERIF); // sans-serif

Sass Syntax

@debug string.to-lower-case("Bold")  // "bold"
@debug string.to-lower-case(SANS-SERIF)  // sans-serif

string.unique-id()
unique-id() //=> string

Retorna uma sequência de caracteres sem aspas gerada aleatoriamente que é garantido ser um identificador de CSS válido e ser único dentro da atual compilação de Sass.

SCSS Syntax

@debug string.unique-id(); // uabtrnzug
@debug string.unique-id(); // u6w1b1def

Sass Syntax

@debug string.unique-id(); // uabtrnzug
@debug string.unique-id(); // u6w1b1def

string.unquote($string)
unquote($string) //=> string

Retorna $string como uma sequência de caracteres sem aspas. Este pode produzir sequências de caracteres que não são CSS válidos, então use com cuidado.

SCSS Syntax

@debug string.unquote("Helvetica"); // Helvetica
@debug string.unquote(".widget:hover"); // .widget:hover

Sass Syntax

@debug string.unquote("Helvetica")  // Helvetica
@debug string.unquote(".widget:hover")  // .widget:hover