CSSPrimitiveValue - 表示 CSS 属性的当前计算值

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

该接口表示单个 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	该值是以梯度为单位表示的 <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	该值是以 pica 为单位表示的 <number>。可以使用 getFloatValue() 方法获取该值。
CSS_PERCENTAGE	该值是一个 <percentage>。可以使用 getFloatValue() 方法获取该值。
CSS_PT	该值是以 point 为单位表示的 <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	该值是一个 <uri>。可以使用 getStringValue() 方法获取该值。

方法

CSSPrimitiveValue.getCounterValue()

该方法用于获取 counter 值。如果该 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。

规范

规范	状态	备注
Document Object Model (DOM) Level 2 Style Specification CSSPrimitiveValue 的定义	已过时	初始定义

桌面浏览器兼容性

移动浏览器兼容性

相关链接

• CSSValue
• CSSValueList