SassString

Sass's String-Typ.

Hierarchie

Konstruktoren

constructor

Accessor

asList hasBrackets hasQuotes isTruthy realNull sassLength separator text

Methoden

assertBoolean assertCalculation assertColor assertFunction assertMap assertMixin assertNumber assertString equals get hashCode sassIndexToListIndex sassIndexToStringIndex tryMap

Konstruktoren

constructor

  • Erstellt einen neuen String.

    Parameter

    • text: string

      Der Inhalt des Strings. Bei Anführungszeichen-Strings ist dies der semantische Inhalt – alle Escape-Sequenzen, die im Quelltext geschrieben wurden, werden zu ihren Unicode-Werten aufgelöst. Bei Strings ohne Anführungszeichen bleiben Escape-Sequenzen jedoch als literale Backslashes erhalten.

    • Optional options: {
          quotes?: boolean;
      }
      • Optional quotes?: boolean

        Ob der String Anführungszeichen hat. Standard ist true.

    Gibt SassString zurück

constructor

  • Erstellt einen leeren String.

    Parameter

    • Optional options: {
          quotes?: boolean;
      }
      • Optional quotes?: boolean

        Ob der String Anführungszeichen hat. Standard ist true.

    Gibt SassString zurück

Accessor

asList

  • get asList(): List<Value>

  • Dieser Wert als Liste.

    Alle SassScript-Werte können als Listen verwendet werden. Maps zählen als Listen von Paaren, und alle anderen Werte zählen als Listen mit einem einzelnen Wert.

    Gibt List<Value> zurück

    Eine unveränderliche Liste aus dem immutable-Paket.

hasBrackets

  • get hasBrackets(): boolean

  • Ob dieser Wert als Liste Klammern hat.

    Alle SassScript-Werte können als Listen verwendet werden. Maps zählen als Listen von Paaren, und alle anderen Werte zählen als Listen mit einem einzelnen Wert.

    Gibt boolean zurück

hasQuotes

isTruthy

  • get isTruthy(): boolean

  • Ob der Wert in einer @if-Anweisung und anderen Kontexten als true zählt.

    Gibt boolean zurück

realNull

sassLength

  • get sassLength(): number

  • Sass's Vorstellung von der Länge dieses Strings.

    Sass behandelt Strings als eine Reihe von Unicode-Codepunkten, während JavaScript sie als eine Reihe von UTF-16-Codeeinheiten behandelt. Beispielsweise ist das Zeichen U+1F60A SMILING FACE WITH SMILING EYES ein einzelner Unicode-Codepunkt, wird aber in UTF-16 als zwei Codeeinheiten (0xD83D und 0xDE0A) dargestellt. In JavaScript gibt "n😊b".length also 4 zurück, während in Sass string.length("n😊b") 3 zurückgibt.

    Gibt number zurück

separator

  • get separator(): ListSeparator

  • Der Trenner für diesen Wert als Liste.

    Alle SassScript-Werte können als Listen verwendet werden. Maps zählen als Listen von Paaren, und alle anderen Werte zählen als Listen mit einem einzelnen Wert.

    Gibt ListSeparator zurück

text

  • get text(): string

  • Der Inhalt des Strings.

    Bei Anführungszeichen-Strings ist dies der semantische Inhalt – alle Escape-Sequenzen, die im Quelltext geschrieben wurden, werden zu ihren Unicode-Werten aufgelöst. Bei Strings ohne Anführungszeichen bleiben Escape-Sequenzen jedoch als literale Backslashes erhalten.

    Dieser Unterschied ermöglicht es uns, zwischen Bezeichnern mit Escape-Sequenzen, wie url\u28 http://example.com\u29, und Strings ohne Anführungszeichen, die Zeichen enthalten, die in Bezeichnern ungültig sind, wie url(http://example.com), zu unterscheiden. Leider bedeutet dies auch, dass wir foo und f\6F\6F nicht als den gleichen String betrachten.

    Gibt zurück string

