映射
階層
- 映射
建構函式
建構式 (constructor)
- new
Map (長度 (length): 數字 (number)): Map -
建立一個新的 Sass map。
⚠️ 注意！
map 的初始鍵值和值是未定義的。它們必須在訪問它們或將 map 傳回 Sass 之前，使用 設定鍵值 (setKey) 和 設定值 (setValue) 來設定。
範例
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 中（初始未定義的）鍵值對的數量。
回傳 Map
-
方法
取得鍵值 (getKey)
- 取得鍵值 (getKey)(索引 (index): 數字 (number)): LegacyValue
-
回傳位於索引值
index的鍵值對中的鍵。範例
// map is `(width: 300px, height: 100px)`
map.getKey(0); // width
map.getKey(1); // height拋出錯誤
如果
index小於 0 或大於等於此映射中的鍵值對數量，則拋出Error錯誤。參數
-
index: number
此映射中鍵值對的索引值（從 0 開始）。
回傳 LegacyValue
-
getLength
getValue
- getValue(index: number): LegacyValue
-
回傳位於索引值
index的鍵值對中的值。範例
// map is `(width: 300px, height: 100px)`
map.getValue(0); // 300px
map.getValue(1); // 100px拋出錯誤
如果
index小於 0 或大於等於此映射中的鍵值對數量，則拋出Error錯誤。參數
-
index: number
此映射中鍵值對的索引值（從 0 開始）。
回傳 LegacyValue
-
setKey
- setKey(index: number, key: LegacyValue): void
-
將位於索引值
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)拋出錯誤
如果
index小於 0 或大於等於此映射中的鍵值對數量，則拋出Error錯誤。參數
-
index: number
此映射中鍵值對的索引值（從 0 開始）。
-
key: LegacyValue
回傳 void
-
setValue
- 設定值(索引: 數字, 值: 舊版值): 無
-
將位於索引值
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)拋出錯誤
如果
index小於 0 或大於等於此映射中的鍵值對數量，則拋出Error錯誤。參數
-
index: number
此映射中鍵值對的索引值（從 0 開始）。
-
值: 舊版值
回傳 void
-
Sass 的映射類型。
⚠️ 注意！
此映射類型表示為鍵值對的列表，而不是從鍵到值的映射。 查找與給定鍵關聯的值的唯一方法是迭代映射並檢查該鍵。 通過此 API 建立的映射仍然禁止具有重複鍵。