Compatibility: Dart Sass since 1.23.0 LibSass ✗ Ruby Sass ✗
目前只有 Dart Sass 支持使用 @use
加载内置模块。 其他实现的用户必须改为使用其全局名称调用函数。
string.quote($string)
quote($string) //=> string
将 $string
作为带引号的字符串返回。
SCSS Syntax
@debug string.quote(Helvetica); // "Helvetica"
@debug string.quote("Helvetica"); // "Helvetica"
string.index($string, $substring)
str-index($string, $substring) //=> number
返回 $string
中 $substring
的第一个 index,如果 $string
不包含 $substring
,则返回 null
。
SCSS 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
返回 $string
的副本,其中 $insert
插入到 $index
。
SCSS Syntax
@debug string.insert("Roboto Bold", " Mono", 7); // "Roboto Mono Bold"
@debug string.insert("Roboto Bold", " Mono", -6); // "Roboto Mono Bold"
如果 $index
大于 $string
的长度,则将 $insert
添加到末尾。 如果 $index
小于字符串的负长度,则将 $insert
添加到开头。
SCSS Syntax
@debug string.insert("Roboto", " Bold", 100); // "Roboto Bold"
@debug string.insert("Bold", "Roboto ", -100); // "Roboto Bold"
string.length($string)
str-length($string) //=> number
Returns the number of characters in $string
.
SCSS 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
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"
string.split($string, $separator, $limit: null) //=> list
Compatibility: Dart Sass since 1.57.0 LibSass ✗ Ruby Sass ✗
返回一个用括号括起来的逗号分隔的 $string
子字符串列表,这些子字符串由 $separator
分隔。 $separator
不包含在这些子字符串中。
如果 $limit
是一个数字 1
或更高,这将拆分最多那么多的 $separator
(因此最多返回 $limit + 1
个字符串)。 最后一个子字符串包含字符串的其余部分,包括任何剩余的 $separator
。
SCSS 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
返回 $string
的副本,其中 ASCII 字母转换为大写。
SCSS 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
返回 $string
的副本,其中 ASCII 字母转换为小写。
SCSS Syntax
@debug string.to-lower-case("Bold"); // "bold"
@debug string.to-lower-case(SANS-SERIF); // sans-serif
string.unique-id()
unique-id() //=> string
返回一个随机生成的不带引号的字符串,该字符串保证是有效的 CSS 标识符并且在当前 Sass 编译中是唯一的。
SCSS Syntax
@debug string.unique-id(); // uabtrnzug
@debug string.unique-id(); // u6w1b1def
string.unquote($string)
unquote($string) //=> string
将 $string
作为未加引号的字符串返回。 这会产生无效的 CSS 字符串,因此请谨慎使用。
SCSS Syntax
@debug string.unquote("Helvetica"); // Helvetica
@debug string.unquote(".widget:hover"); // .widget:hover