Sass 的 map 类型

⚠️ 注意!

此 map 类型表示为键值对列表,而不是从键到值的映射。找到与给定键关联的值的唯一方法是遍历 map 并检查该键。通过此 API 创建的映射仍然禁止具有重复键。

层次结构

  • Map

构造函数

  • 创建一个新的 Sass 映射。

    ⚠️ 注意!

    映射的初始键和值未定义。在访问它们或将映射传递回 Sass 之前,必须使用 setKeysetValue 设置它们。

    示例

    const map = new sass.types.Map(2);
    map.setKey(0, new sass.types.String("width"));
    map.setValue(0, new sass.types.Number(300, "px"));
    map.setKey(1, new sass.types.String("height"));
    map.setValue(1, new sass.types.Number(100, "px"));
    map; // (width: 300px, height: 100px)

    参数

    • length: number

      映射中(最初未定义的)键/值对的数量。

    返回 Map

方法

  • 返回 index 处键/值对中的键。

    示例

    // map is `(width: 300px, height: 100px)`
    map.getKey(0); // width
    map.getKey(1); // height

    抛出

    Error 如果 index 小于 0 或大于或等于此映射中的对数。

    参数

    • index: number

      此映射中键/值对的(从 0 开始的)索引。

    返回 LegacyValue

  • 返回此映射中键/值对的数量。

    示例

    // map is `("light": 200, "medium": 400, "bold": 600)`
    map.getLength(); // 3

    // map is `(width: 300px, height: 100px)`
    map.getLength(); // 2

    返回 number

  • 返回 index 处键/值对中的值。

    示例

    // map is `(width: 300px, height: 100px)`
    map.getValue(0); // 300px
    map.getValue(1); // 100px

    抛出

    Error 如果 index 小于 0 或大于或等于此映射中的对数。

    参数

    • index: number

      此映射中键/值对的(从 0 开始的)索引。

    返回 LegacyValue

  • index 处键/值对中的值设置为 value

    示例

    // map is `("light": 200, "medium": 400, "bold": 600)`
    map.setValue(1, new sass.types.String("lighter"));
    map; // ("lighter": 200, "medium": 300, "bold": 600)

    抛出

    Error 如果 index 小于 0 或大于或等于此映射中的对数。

    参数

    • index: number

      此映射中键/值对的(从 0 开始的)索引。

    • key: LegacyValue

    返回 void

  • index 处键/值对中的值设置为 value

    示例

    // map is `("light": 200, "medium": 400, "bold": 600)`
    map.setValue(1, new sass.types.Number(300));
    map; // ("light": 200, "medium": 300, "bold": 600)

    抛出

    Error 如果 index 小于 0 或大于或等于此映射中的对数。

    参数

    • index: number

      此映射中键/值对的(从 0 开始的)索引。

    • value: LegacyValue

    返回 void