CSSPrimitiveValue

已弃用：此功能不再推荐。虽然一些浏览器可能仍然支持它，但它可能已被从相关的 Web 标准中删除，可能正在被删除，或者可能仅出于兼容性目的而保留。避免使用它，并尽可能更新现有代码；请参阅本页面底部的兼容性表，以指导您的决定。请注意，此功能可能随时停止工作。

CSSPrimitiveValue 接口派生自 CSSValue 接口，表示 CSS 属性的当前计算值。

注意：此接口是创建类型化 CSS 对象模型的尝试的一部分。该尝试已被放弃，大多数浏览器并未实现它。

要实现您的目的，您可以使用

广泛支持的非类型化 CSS 对象模型，或
现代 CSS 类型化对象模型 API，支持度较低，被认为是实验性的。

此接口表示单个 CSS 值。它可用于确定当前在块中设置的特定样式属性的值，或在块中显式设置特定样式属性。此接口的实例可以从 getPropertyCSSValue() 方法获得 CSSStyleDeclaration 接口。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`	该值为以弧度为单位的 `<angle>`。该值可以使用 `getFloatValue()` 方法获取。
`CSS_HZ`	该值为以赫兹为单位的 `<frequency>`。该值可以使用 getFloatValue 方法获取。
`CSS_IDENT`	该值为标识符。该值可以使用 `getStringValue()` 方法获取。
`CSS_IN`	该值为以英寸为单位的 `<length>`。该值可以使用 `getFloatValue()` 方法获取。
`CSS_KHZ`	该值为以千赫兹为单位的 `<frequency>`。该值可以使用 `getFloatValue()` 方法获取。
`CSS_MM`	该值为以毫米为单位的 `<length>`。该值可以使用 `getFloatValue()` 方法获取。
`CSS_MS`	该值为以毫秒为单位的 `<time>`。该值可以使用 `getFloatValue()` 方法获取。
`CSS_NUMBER`	该值为简单的 `<number>`。该值可以使用 `getFloatValue()` 方法获取。
`CSS_PC`	该值为以皮卡为单位的 `<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。

CSSPrimitiveValue

实例属性

实例方法

规范

浏览器兼容性

另请参见