CSSPrimitiveValue: setFloatValue() 方法

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

CSSPrimitiveValue 介面的 setFloatValue() 方法用於設定一個浮點數值。如果附加到此值的屬性無法接受指定的單位或浮點數值，則該值將保持不變，並會引發一個 DOMException。

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

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

語法

setFloatValue(unitType, floatValue)

一個 unsigned short，表示返回值的單位型別程式碼。有效值為：

常量	描述
`CSS_CM`	該值是釐米（centimeters）中的 `<length>`。
`CSS_DEG`	該值是度（degrees）中的 `<angle>`。
`CSS_DIMENSION`	該值是未知維度的 `<number>`。
`CSS_EMS`	該值是 em 單位中的 `<length>`。
`CSS_EXS`	該值是 ex 單位中的 `<length>`。
`CSS_GRAD`	該值是 grad 單位中的 `<angle>`。
`CSS_HZ`	值為以 Hertz 為單位的 `<frequency>`。可以透過 getFloatValue 方法獲取值。
`CSS_IN`	該值是英寸（inches）中的 `<length>`。
`CSS_KHZ`	該值是千赫（Kilohertz）中的 `<frequency>`。
`CSS_MM`	該值是毫米（millimeters）中的 `<length>`。
`CSS_MS`	該值是毫秒（milliseconds）中的 `<time>`。
`CSS_NUMBER`	該值是一個簡單的 `<number>`。
`CSS_PC`	該值是 pica 中的 `<length>`。
`CSS_PERCENTAGE`	該值是一個 `<percentage>`。
`CSS_PT`	該值是 point 中的 `<length>`。
`CSS_PX`	該值是畫素（pixels）中的 `<length>`。
`CSS_RAD`	該值是弧度（radians）中的 `<angle>`。
`CSS_S`	該值是秒（seconds）中的 `<time>`。

一個 float，表示新的浮點數值。

無（undefined）。

型別	描述
`DOMException`	如果 CSS 值不包含浮點數值，或者字串值無法轉換為指定的單位，則會引發 `INVALID_ACCESS_ERR`。如果此屬性是隻讀的，則會引發 `NO_MODIFICATION_ALLOWED_ERR`。

此功能最初定義在 DOM Style Level 2 規範中，但此後已從任何標準化工作中刪除。

它已被現代但不相容的 CSS 型別化物件模型 API 所取代，該 API 現在已處於標準軌道。

此頁面最後修改於 2025年6月23日，作者是 MDN 貢獻者。