CSS Typed Object Model API

接口

CSSStyleValue

CSS 类型化对象模型 API 的 CSSStyleValue 接口是所有通过类型化 OM API 访问的 CSS 值的基础类。此类的实例可以在任何期望字符串的地方使用。

CSSStyleValue.parse()

允许从 CSS 字符串构造 CSSNumericValue 的方法。它将指定的 CSS 属性设置为指定的值，并返回第一个值作为 CSSStyleValue 对象。

CSSStyleValue.parseAll()

设置特定 CSS 属性所有出现项为指定值的方法，并返回一个 CSSStyleValue 对象数组，每个对象包含一个提供的值。

StylePropertyMap

CSS 类型化对象模型 API 的 StylePropertyMap 接口提供了 CSS 声明块的表示，这是 CSSStyleDeclaration 的替代方案。

StylePropertyMap.set()

更改具有给定属性的 CSS 声明为给定值的方法。

StylePropertyMap.append()

向具有给定属性和值的 StylePropertyMap 添加新 CSS 声明的方法。

StylePropertyMap.delete()

从 StylePropertyMap 中删除具有给定属性的 CSS 声明的方法。

StylePropertyMap.clear()

删除 StylePropertyMap 中所有声明的方法。

CSSUnparsedValue

CSS 类型化对象模型 API 的 CSSUnparsedValue 接口表示引用自定义属性的属性值。它包含字符串片段和变量引用的列表。

CSSUnparsedValue() 构造函数

创建一个新的 CSSUnparsedValue 对象，该对象表示引用自定义属性的属性值。

CSSUnparsedValue.entries()

返回给定对象自身可枚举属性的 [key, value] 对的数组，顺序与 for...in 循环提供的顺序相同（区别在于 for-in 循环还会枚举原型链中的属性）。

CSSUnparsedValue.forEach()

为 CSSUnparsedValue 中的每个元素执行一次提供的函数的方法。

CSSUnparsedValue.keys()

返回一个包含数组中每个索引的键的新*数组迭代器*对象的方法。

CSSKeywordValue 序列化

CSS 类型化对象模型 API 的 CSSKeywordValue 接口创建一个对象来表示 CSS 关键字和其他标识符。

CSSKeywordValue() 构造函数

构造函数创建一个新的 CSSKeywordValue() 对象，该对象表示 CSS 关键字和其他标识符。

CSSKeywordValue.value()

CSSKeywordValue 接口的属性，用于返回或设置 CSSKeywordValue 的值。

CSSStyleValue 接口

CSSStyleValue 是所有 CSS 值表示的基础类。子类包括

CSSImageValue

一个表示需要图像的属性值的接口，例如 background-image、list-style-image 或 border-image-source。

CSSKeywordValue

一个创建对象来表示 CSS 关键字和其他标识符的接口。当在需要字符串的地方使用时，它将返回 CSSKeyword.value 的值。

CSSMathValue

一个子类树，表示比单个值和单位更复杂数值，包括

• CSSMathInvert - 表示用作 calc(1 / <value>) 的 CSS calc() 值。
• CSSMathMax - 表示 CSS max() 函数。
• CSSMathMin - 表示 CSS min() 函数。
• CSSMathNegate - 对传入的值进行取反。
• CSSMathProduct - 表示通过在 CSSNumericValue 上调用 add()、sub() 或 toSum() 获得的结果。
• CSSMathSum - 表示通过在 CSSNumericValue 上调用 add()、sub() 或 toSum() 获得的结果。

CSSNumericValue

一个表示所有数值都可以执行的操作的接口，包括

• CSSNumericValue.add - 将提供的数字添加到 CSSNumericValue。
• CSSNumericValue.sub - 从 CSSNumericValue 中减去提供的数字。
• CSSNumericValue.mul - 将提供的数字乘以 CSSNumericValue。
• CSSNumericValue.div - 用提供的值除以 CSSNumericValue，如果值为 0 则抛出错误。
• CSSNumericValue.min - 返回传递的最小值
• CSSNumericValue.max - 返回传递的最大值
• CSSNumericValue.equals - 如果所有值都是完全相同的类型和值，顺序也相同，则返回 true。否则返回 false
• CSSNumericValue.to - 将 value 转换为具有指定*单位*的其他值。
• CSSNumericValue.toSum
• CSSNumericValue.type
• CSSNumericValue.parse - 从 CSS 字符串解析数字并返回。

CSSPositionValue

表示需要位置的属性值，例如 object-position。

CSSTransformValue

一个表示 transform 列表值的接口。它们“包含”一个或多个 CSSTransformComponent，这些组件表示单个transform 函数值。

CSSUnitValue

一个表示可以表示为单个单位或命名数字和百分比的数值的接口。

CSSUnparsedValue

表示引用自定义属性的属性值。它包含字符串片段和变量引用的列表。

规范

浏览器兼容性

api.CSSStyleValue

api.StylePropertyMap

api.CSSUnparsedValue

api.CSSKeywordValue

另见

• CSS Painting API
• 使用 CSS 类型对象模型
• CSS Houdini