CSSPrimitiveValue: getFloatValue() 方法
已棄用:此特性不再推薦。雖然某些瀏覽器可能仍然支援它,但它可能已經從相關的網路標準中刪除,可能正在刪除過程中,或者可能僅為相容性目的而保留。請避免使用它,如果可能,請更新現有程式碼;請參閱本頁底部的相容性表格以指導您的決策。請注意,此特性可能隨時停止工作。
getFloatValue() 方法是 CSSPrimitiveValue 介面的一部分,用於獲取指定單位的浮點數值。如果此 CSS 值不包含浮點數值或無法轉換為指定的單位,則會引發 DOMException。
注意:此方法是建立型別化 CSS 物件模型(Typed CSS Object Model)嘗試的一部分。該嘗試已被放棄,大多數瀏覽器並未實現它。
要實現您的目的,您可以使用
- 廣泛支援的非型別化
CSS 物件模型,或 - 較少支援且被視為實驗性的現代
CSS 型別化物件模型 API。
語法
js
getFloatValue(unit)
引數
unit-
一個 `unsigned short`,表示單位型別的程式碼,值將以此單位返回。有效值為
常量 描述 CSS_CM該值為以釐米為單位的 <length>。CSS_DEG該值為以度為單位的 <angle>。CSS_DIMENSION該值為維度未知的 <number>。CSS_EMS該值為以 em 單位為單位的 <length>。CSS_EXS該值為以 ex 單位為單位的 <length>。CSS_GRAD該值為以 grad 為單位的 <angle>。CSS_HZ值為以 Hertz 為單位的 <frequency>。可以透過 getFloatValue 方法獲取值。CSS_IN該值為以英寸為單位的 <length>。CSS_KHZ該值為以千赫茲為單位的 <frequency>。CSS_MM該值為以毫米為單位的 <length>。CSS_MS該值為以毫秒為單位的 <time>。CSS_NUMBER該值為一個簡單的 <number>。CSS_PC該值為以 pica 為單位的 <length>。CSS_PERCENTAGE該值為一個 <percentage>。CSS_PT該值為以 point 為單位的 <length>。CSS_PX該值為以畫素為單位的 <length>。CSS_RAD該值為以弧度為單位的 <angle>。CSS_S該值為以秒為單位的 <time>。
返回值
指定單位下的 `float` 值。
異常
| 型別 | 描述 |
|---|---|
DOMException |
如果 CSS 值不包含浮點數值,或者浮點數值無法轉換為指定的單位,則會引發 `INVALID_ACCESS_ERR`。 |
示例
js
const cs = window.getComputedStyle(document.body);
const cssValue = cs.getPropertyCSSValue("margin-top");
console.log(cssValue.getFloatValue(CSSPrimitiveValue.CSS_CM));
規範
此功能最初定義在 DOM Style Level 2 規範中,但此後已從任何標準化工作中刪除。
它已被現代但不相容的 CSS 型別化物件模型 API 所取代,該 API 現在已處於標準軌道。
瀏覽器相容性
載入中…