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