List

Sass's List-Typ.

⚠️ Vorsicht!

Die Methoden dieses Listentyps verwenden eine 0-basierte Indizierung, obwohl Listen innerhalb von Sass eine 1-basierte Indizierung verwenden. Diese Methoden unterstützen auch nicht die Verwendung negativer Zahlen, um rückwärts vom Ende der Liste zu indizieren.

Hierarchie

  • List

Konstruktoren

  • Erstellt eine neue Sass- Liste.

    ⚠️ Vorsicht!

    Die anfänglichen Werte der Listenelemente sind undefiniert. Diese Elemente müssen mit setValue gesetzt werden, bevor sie abgerufen oder die Liste zurück an Sass übergeben wird.

    Beispiel

    const list = new sass.types.List(3);
    list.setValue(0, new sass.types.Number(10, "px"));
    list.setValue(1, new sass.types.Number(15, "px"));
    list.setValue(2, new sass.types.Number(32, "px"));
    list; // 10px, 15px, 32px

    Parameter

    • length: number

      Die Anzahl der (anfänglich undefinierten) Elemente in der Liste.

    • Optional commaSeparator: boolean

      Wenn true, ist die Liste durch Kommas getrennt; andernfalls ist sie durch Leerzeichen getrennt. Standardmäßig true.

    Gibt List zurück

Methoden

  • Gibt die Anzahl der Elemente in der Liste zurück.

    Beispiel

    // list is `10px, 15px, 32px`
    list.getLength(); // 3

    // list is `1px solid`
    list.getLength(); // 2

    Gibt number zurück

  • Gibt true zurück, wenn diese Liste durch Kommas getrennt ist, und andernfalls false.

    Beispiel

    // list is `10px, 15px, 32px`
    list.getSeparator(); // true

    // list is `1px solid`
    list.getSeparator(); // false

    Gibt boolean zurück

  • Gibt das Element am Index index zurück oder undefined, wenn dieser Wert noch nicht gesetzt wurde.

    Beispiel

    // list is `10px, 15px, 32px`
    list.getValue(0); // 10px
    list.getValue(2); // 32px

    Wirft

    Error, wenn index kleiner als 0 oder größer oder gleich der Anzahl der Elemente in dieser Liste ist.

    Parameter

    • index: number

      Ein (0-basierter) Index in diese Liste.

    Gibt undefined | LegacyValue zurück

  • Legt fest, ob die Liste durch Kommas getrennt ist.

    Parameter

    • isComma: boolean

      true, um die Liste durch Kommas zu trennen, andernfalls false.

    Gibt void zurück

  • Setzt das Element am Index index auf value.

    Beispiel

    // list is `10px, 15px, 32px`
    list.setValue(1, new sass.types.Number(18, "px"));
    list; // 10px, 18px, 32px

    Wirft

    Error, wenn index kleiner als 0 oder größer oder gleich der Anzahl der Elemente in dieser Liste ist.

    Parameter

    • index: number

      Ein (0-basierter) Index in diese Liste.

    • value: LegacyValue

    Gibt void zurück