SassString
Иерархия
-
Значение
- SassString
Индекс
Конструкторы
Доступные свойства
Методы
Конструкторы
конструктор
-
new SassString(text: string, options?: {
quotes?: boolean;
}): SassString -
Создает новую строку.
Параметры
-
text: string
Содержимое строки. Для строковых значений с кавычками это семантическое содержимое - любые последовательности escape, которые были написаны в исходном тексте, разрешаются до их значений Unicode. Для необрамленных строк, однако, последовательности escape сохраняются как буквенные обратные слэши.
-
Optionaloptions: {
quotes?: boolean;
}-
Optionalquotes?: booleanУказывает, обрамлена ли строка кавычками. По умолчанию
true.
-
Возвращает SassString
-
конструктор
-
new SassString(options?: {
quotes?: boolean;
}): SassString -
Создает пустую строку.
Параметры
-
Optionaloptions: {
quotes?: boolean;
}-
Optionalquotes?: booleanУказывает, обрамлена ли строка кавычками. По умолчанию
true.
-
Возвращает SassString
-
Доступ к данным
asList
- get asList(): List<Значение>
-
Это значение в виде списка.
Все значения SassScript могут быть использованы как списки. Карты считаются списками пар, а все остальные значения считаются списками с одним элементом.
Возвращает List<Значение>
Неизменяемый список из
immutableпакета.
hasBrackets
- get hasBrackets(): boolean
-
Является ли это значение в виде списка со скобками.
Все значения SassScript могут быть использованы как списки. Карты считаются списками пар, а все остальные значения считаются списками с одним элементом.
Возвращает boolean
hasQuotes
- get hasQuotes(): boolean
-
Содержит ли эта строка кавычки.
Возвращает boolean
isTruthy
- get isTruthy(): boolean
-
Определяет, считается ли значение
trueв операторе@ifи других контекстах.Возвращает boolean
realNull
sassLength
- get sassLength(): number
-
Представление Sass длины этой строки.
Sass обрабатывает строки как последовательность кодов Юникода, в то время как JavaScript обрабатывает их как последовательность кодовых единиц UTF-16. Например, символ U+1F60A УЛЫБАЮЩИЙСЯ ЛИЦО С УЛЫБАЮЩИМИСЯ ГЛАЗАМИ — это один код Юникода, но в UTF-16 он представлен двумя кодовыми единицами (
0xD83Dи0xDE0A). Таким образом, в JavaScript,"n😊b".lengthвозвращает4, а в Sassstring.length("n😊b")возвращает3.Возвращает number
separator
- get separator(): РазделительСписка
-
Разделитель для этого значения в виде списка.
Все значения SassScript могут быть использованы как списки. Карты считаются списками пар, а все остальные значения считаются списками с одним элементом.
Возвращает РазделительСписка
text
- get text(): string
-
Содержимое строки.
Для строковых значений в кавычках это семантическое содержимое — любые управляющие последовательности, которые были записаны в исходном тексте, разрешаются до своих значений Юникода. Для необрамленных строк, однако, управляющие последовательности сохраняются как буквенные обратные косые черты.
Это различие позволяет нам различать идентификаторы с управляющими последовательностями, например,
url\u28 http://example.com\u29, и необрамленные строки, которые содержат символы, не являющиеся допустимыми в идентификаторах, например,url(http://example.com). К сожалению, это также означает, что мы не считаемfooиf\6F\6Fодной и той же строкой.Возвращает string
Методы
assertBoolean
- assertBoolean(name?: string): SassBoolean
-
Выбрасывает исключение, если
thisне является SassBoolean.Функции в целом должны использовать isTruthy вместо требования к литералу boolean.
Параметры
-
Optionalname: stringИмя аргумента функции
this, от которого он получен (без$), если он получен из аргумента. Используется для отладки ошибок.
Возвращает SassBoolean
-
assertCalculation
- assertCalculation(name?: string): SassCalculation
-
Выбрасывает исключение, если
thisне является SassCalculation.Параметры
-
Optionalname: stringИмя аргумента функции
this, от которого он получен (без$), если он получен из аргумента. Используется для отладки ошибок.
Возвращает SassCalculation
-
assertColor
assertFunction
- assertFunction(name?: string): SassFunction
-
Выбрасывает исключение, если
thisне является SassFunction.Параметры
-
Optionalname: stringИмя аргумента функции
this, от которого он получен (без$), если он получен из аргумента. Используется для отладки ошибок.
Возвращает SassFunction
-
assertMap
assertMixin
assertNumber
- assertNumber(name?: string): SassNumber
-
Выбрасывает исключение, если
thisне является объектом SassNumber.Параметры
-
Optionalname: stringИмя аргумента функции
this, от которого он получен (без$), если он получен из аргумента. Используется для отладки ошибок.
Возвращает SassNumber
-
assertString
- assertString(name?: string): SassString
-
Выбрасывает исключение, если
thisне является объектом SassString.Параметры
-
Optionalname: stringИмя аргумента функции
this, от которого он получен (без$), если он получен из аргумента. Используется для отладки ошибок.
Возвращает SassString
-
equals
get
- get(index: number): undefined | Value
-
Возвращает значение по индексу
indexв этом значении как список, илиundefined, еслиindexне действителен для этого списка.Все значения SassScript могут использоваться как списки. Карты считаются списками пар, а все другие значения считаются списками с одним элементом.
Это краткая запись для
this.asList.get(index), хотя в некоторых случаях это может быть более эффективным.Этот метод использует те же соглашения об индексации, что и пакет
immutable: в отличие от Sass, индекс первого элемента равен 0, но, как и в Sass, отрицательные числа индексируют с конца списка.Параметры
-
index: number
Возвращает undefined | Value
-
hashCode
- hashCode(): number
-
Возвращает код хэша, который может быть использован для хранения
thisв хэш-таблице.Возвращает number
sassIndexToListIndex
- sassIndexToListIndex(sassIndex: Value, name?: string): number
-
Преобразует
sassIndexв индекс в стиле JavaScript для списка, возвращаемого asList.Индексы Sass — однобазовые, а индексы JavaScript — нулевые. Индексы Sass также могут быть отрицательными, чтобы индексировать с конца списка.
Выбрасывает
Error, еслиsassIndexне является числом, если это число не является целым числом или если это целое число не является допустимым индексом для asList.Параметры
-
sassIndex: Value
Индекс в стиле Sass для этого списка.
-
Optionalname: stringИмя аргумента функции
sassIndex, от которого он получен (без$), если он получен из аргумента. Используется для отладки ошибок.
Возвращает number
-
sassIndexToStringIndex
- sassIndexToStringIndex(sassIndex: Value, name?: string): number
-
Преобразует
sassIndexв индекс JavaScript в text.Индексы Sass — одноосновные, а индексы JavaScript — нулевые. Индексы Sass также могут быть отрицательными для индексирования с конца строки.
Кроме того, индексы Sass ссылаются на кодовые точки Unicode, а индексы строк JavaScript — на кодовые единицы UTF-16. Например, символ U+1F60A УЛЫБАЮЩИЙСЯ ЛИЦО С УЛЫБАЮЩИМИСЯ ГЛАЗАМИ является одной кодовой точкой Unicode, но в UTF-16 представлен двумя кодовыми единицами (
0xD83Dи0xDE0A). Поэтому в JavaScript,"n😊b".charCodeAt(1)возвращает0xD83D, тогда как в Sassstring.slice("n😊b", 1, 1)возвращает"😊".Эта функция преобразует индексы кодовых точек Sass в индексы кодовых единиц JavaScript. Это означает, что она имеет сложность O(n) по длине
text.Исключение
Error- ЕслиsassIndexне является числом, если это число не является целым числом или если это целое число не является допустимым индексом для этой строки.Параметры
-
sassIndex: Value
-
Optionalname: string
Возвращает number
-
tryMap
© 2006–2025 the Sass team, and numerous contributors
Licensed under the MIT License.
https://sass-lang.com/documentation/js-api/classes/SassString
Тип строки Sass'а тип строки.