CSSPrimitiveValue: getFloatValue() 方法

已棄用:此特性不再推薦。雖然某些瀏覽器可能仍然支援它,但它可能已經從相關的網路標準中刪除,可能正在刪除過程中,或者可能僅為相容性目的而保留。請避免使用它,如果可能,請更新現有程式碼;請參閱本頁底部的相容性表格以指導您的決策。請注意,此特性可能隨時停止工作。

getFloatValue() 方法是 CSSPrimitiveValue 介面的一部分,用於獲取指定單位的浮點數值。如果此 CSS 值不包含浮點數值或無法轉換為指定的單位,則會引發 DOMException

注意:此方法是建立型別化 CSS 物件模型(Typed CSS Object Model)嘗試的一部分。該嘗試已被放棄,大多數瀏覽器並未實現它。

要實現您的目的,您可以使用

語法

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 現在已處於標準軌道。

瀏覽器相容性