CSSPrimitiveValue

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

CSSPrimitiveValue 介面繼承自 CSSValue 介面，表示 CSS 屬性的當前計算值。

注意： 此介面曾是建立一個型別化 CSS 物件模型 (CSS Object Model) 的嘗試的一部分。該嘗試已被放棄，大多數瀏覽器都不支援它。

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

廣泛支援的非型別化 CSS 物件模型，或
較少支援且被視為實驗性的現代 CSS 型別化物件模型 API。

此介面表示單個 CSS 值。它可以用於確定某個塊中當前設定的特定樣式屬性的值，或在塊中顯式設定特定的樣式屬性。此介面的例項可以透過 CSSStyleDeclaration 介面的 getPropertyCSSValue() 方法獲得。CSSPrimitiveValue 物件僅在 CSS 屬性的上下文中出現。

絕對值之間允許轉換（例如，從毫米到釐米，從度到弧度，等等），但相對值之間不允許。（例如，畫素值不能轉換為釐米值。）百分比值不能轉換，因為它們相對於父值（或其他屬性值）。顏色百分比值有一個例外：由於顏色百分比值相對於 0-255 的範圍，因此顏色百分比值可以轉換為數字（另請參閱 RGBColor 介面）。

例項屬性

繼承其父級 CSSValue 的屬性.

CSSPrimitiveValue.primitiveType 只讀已棄用

一個 unsigned short，表示值的型別。可能的值包括：

常量	描述
`CSS_ATTR`	值為 `attr()` 函式。可以透過 `getStringValue()` 方法獲取值。
`CSS_CM`	值為以釐米為單位的 `<length>`。可以透過 `getFloatValue()` 方法獲取值。
`CSS_COUNTER`	值為 `計數器或計數器組` 函式。可以透過 `getCounterValue()` 方法獲取值。
`CSS_DEG`	值為以度為單位的 `<angle>`。可以透過 `getFloatValue()` 方法獲取值。
`CSS_DIMENSION`	值為具有未知單位的 `<number>`。可以透過 `getFloatValue()` 方法獲取值。
`CSS_EMS`	值為以 em 單位的 `<length>`。可以透過 `getFloatValue()` 方法獲取值。
`CSS_EXS`	值為以 ex 單位的 `<length>`。可以透過 `getFloatValue()` 方法獲取值。
`CSS_GRAD`	值為以 grad 為單位的 `<angle>`。可以透過 `getFloatValue()` 方法獲取值。
`CSS_HZ`	值為以 Hertz 為單位的 `<frequency>`。可以透過 getFloatValue 方法獲取值。
`CSS_IDENT`	值為識別符號。可以透過 `getStringValue()` 方法獲取值。
`CSS_IN`	值為以英寸為單位的 `<length>`。可以透過 `getFloatValue()` 方法獲取值。
`CSS_KHZ`	值為以 Kilohertz 為單位的 `<frequency>`。可以透過 `getFloatValue()` 方法獲取值。
`CSS_MM`	值為以毫米為單位的 `<length>`。可以透過 `getFloatValue()` 方法獲取值。
`CSS_MS`	值為以毫秒為單位的 `<time>`。可以透過 `getFloatValue()` 方法獲取值。
`CSS_NUMBER`	值為簡單的 `<number>`。可以透過 `getFloatValue()` 方法獲取值。
`CSS_PC`	值為以 pica 為單位的 `<length>`。可以透過 `getFloatValue()` 方法獲取值。
`CSS_PERCENTAGE`	值為 `<percentage>`。可以透過 `getFloatValue()` 方法獲取值。
`CSS_PT`	值為以點為單位的 `<length>`。可以透過 `getFloatValue()` 方法獲取值。
`CSS_PX`	值為以畫素為單位的 `<length>`。可以透過 `getFloatValue()` 方法獲取值。
`CSS_RAD`	值為以弧度為單位的 `<angle>`。可以透過 `getFloatValue()` 方法獲取值。
`CSS_RECT`	值為 `rect()` 函式。可以透過 `getRectValue()` 方法獲取值。
`CSS_RGBCOLOR`	值為 `<color>`。可以透過 `getRGBColorValue()` 方法獲取值。
`CSS_S`	值為以秒為單位的 `<time>`。可以透過 `getFloatValue()` 方法獲取值。
`CSS_STRING`	值為 `<string>`。可以透過 `getStringValue()` 方法獲取值。
`CSS_UNKNOWN`	值為未識別的 CSS2 值。只能透過 `cssText` 屬性獲取值。
`CSS_URI`	值為 `<url>`。可以透過 `getStringValue()` 方法獲取值。

例項方法

CSSPrimitiveValue.getCounterValue() 已棄用: 此方法用於獲取計數器值。如果此 CSS 值不包含計數器值，則會引發 DOMException。可以使用 Counter 介面修改相應的樣式屬性。
CSSPrimitiveValue.getFloatValue() 已棄用: 此方法用於獲取指定單位的浮點數值。如果此 CSS 值不包含浮點數值或無法轉換為指定的單位，則會引發 DOMException。
CSSPrimitiveValue.getRGBColorValue() 已棄用: 此方法用於獲取 RGB 顏色。如果此 CSS 值不包含 RGB 顏色值，則會引發 DOMException。可以使用 RGBColor 介面修改相應的樣式屬性。
CSSPrimitiveValue.getRectValue() 已棄用: 此方法用於獲取 Rect 值。如果此 CSS 值不包含 rect 值，則會引發 DOMException。可以使用 Rect 介面修改相應的樣式屬性。
CSSPrimitiveValue.getStringValue() 已棄用: 此方法用於獲取字串值。如果 CSS 值不包含字串值，則會引發 DOMException。
CSSPrimitiveValue.setFloatValue() 已棄用: 設定指定單位的浮點值的方法。如果與此值關聯的屬性無法接受指定的單位或浮點值，則該值將保持不變，並會引發 DOMException。
CSSPrimitiveValue.setStringValue() 已棄用: 使用指定單位設定字串值的方法。如果與此值關聯的屬性無法接受指定的單位或字串值，則該值將保持不變，並會引發 DOMException。

幫助改進 MDN

瞭解如何貢獻

此頁面最後修改於 ⁨2025年6月23日⁩ 16:41:39.000Z (2025年6月23日)，由 MDN 貢獻者編輯。

在 GitHub 上檢視此頁面 • 報告此內容的頁面的問題

CSSPrimitiveValue

例項屬性

例項方法

規範

瀏覽器相容性

另見

幫助改進 MDN