SassList
階層
- 值
- SassList
建構子
建構式 (constructor)
- new
Sass (內容 (contents): 值 (Value)[] | List<值 (Value)>, 選項 (options)?: {List
brackets?: boolean;
separator?: ListSeparator;
}): SassList -
建立新的清單。
參數
-
contents: Value[] | List<Value>
清單的內容。這可以是一個普通的 JavaScript 陣列或來自
immutable套件 的不可變清單。 -
選用options: {
brackets?: boolean;
separator?: ListSeparator;
}-
選用brackets?: boolean清單是否具有方括號。預設為
false。 -
選用separator?: ListSeparator用於此清單元素之間的分隔符號。預設為
','。
-
回傳 SassList
-
constructor
- new
Sass (options?: {List
brackets?: boolean;
separator?: ListSeparator;
}): SassList -
建立空的清單。
參數
-
選用options: {
brackets?: boolean;
separator?: ListSeparator;
}-
選用brackets?: boolean清單是否具有方括號。預設為
false。 -
選用separator?: ListSeparator用於此清單元素之間的分隔符號。預設為
','。
-
回傳 SassList
-
存取子
asList
- get asList(): List<Value>
-
此值作為清單。
所有 SassScript 值都可以用作清單。映射計為成對清單，所有其他值計為單值清單。
回傳 List<Value>
一個來自
immutable套件 的不可變列表 (Immutable List)。
hasBrackets
- get hasBrackets(): boolean
-
此值作為列表是否帶有括號。
所有 SassScript 值都可以用作清單。映射計為成對清單，所有其他值計為單值清單。
回傳 boolean
isTruthy
- get isTruthy(): boolean
-
此值在
@if陳述式和其他上下文中是否視為true。回傳 boolean
realNull
方法
assertBoolean
- assert
Boolean (name?: string): SassBoolean -
如果
this不是 SassBoolean，則拋出錯誤。⚠️ 注意！
函式通常應使用 isTruthy，而不是要求字面上的布林值。
參數
-
選用name: string如果
this來自函式參數，則為函式參數的名稱（不含$）。用於錯誤報告。
回傳 SassBoolean
-
assertCalculation
- assert
Calculation (name?: string): SassCalculation -
如果
this不是 SassCalculation 就會拋出錯誤。參數
-
選用name: string如果
this來自函式參數，則為函式參數的名稱（不含$）。用於錯誤報告。
回傳 SassCalculation
-
assertColor
assertFunction
- assert
Function (name?: string): SassFunction -
如果
this不是 SassFunction 就會拋出錯誤。參數
-
選用name: string如果
this來自函式參數，則為函式參數的名稱（不含$）。用於錯誤報告。
回傳 SassFunction
-
assertMap
assertMixin
assertNumber
- assert
Number (name?: string): SassNumber -
如果`this`不是SassNumber，則拋出錯誤。
參數
-
選用name: string如果
this來自函式參數，則為函式參數的名稱（不含$）。用於錯誤報告。
回傳 SassNumber
-
assertString
- assert
String (name?: string): SassString -
如果`this`不是SassString，則拋出錯誤。
參數
-
選用name: string如果
this來自函式參數，則為函式參數的名稱（不含$）。用於錯誤報告。
回傳 SassString
-
equals
get
- get(index: number): undefined | Value
-
回傳此值在索引
index處的值作為列表，如果index對此列表無效，則回傳undefined。所有 SassScript 值都可以用作清單。映射計為成對清單，所有其他值計為單值清單。
這是
this.asList.get(index)的簡寫，但在某些情況下可能會更有效率。⚠️ 注意！
此方法使用與
immutable套件相同的索引慣例：與 Sass 不同，第一個元素的索引為 0，但與 Sass 相同，負數從列表的末尾開始索引。參數
-
index: number
回傳 undefined | Value
-
hashCode
sassIndexToListIndex
- sass
Index (sassIndex: Value, name?: string): numberTo List Index -
將
sassIndex轉換為 JavaScript 風格的索引，用於 asList 返回的列表。Sass 索引是從 1 開始的，而 JavaScript 索引是從 0 開始的。Sass 索引也可以是負數，以便從列表的末尾開始索引。
拋出
如果
sassIndex不是數字，如果該數字不是整數，或者如果該整數不是 asList 的有效索引，則拋出Error。參數
-
sassIndex: Value
Sass 風格的索引，將其視為列表。
-
選用name: string如果函數參數
sassIndex來自某個參數，則為該參數的名稱（不含$）。用於錯誤報告。
回傳 number
-
Sass 的列表類型。