Methoden

assertBoolean

  • Wirft einen Fehler, wenn this kein SassBoolean ist.

    ⚠️ Vorsicht!

    Funktionen sollten generell isTruthy verwenden und keine booleschen Literale erzwingen.

    Parameter

    • Optional name: string

      Der Name des Funktionsarguments, von dem this stammt (ohne das $), falls es von einem Argument stammt. Wird für die Fehlermeldung verwendet.

    Gibt SassBoolean zurück

assertCalculation

assertColor

assertFunction

assertMap

  • Wirft einen Fehler, wenn this kein SassMap ist.

    Parameter

    • Optional name: string

      Der Name des Funktionsarguments, von dem this stammt (ohne das $), falls es von einem Argument stammt. Wird für die Fehlermeldung verwendet.

    Gibt SassMap zurück

assertMixin

assertNumber

assertString

equals

get

  • Gibt den Wert am Index index in diesem Wert als Liste zurück, oder undefined, wenn index für diese Liste ungültig ist.

    Alle SassScript-Werte können als Listen verwendet werden. Maps zählen als Listen von Paaren, und alle anderen Werte zählen als Listen mit einem einzelnen Wert.

    Dies ist eine Kurzform für this.asList.get(index), obwohl es in manchen Fällen effizienter sein kann.

    ⚠️ Vorsicht!

    Diese Methode verwendet dieselben Indexierungs-Konventionen wie das immutable-Paket: Im Gegensatz zu Sass ist der Index des ersten Elements 0, aber wie bei Sass werden negative Zahlen vom Ende der Liste indiziert.

    Parameter

    • index: number

    Gibt undefined | Value zurück

hashCode

sassIndexToListIndex

  • Konvertiert sassIndex in einen JavaScript-konformen Index für die Liste, die von asList zurückgegeben wird.

    Sass-Indizes sind einstellig, während JavaScript-Indizes nullbasiert sind. Sass-Indizes können auch negativ sein, um vom Ende der Liste zu indizieren.

    Wirft

    Error Wenn sassIndex keine Zahl ist, wenn diese Zahl keine ganze Zahl ist oder wenn diese ganze Zahl kein gültiger Index für asList ist.

    Parameter

    • sassIndex: Value

      Der Sass-Index für diesen Wert als Liste.

    • Optional name: string

      Der Name des Arguments sassIndex (ohne das $), wenn es von einem Argument stammt. Wird für die Fehlerberichterstattung verwendet.

    Gibt number zurück

sassIndexToStringIndex

  • Konvertiert sassIndex in einen JavaScript-Index für text.

    Sass-Indizes sind einsbasiert, während JavaScript-Indizes nullbasiert sind. Sass-Indizes können auch negativ sein, um vom Ende des Strings zu indizieren.

    Zusätzlich beziehen sich Sass-Indizes auf Unicode-Codepunkte, während sich JavaScript-String-Indizes auf UTF-16-Codeeinheiten beziehen. Beispielsweise ist das Zeichen U+1F60A SMILING FACE WITH SMILING EYES ein einzelner Unicode-Codepunkt, wird aber in UTF-16 als zwei Codeeinheiten (0xD83D und 0xDE0A) dargestellt. In JavaScript gibt "n😊b".charCodeAt(1) also 0xD83D zurück, während in Sass string.slice("n😊b", 1, 1) "😊" zurückgibt.

    Diese Funktion konvertiert Sass's Codepunkt-Indizes in JavaScript's Codeeinheiten-Indizes. Das bedeutet, dass sie O(n) in Bezug auf die Länge von text ist.

    Wirft

    Error – Wenn sassIndex keine Zahl ist, wenn diese Zahl keine Ganzzahl ist oder wenn diese Ganzzahl kein gültiger Index für diesen String ist.

    Parameter

    • sassIndex: Value
    • Optional name: string

    Gibt number zurück

tryMap