第 4 章: 基本数据类型和接口

4.1. 定义

初始值

属性或特性的初始值是在 未指定该属性或特性，或者其具有 无效值时使用的值。 此值用于渲染、计算 动画值， 以及通过 DOM 接口访问属性或特性时。

无效值

为特性指定的无效值，无论是在样式表 还是呈现属性中，是指根据 定义该特性值的语法不允许的值，或语法允许但 随后在文字说明中被禁止的值。具有无效值的 CSS 声明会被 忽略。

4.2. 属性语法

4.2.1. 实数精度

除非另有说明，SVG 属性以及定义为对 SVG 元素产生作用的 特性中的数值必须 至少支持宿主 架构支持的所有有限单精度值。

建议在坐标系统变换等操作中执行更高精度的浮点 存储和计算，以提供尽可能高的 精度并防止舍入误差。

符合规范的 SVG 查看器 必须根据其 一致性类别执行数值计算，如一致性标准中所述。

4.2.2. 钳制限制在特定范围内的值

某些数值属性和特性值具有受限的范围。 其他值将受设备能力的限制。 如果未另行指定， 用户代理应尽可能推迟任何超出范围的错误检查， 直到渲染过程中的尽可能后期。 这对于设备限制尤其重要， 因为复合操作 可能产生超出范围的中间值，但 最终值却位于范围内。

4.3. SVG DOM 概述

支持脚本执行的符合规范的SVG 查看器或SVG 解释器 必须按照本规范各处的定义实现 SVG DOM 接口， 并满足本节列出的特定要求和依赖项。

4.3.1. SVG DOM 支持的依赖项

SVG DOM 是依据 Web IDL 接口定义的。本规范中的所有 IDL 片段必须按照 Web IDL 规范中的描述， 解释为符合规范的 IDL 片段所要求的内容。[WebIDL]

SVG DOM 建立在多个 DOM 规范之上。具体而言：

• SVG DOM 要求完全支持 DOM， 其定义以本规范发布时 DOM 现行标准的最新审查草案 为准， 但此后已被移除或弃用的功能除外。 支持 DOM 的 SVG 软件应尽可能实现 最新 DOM 标准 [DOM]
• SVG DOM 要求支持 UI Events 和 Clipboard API 和事件的相关部分 ([uievents], [clipboard-apis])。 （有关所要求的特定功能，请参阅 与 UI Events 的关系。）
• SVG DOM 至少要求完全 支持 DOM Level 2 Style ([dom-level-2-style]) 中尚未从 CSS 对象模型 (CSSOM)规范中删除的所有接口。 SVG 软件应尽可能实现最新版本的 CSS 对象模型 (CSSOM) ([cssom-1])
• SVG DOM 要求完全支持 Geometry Interfaces Module Level 1 ([geometry-1])。

4.3.2. 命名约定

SVG DOM 遵循与 HTML 和 DOM 标准类似的命名约定 ([HTML], [DOM])。

所有名称均由一个或多个英文单词 连接在一起组成单个字符串。特性或 方法名称以小写的首个关键词开头，并且 后续每个单词都以大写字母开头。例如， 返回文档元信息（例如 文件创建日期）的特性可能命名为 "fileDateCreated"。

本规范中定义的接口名称几乎都以 "SVG" 开头。 表示 SVG 命名空间元素的 DOM Element 对象的接口 遵循 SVGElementNameElement 格式，其中 ElementName 是首字母大写的元素标签名称。 因此 SVGRadialGradientElement 是 ‘radialGradient’ 元素的接口。

此大小写约定的一个例外是 SVGSVGElement， 其中整个标签名称都大写。

4.3.3. SVG DOM 中的元素

任何被要求支持 SVG DOM 的 SVG 软件 都必须按如下方式增强为 SVG 文档 片段创建的 DOM 元素：

• 每个与受支持的 SVG 元素对应的 Element 对象（即， 命名空间 URI 为 "http://www.w3.org/2000/svg"，并且 本地名称是本规范 或软件实现的其他规范中所定义的元素之一） 还必须实现元素定义中指定的 DOM 接口。

• SVG 命名空间中本地名称与软件支持的任何规范 中所定义的元素均不匹配的元素， 仍必须实现 SVGElement 接口。

在‘rect’ 元素中， 指定了 SVGRectElement 接口。 这意味着每个命名空间 URI 为 "http://www.w3.org/2000/svg" 且本地名称为 "rect" 的 Element 对象还必须实现 SVGRectElement。

4.3.4. 在 DOM 中反映内容属性

许多 SVG DOM 特性（IDL 属性） 反映对应元素上的内容属性或特性， ， 这意味着内容属性和 IDL 属性表示相同的底层数据。 例如， SVGAnimatedLength ry 位于 SVGRectElement 中， 反映关联的 ry 呈现属性，该属性位于 ‘rect’ 元素上。

这种反映的方式取决于 IDL 属性的类型：

• 如果反映 IDL 属性的类型是 基本类型（例如 long，如 tabIndex 在 SVGElement 上的用法）或 DOMString（如 title 在 SVGStyleElement 上的用法）， 则使用 HTML 中 在 IDL 属性中反映 内容属性的规则。
• 如果反映 IDL 属性的类型是 SVGAnimatedBoolean、 SVGAnimatedString、SVGAnimatedEnumeration、SVGAnimatedNumber、 SVGAnimatedNumberList、SVGAnimatedLength、SVGAnimatedLengthList、 SVGAnimatedAngle、SVGAnimatedRect 或 SVGAnimatedPreserveAspectRatio， 则使用定义相应反映接口的 章节中的规则。

  从较高层面看，对象的 baseVal 用于反映内容属性的值。 对于反映 CSS 特性的对象，baseVal 用于 反映呈现属性。

此关系是实时的，并且在属性或其反映特性中的任一方被修改时， 值必须同步 （遵循同步反映值中的规则）。

如果该属性未在文档标记中显式指定， 反映对象仍会在访问时 初始化为该属性的初始值。 如果属性的初始值为 (none)， 则对象按 反映空初始值中的定义进行初始化。 此新构造的对象在 首次被修改之前不会在元素上生成属性。对相应 属性所做的修改会立即反映到对象中。

如果访问 lineElement.x1.baseVal （其中 lineElement 是 SVGLineElement 的实例） 且文档中未指定 ‘x1’ 属性，则返回的 SVGLength 对象将表示值 0 user units， 因为该属性的初始值为 0。

4.3.5. 同步反映值

每当反映的内容属性的基值发生变化时， 反映对象必须在值变化之后立即通过执行以下步骤 进行同步：

1. 如果反映对象是列表接口对象， 则运行同步 列表接口对象的步骤。
2. 否则，将对象的值更新为反映 内容属性的基值（如果该属性 不存在或无效，则使用属性的初始值）。

   例如，这会更新 value of an SVGLength 对象。

当一个反映的内容属性需要 重新序列化时，可选择使用 特定值，必须执行以下步骤：

1. 令 value 为给定的特定值，或者 如果未提供特定值，则为内容属性的反映 IDL 属性的值。
2. 根据 value 的类型：

   SVGAnimatedBoolean

   SVGAnimatedNumber

   SVGAnimatedLength

   SVGAnimatedAngle

   SVGAnimatedRect

   SVGAnimatedString

   SVGAnimatedNumberList

   SVGAnimatedLengthList

   SVGAnimatedTransformList

   使用 value 的 baseVal 成员 重新序列化内容属性。

   SVGAnimatedEnumeration

   1. 令 number 为 value 的 baseVal 成员的值。
   2. 令 keyword 为内容属性中与 number 对应的关键词 值；如果 number 为 0， 则为空字符串。

      这意味着如果枚举值 以某种方式被设置为“未知”值，内容属性将被 设置为空字符串。 但是，无法直接在 SVGAnimatedEnumeration 对象上设置此未知值； 它表示标记中设置的未知属性值。

   3. 将内容属性设置为 keyword。

   boolean

   如果 value 为 true，则将内容属性设置为 "true"， 否则设置为 "false"。

   float

   double

   将内容属性设置为一个特定于实现的字符串， 该字符串如果使用 CSS 语法解析为 <number>， 则在给定实现所支持的实数精度的情况下， 会返回最接近 value 的数值。

   SVGLength

   将内容属性设置为获取 value 的 valueAsString 成员时将返回的值。

   SVGAngle

   将内容属性设置为获取 value 的 valueAsString 成员时将返回的值。

   SVGRect

   1. 令 components 为四个值的列表，分别是 value 的 x、 y、 width 和 height 成员的值。
   2. 令 serialized components 为四个字符串的列表， 其中每个都是特定于实现的字符串，如果 使用 CSS 语法将其解析为 <number>，则在 给定实现所支持的实数精度的情况下， 会返回最接近 components 中对应值的数值。
   3. 将内容属性设置为由 serialized components 中的字符串组成并使用单个 U+0020 SPACE 字符连接和分隔的字符串。

   DOMString

   将内容属性设置为 value。

   SVGNumberList

   SVGLengthList

   SVGPointList

   SVGTransformList

   SVGStringList

   1. 令 elements 为 value 中的值列表。

      根据 value 的类型， 这些值将是 SVGNumber、SVGLength、 SVGPoint 或 SVGTransform 对象，或 DOMString 值。

   2. 令 serialized elements 为字符串列表，其中每个 字符串根据 elements 中相应的值 及其类型构成：

      一个 SVGNumber 对象

      该字符串是一个特定于实现的字符串，如果使用 CSS 语法将其解析为 <number>，则在给定 实现所支持的实数 精度的情况下，会返回最接近 SVGNumber 对象的 value 成员的数值。

      一个 SVGLength 对象

      该字符串是获取该值的 valueAsString 成员时将返回的值。

      一个 SVGPoint 对象

      字符串值按如下方式计算：

      1. 令 string 为空字符串。
      2. 令 x 和 y 分别为 SVGPoint 对象的 x 和 y 坐标值。
      3. 向 string 追加一个特定于实现的字符串， 如果使用 CSS 语法将其解析为 <number>， 则在给定实现所支持的实数 精度的情况下，会返回最接近 x 的数值。
      4. 向 string 追加一个 U+002C COMMA 字符。
      5. 向 string 追加一个特定于实现的字符串， 如果使用 CSS 语法将其解析为 <number>， 则在给定实现所支持的实数 精度的情况下，会返回最接近 y 的数值。
      6. 该字符串为 string。

      一个 SVGTransform 对象

      该字符串是 matrix 对象的序列化。

      一个 DOMString

      该字符串就是 DOMString 本身的值。

   3. 将内容属性设置为由 serialized elements 中的字符串组成并使用单个 U+0020 SPACE 字符连接和分隔的字符串。

4.3.6. 反映空初始值

当初始化一个反映 null 或空 初始值的 SVG DOM 属性时， 必须根据其数据类型初始化该特性， 如本节中所定义。 仅当反映的内容属性没有显式值， 并且属性定义表中的初始值为 (none) 时才会发生这种情况。

如果下面未列出某个接口，则意味着 对象初始化应使用该接口所包含对象的值进行，例如， SVGAnimatedString 由两个 DOMString 成员组成， 而 SVGRect 由多个 double 组成。

DOMString

初始化为空字符串（""）。

float

long

short

WebIDL 中定义的任何其他数值类型

初始化为 0。

boolean

初始化为 false。

SVGLength

初始化为 0 user units (SVG_LENGTHTYPE_NUMBER)。

SVGLengthList

SVGNumberList

SVGPointList

SVGStringList

SVGTransformList

初始化为空列表。

SVGAngle

初始化为 0 in unspecified units (SVG_ANGLETYPE_UNSPECIFIED)。

SVGPreserveAspectRatio

初始化为 'xMidYMid meet'。

如果访问 textElement.dx.baseVal （其中 textElement 是 SVGTextElement 的实例） 且文档中未指定 ‘dx’ 属性，则返回的 SVGLengthList 对象将为空。

4.3.7. 无效值

如果脚本将一个反映的 DOM 属性 设置为内容属性的无效值（例如， 对要求非负数的属性设置负数），除非 本规范另有说明，否则设置时不会 抛出异常，但给定的文档片段将在技术上成为 处于错误状态，如 错误处理中所述。

使用整数常量反映枚举值的 DOM 属性是一个例外： 当设置为超出范围的整数 或表示未知属性值的常量 (0) 时，它们会抛出 TypeError。 这与 WebIDL 枚举类型的行为 [WebIDL] 一致。

4.4. SVG 元素的 DOM 接口

[Exposed=Window]
interface SVGElement : Element {

  [SameObject] readonly attribute SVGAnimatedString className;

  readonly attribute SVGSVGElement? ownerSVGElement;
  readonly attribute SVGElement? viewportElement;
};

SVGElement includes GlobalEventHandlers;
SVGElement includes HTMLOrSVGOrMathMLElement;

dictionary SVGBoundingBoxOptions {
  boolean fill = true;
  boolean stroke = false;
  boolean markers = false;
  boolean clipped = false;
};

[Exposed=Window]
interface SVGGraphicsElement : SVGElement {
  [SameObject] readonly attribute SVGAnimatedTransformList transform;

  SVGRect getBBox(optional SVGBoundingBoxOptions options = {});
  SVGMatrix? getCTM();
  SVGMatrix? getScreenCTM();
};

SVGGraphicsElement includes SVGTests;

[Exposed=Window]
interface SVGGeometryElement : SVGGraphicsElement {
  [SameObject] readonly attribute SVGAnimatedNumber pathLength;

  boolean isPointInFill(optional DOMPointInit point = {});
  boolean isPointInStroke(optional DOMPointInit point = {});
  float getTotalLength();
  SVGPoint getPointAtLength(float distance);
};

4.5. 基本数据类型的 DOM 接口

4.5.1. 接口 SVGNumber

SVGNumber 接口主要用于 表示作为 SVGNumberList 一部分的 <number> 值。 单独的 SVGNumber 对象也可以由脚本创建。

SVGNumber 对象可以被指定为只读， 这意味着尝试修改该对象将导致抛出异常， 如下所述。 通过 animVal IDL 属性反映的 SVGNumber 对象始终 只读。

SVGNumber 对象可以与特定元素关联。如果对象反映 属性，则关联元素用于 确定要更新哪个元素的内容属性。除非另有说明，SVGNumber 对象 不与任何元素关联。

SVGNumber 对象维护一个内部数值， 称为其值。

[Exposed=Window]
interface SVGNumber {
  attribute float value;
};

value IDL 属性 表示该数值。获取 value 时， 返回 SVGNumber 的 值。

设置 value 时，执行以下 步骤：

1. 如果 SVGNumber 是只读的，则 抛出 NoModificationAllowedError。
2. 将 SVGNumber 的值设置为 正在赋给 value 成员的值。
3. 如果 SVGNumber 反映一个 基值元素，该基值属于一个反映的属性，则重新序列化 反映属性。

4.5.2. 接口 SVGLength

SVGLength 接口用于表示 可以是 <length>、<percentage> 或 <number> 的值。

SVGLength 对象可以被指定为只读， 这意味着尝试修改该对象将导致抛出异常， 如下所述。 通过 animVal IDL 属性反映的 SVGLength 对象始终 只读。

SVGLength 对象可以与特定元素关联，同时还可以指定方向性： 水平、垂直或未指定。关联元素和长度的方向性 用于将百分比值解析为用户单位，如果对象反映 属性，也用于确定要更新哪个元素的内容属性。除非另有 说明，SVGLength 对象不 与任何元素关联，并且 具有未指定的方向性。

SVGLength 对象维护一个内部 <length>、<percentage> 或 <number> 值，称为其 值。

[Exposed=Window]
interface SVGLength {

  // 长度单位类型
  const unsigned short SVG_LENGTHTYPE_UNKNOWN = 0;
  const unsigned short SVG_LENGTHTYPE_NUMBER = 1;
  const unsigned short SVG_LENGTHTYPE_PERCENTAGE = 2;
  const unsigned short SVG_LENGTHTYPE_EMS = 3;
  const unsigned short SVG_LENGTHTYPE_EXS = 4;
  const unsigned short SVG_LENGTHTYPE_PX = 5;
  const unsigned short SVG_LENGTHTYPE_CM = 6;
  const unsigned short SVG_LENGTHTYPE_MM = 7;
  const unsigned short SVG_LENGTHTYPE_IN = 8;
  const unsigned short SVG_LENGTHTYPE_PT = 9;
  const unsigned short SVG_LENGTHTYPE_PC = 10;

  readonly attribute unsigned short unitType;
           attribute float value;
           attribute float valueInSpecifiedUnits;
           attribute DOMString valueAsString;

  undefined newValueSpecifiedUnits(unsigned short unitType, float valueInSpecifiedUnits);
  undefined convertToSpecifiedUnits(unsigned short unitType);
};

SVGLength 上定义的数值长度单位类型常量用于 表示 SVGLength 的值的类型。 它们的含义如下：

使用数值长度单位类型常量是一种反模式，并且 不会为 SVGLength 支持的任何其他单位或长度类型引入 新的常量值。如果支持并使用其他类型的长度， SVGLength 将使用 SVG_LENGTHTYPE_UNKNOWN 单位类型。有关 SVGLength 的其他特性 如何处理这些类型的长度，请参阅下文。

unitType IDL 属性表示 SVGLength 的值的类型。 获取 unitType 时，执行以下步骤：

1. 如果 SVGLength 的值是无单位的 <number>、<percentage>，或者是带有 em、 ex、 px、 cm、 mm、 in、 pt 或 pc 单位的 <length>，则返回上方长度单位类型表中相应的常量 值。
2. 否则，返回 SVG_LENGTHTYPE_UNKNOWN。

   例如，对于带有 ch 单位的 <length> 或具有非标量值（例如 calc()）的值， 将返回 SVG_LENGTHTYPE_UNKNOWN。

value IDL 属性表示 SVGLength 的以用户单位表示的值。 获取 value 时，执行以下步骤：

1. 令 value 为 SVGLength 的值。
2. 如果 value 是 <number>，则返回 该数值。
3. 令 viewport size 为解析百分比所依据的基准，根据 SVGLength 的 关联元素和 方向性确定：

   没有关联元素

   viewport size 为 100

   具有关联元素和水平方向性

   viewport size 是关联 元素的 SVG 视口宽度

   具有关联元素和垂直方向性

   viewport size 是关联元素的 SVG 视口高度

   具有关联元素和未指定的方向性

   viewport size 是关联元素的 SVG 视口 对角线长度（请参阅单位）

4. 令 font size 为解析字体大小值所依据的基准， 根据 SVGLength 的关联元素确定：

   没有关联元素

   font size 是 font-size 特性的初始值的绝对长度

   具有关联元素

   font size 是关联元素的 font-size 特性的计算值

5. 返回将 value 转换为绝对长度的结果， 使用 viewport size 和 font size 分别作为百分比和字体大小 基准。如果由于缺少 关联元素而无法转换，则返回 0。

设置 value 时，执行以下步骤：

1. 如果 SVGLength 对象是只读的，则 抛出 NoModificationAllowedError。
2. 令 value 为赋给 value 的值。
3. 将 SVGLength 的值设置为 一个值为 value 的 <number>。
4. 如果 SVGLength 反映一个反映的 属性的基值、 反映呈现属性，或 反映一个反映的属性的基值中的一个元素， 则重新序列化反映属性。

valueInSpecifiedUnits IDL 属性表示 SVGLength 的值的数值因子。 获取 valueInSpecifiedUnits 时，执行以下 步骤：

1. 令 value 为 SVGLength 的值。
2. 如果 value 是 <number>，则返回 该数值。
3. 否则，如果 value 是 <percentage> 或任何标量 <length> 值，则返回其单位之前的数值因子。
4. 否则，返回 0。

   因此，对于 '12%' 和 12em， valueInSpecifiedUnits 都会返回 12，但对于 calc(12px + 5%) 等非标量值 则会返回 0。

设置 valueInSpecifiedUnits 时，执行以下 步骤：

1. 如果 SVGLength 对象是只读的，则 抛出 NoModificationAllowedError。
2. 令 value 为赋给 valueInSpecifiedUnits 的值。
3. 如果 SVGLength 的值是 <number>，则将其值更新为 value。
4. 否则，如果 SVGLength 的值 是 <percentage> 或标量值的 <length>， 则将其数值因子更新为 value。
5. 否则，SVGLength 的值 属于其他类型。将其设置为值为 value 的 <number>。
6. 如果 SVGLength 反映一个反映的 属性的基值，或 反映一个反映的属性的基值中的一个元素， 则重新序列化反映属性。

valueAsString IDL 属性表示 SVGLength 的值的字符串形式。 获取 valueAsString 时，执行以下步骤：

1. 令 value 为 SVGLength 的值。
2. 令 string 为空字符串。
3. 如果 value 是 <number>、<percentage> 或标量 <length> 值，则：
   1. 如果 value 是 <percentage> 或 <length>， 令 factor 为 value 的数值因子， 否则如果它是 <number>，则为 value 本身。
   2. 向 string 追加一个特定于实现的 字符串，如果使用 CSS 语法将其解析为 <number>， 则在给定实现所支持的 实数精度的情况下，会返回最接近 factor 的数值。
   3. 如果 value 是 <percentage>，则向 string 追加一个 U+0025 PERCENT SIGN 字符。
   4. 否则，如果 value 是 <length>， 则向 string 追加 value 单位的规范拼写。
   5. 返回 string。
4. 否则，返回一个特定于实现的字符串， 如果解析为 <length>，则在给定 实现所支持的实数精度的情况下， 会返回最接近 value 的 长度值。

设置 valueAsString 时，执行以下步骤：

1. 如果 SVGLength 对象是只读的，则 抛出 NoModificationAllowedError。
2. 令 value 为赋给 valueAsString 的值。
3. 使用 CSS 语法 [ <number> | <length> | <percentage> ] 解析 value。
4. 如果解析失败，则抛出 SyntaxError。
5. 否则，解析成功。将 SVGLength 的值 设置为解析后的值。
6. 如果 SVGLength 反映一个反映的 属性的基值，或 反映一个反映的属性的基值中的一个元素， 则重新序列化反映属性。

newValueSpecifiedUnits 方法用于以有类型的方式设置 SVGLength 的值。 调用 newValueSpecifiedUnits(unitType, valueInSpecifiedUnits) 时，执行以下 步骤：

1. 如果 SVGLength 对象是只读的，则 抛出 NoModificationAllowedError。
2. 如果 unitType 是 SVG_LENGTHTYPE_UNKNOWN 或是不在上述长度单位类型表中出现的值， 则抛出 NotSupportedError。
3. 根据 unitType 的值设置 SVGLength 的值：

   SVG_LENGTHTYPE_NUMBER

   一个值为 valueInSpecifiedUnits 的 <number>

   SVG_LENGTHTYPE_PERCENTAGE

   一个数值因子为 valueInSpecifiedUnits 的 <percentage>

   其他任何值

   一个数值因子为 valueInSpecifiedUnits 且单位由上方长度单位类型表指示的 <length>

4. 如果 SVGLength 反映一个反映的 属性的基值，或 反映一个反映的属性的基值中的一个元素， 则重新序列化反映属性。

convertToSpecifiedUnits 方法用于将 SVGLength 的值 转换为特定类型。 调用 convertToSpecifiedUnits(unitType) 时，执行以下步骤：

1. 如果 SVGLength 对象是只读的，则 抛出 NoModificationAllowedError。
2. 如果 unitType 是 SVG_LENGTHTYPE_UNKNOWN 或是不在上述长度单位类型表中出现的值， 则抛出 NotSupportedError。
3. 令 absolute 为从 value 成员将返回的值。
4. 如果 unitType 是 SVG_LENGTHTYPE_NUMBER，则：
   1. 将 SVGLength 的值设置为值为 absolute 的 <number>。
5. 否则，如果 unitType 是 SVG_LENGTHTYPE_PERCENTAGE，则：
   1. 令 viewport size 为解析百分比所依据的基准，根据 SVGLength 的 关联元素和 方向性确定：

      没有关联元素

      viewport size 为 100

      具有关联元素和水平方向性

      viewport size 是关联元素的 SVG 视口宽度

      具有关联元素和垂直方向性

      viewport size 是关联元素的 SVG 视口高度

      具有关联元素和未指定的 方向性

      viewport size 是关联元素的 SVG 视口 对角线长度（请参阅单位）

   2. 将 SVGLength 的值设置为 使用 viewport size 作为百分比基准，将 absolute 转换为 <percentage> 的结果。
6. 否则，如果 unitType 是 SVG_LENGTHTYPE_EMS 或 SVG_LENGTHTYPE_EXS，则：
   1. 令 font size 为解析字体大小值所依据的基准， 根据 SVGLength 的关联元素确定：

      没有关联元素

      font size 是 font-size 特性的初始值的绝对长度

      具有关联元素

      font size 是关联元素的 font-size 特性的计算值

   2. 将 SVGLength 的值设置为 将 absolute 转换为具有 em 或 ex 单位（取决于 unitType）的 <length> 的结果， 使用 font size 作为 font-size 基准。
7. 否则：
   1. 将 SVGLength 的值设置为 将 absolute 转换为 <length> 的结果，其单位 通过在上方长度单位类型表中查找 unitType 获得。
8. 如果 SVGLength 反映一个反映的 属性的基值，或 反映一个反映的属性的基值中的一个元素， 则重新序列化反映属性。

4.5.3. 接口 SVGAngle

SVGAngle 接口用于表示 可以是 <angle> 或 <number> 的值。

SVGAngle 对象可以被指定为只读， 这意味着尝试修改该对象将导致抛出异常， 如下所述。通过 animVal 属性反映的 SVGAngle 始终只读。

SVGAngle 对象可以与特定元素关联。如果对象反映 属性，则关联元素用于 确定要更新哪个元素的内容属性。除非另有说明，SVGAngle 对象 不与任何元素关联。

SVGAngle 对象维护一个内部 <angle> 或 <number> 值，称为其值。

[Exposed=Window]
interface SVGAngle {

  // 角度单位类型
  const unsigned short SVG_ANGLETYPE_UNKNOWN = 0;
  const unsigned short SVG_ANGLETYPE_UNSPECIFIED = 1;
  const unsigned short SVG_ANGLETYPE_DEG = 2;
  const unsigned short SVG_ANGLETYPE_RAD = 3;
  const unsigned short SVG_ANGLETYPE_GRAD = 4;

  readonly attribute unsigned short unitType;
           attribute float value;
           attribute float valueInSpecifiedUnits;
           attribute DOMString valueAsString;

  undefined newValueSpecifiedUnits(unsigned short unitType, float valueInSpecifiedUnits);
  undefined convertToSpecifiedUnits(unsigned short unitType);
};

SVGAngle 上定义的数值角度单位类型常量用于 表示 SVGAngle 的值的类型。 它们的含义如下：

使用数值角度单位类型常量是一种反模式，并且 不会为 SVGAngle 支持的任何其他单位或角度类型引入 新的常量值。如果支持并使用其他类型的角度， SVGAngle 将使用 SVG_ANGLETYPE_UNKNOWN 单位类型。有关 SVGAngle 的其他特性 如何处理这些类型的角度，请参阅下文。

unitType IDL 属性表示 SVGAngle 的值的类型。 获取 unitType 时，执行以下步骤：

1. 如果 SVGAngle 的值是无单位的 <number>，或者是带有 deg、 rad 或 grad 单位的 <angle>，则返回上方角度单位类型表中的相应常量 值。
2. 否则，返回 SVG_ANGLETYPE_UNKNOWN。

   例如，对于带有 turn 单位的 <angle>， 将返回 SVG_ANGLETYPE_UNKNOWN。

value IDL 属性表示 SVGAngle 的以度为单位的值。 获取 value 时，执行以下步骤：

1. 令 value 为 SVGAngle 的值。
2. 如果 value 是 <number>，则返回 该数值。
3. 返回将 value 转换为以度为单位的角度的结果。

设置 value 时，执行以下步骤：

1. 如果 SVGAngle 对象是只读的，则 抛出 NoModificationAllowedError。
2. 令 value 为赋给 value 的值。
3. 将 SVGAngle 的值设置为 一个值为 value 的 <number>。
4. 如果 SVGAngle 反映一个反映的 属性的基值， 则重新序列化反映属性。

valueInSpecifiedUnits IDL 属性表示 SVGAngle 的值的数值因子。 获取 valueInSpecifiedUnits 时，执行以下 步骤：

1. 令 value 为 SVGAngle 的值。
2. 如果 value 是 <number>，则返回 该数值。
3. 否则，value 是一个 <angle> 值。返回 其单位之前的数值因子。

设置 valueInSpecifiedUnits 时，执行以下 步骤：

1. 如果 SVGAngle 对象是只读的，则 抛出 NoModificationAllowedError。
2. 令 value 为赋给 valueInSpecifiedUnits 的值。
3. 如果 SVGAngle 的值是 <number>，则将其值更新为 value。
4. 否则，如果 SVGAngle 的值 是 <angle>， 则将其数值因子更新为 value。
5. 如果 SVGAngle 反映一个反映的 属性的基值，或 反映一个反映的属性的基值中的一个元素， 则重新序列化反映属性。

valueAsString IDL 属性表示 SVGAngle 的值的字符串形式。 获取 valueAsString 时，执行以下步骤：

1. 令 value 为 SVGAngle 的值。
2. 令 string 为空字符串。
3. 如果 value 是 <angle>， 令 factor 为 value 的数值因子， 否则如果它是 <number>，则为 value 本身。
4. 向 string 追加一个特定于实现的 字符串，如果使用 CSS 语法将其解析为 <number>， 则在给定实现所支持的 实数精度的情况下，会返回最接近 factor 的数值。
5. 如果 value 是 <angle>， 则向 string 追加 value 单位的规范拼写。
6. 返回 string。

设置 valueAsString 时，执行以下步骤：

1. 如果 SVGAngle 对象是只读的，则 抛出 NoModificationAllowedError。
2. 令 value 为赋给 valueAsString 的值。
3. 使用 CSS 语法 [ <number> | <angle> ] 解析 value。
4. 如果解析失败，则抛出 SyntaxError。
5. 否则，解析成功。将 SVGAngle 的 值 设置为解析后的值。
6. 如果 SVGAngle 反映一个反映的 属性的基值，或 反映一个反映的属性的基值中的一个元素， 则重新序列化反映属性。

newValueSpecifiedUnits 方法用于以有类型的方式设置 SVGAngle 的值。 调用 newValueSpecifiedUnits(unitType, valueInSpecifiedUnits) 时，执行以下 步骤：

1. 如果 SVGAngle 对象是只读的，则 抛出 NoModificationAllowedError。
2. 如果 unitType 是 SVG_ANGLETYPE_UNKNOWN 或是不在上方角度单位类型表中出现的值， 则抛出 NotSupportedError。
3. 根据 unitType 的值设置 SVGAngle 的值：

   SVG_ANGLETYPE_UNSPECIFIED

   一个值为 valueInSpecifiedUnits 的 <number>

   其他任何值

   一个数值因子为 valueInSpecifiedUnits 且单位由上方角度单位类型表指示的 <angle>

4. 如果 SVGAngle 反映一个反映的 属性的基值，或 反映一个反映的属性的基值中的一个元素， 则重新序列化反映属性。

convertToSpecifiedUnits 方法用于将 SVGAngle 的值 转换为特定类型。 调用 convertToSpecifiedUnits(unitType) 时，执行以下步骤：

1. 如果 SVGAngle 对象是只读的，则 抛出 NoModificationAllowedError。
2. 如果 unitType 是 SVG_ANGLETYPE_UNKNOWN 或是不在上方角度单位类型表中出现的值， 则抛出 NotSupportedError。
3. 令 degrees 为从 value 成员将返回的值。
4. 如果 unitType 是 SVG_ANGLETYPE_UNSPECIFIED，则：
   1. 将 SVGAngle 的值设置为值为 degrees 的 <number>。
5. 否则：
   1. 将 SVGAngle 的值设置为 将 degrees 转换为 <angle> 的结果，其单位 通过在上方角度单位类型表中查找 unitType 获得。
6. 如果 SVGAngle 反映一个反映的 属性的基值，或 反映一个反映的属性的基值中的一个元素， 则重新序列化反映属性。

4.5.4. 列表接口

某些 SVG 属性包含值列表，为了表示这些值， 存在多个 SVG DOM 列表 接口，每种所需元素类型对应一个——SVGNumberList、SVGLengthList、 SVGPointList、SVGTransformList 和 SVGStringList。 前四个用于表示 SVGAnimatedNumberList、SVGAnimatedLengthList、 SVGAnimatedPoints 和 SVGTransformList 对象的基值和 动画组件，而第五个 SVGStringList 用于 反映 少数接受字符串列表的非动画属性。

大多数列表接口采用以下形式：

interface SVGNameList {

  readonly attribute unsigned long length;
  readonly attribute unsigned long numberOfItems;

  undefined clear();
  Type initialize(Type newItem);
  getter Type getItem(unsigned long index);
  Type insertItemBefore(Type newItem, unsigned long index);
  Type replaceItem(Type newItem, unsigned long index);
  Type removeItem(unsigned long index);
  Type appendItem(Type newItem);
  setter undefined (unsigned long index, Type newItem);
};

其中 Name 是列表元素的描述性名称 （"Number"、"Length"、"Point"、"Transform" 或 "String"），而 Type 是 列表元素的 IDL 类型（SVGNumber、SVGLength、SVGPoint、SVGTransform 或 DOMString）。

SVGTransformList 接口采用 上述形式，但还有 两个附加方法。

除 SVGTransformList 外，所有列表接口对象都 反映某个反映内容 属性的基值。SVGTransformList 对象 反映呈现 属性（‘transform’、 ‘gradientTransform’ 或 ‘patternTransform’）。 所有列表接口对象都与特定元素关联。 与 SVGLength 和类似对象不同，不存在 “分离的” 列表接口对象。

列表接口对象维护一个内部元素列表， 下文中简称为“列表”。 IDL 属性和方法用于检查和操作列表中的元素。 列表也可以响应 反映内容属性的更改以及 内容属性的动画而发生更改（对于 SVGTransformList 对象， 则响应 transform 特性的计算值的更改）。

列表 接口对象可以被指定为 只读，这意味着尝试修改该对象将导致 抛出异常，如下所述。通过 animVal IDL 属性反映的列表接口 对象始终只读。

列表接口对象 通过执行以下步骤进行同步：

1. 令 value 为 反映内容属性的基值。如果属性不存在，或者其 值无法解析，则令 value 为该属性的 初始值；如果属性的 初始值为 (none)，则为空列表。
2. 令 length 为列表中的项目数量。
3. 令 new length 为 value 中值的数量。 如果 value 是关键词 none （transform 特性支持此关键词）， 则 new length 为 0。
4. 如果列表元素类型是 SVGNumber、SVGLength、SVGPoint 或 SVGTransform，则：
   1. 如果 length > new length，则：
      1. 分离列表中索引 大于或等于 new length 的每个对象。
      2. 将列表截断到长度 new length。
      3. 将 length 设置为 new length。
   2. 当 length < new length 时：
      1. 令 item 为一个新创建的 列表元素类型的对象。
      2. 将 item 附加到此列表接口 对象。
      3. 将 item 追加到列表。
      4. 将 length 设置为 length + 1。
   3. 令 index 为 0。
   4. 当 index < length 时：
      1. 令 item 为列表中索引为 index 的对象。
      2. 令 v 为 value 中索引为 index 的值。
      3. 将 item 的值设置为 v。
      4. 如果 item 是 SVGTransform 对象，则 设置其 matrix 对象的组件 以匹配新的变换函数值。
      5. 将 index 设置为 index + 1。
5. 否则，列表元素类型是 DOMString：
   1. 将列表替换为由 value 中的值组成的新列表。

每当需要分离一个列表元素对象时， 根据列表元素类型执行以下步骤：

SVGNumber

将 SVGNumber 设置为不再 与任何元素关联。 如果 SVGNumber 是只读的， 则将其设置为不再只读。

SVGLength

将 SVGLength 设置为不再 与任何元素关联。 如果 SVGLength 是只读的， 则将其设置为不再只读。将 SVGLength 设置为具有 未指定的方向性。

SVGPoint

将 SVGPoint 设置为不再 与任何元素 关联。 如果 SVGPoint 是只读的， 则将其设置为不再只读。

SVGTransform

将 SVGTransform 设置为不再 与任何元素关联。 如果 SVGTransform 是只读的， 则将其设置为不再只读。

DOMString

不执行任何操作。

每当需要附加一个列表元素对象时， 根据列表元素类型执行以下步骤：

支持的特性索引 of a 列表接口对象，是所有小于列表长度的非负整数的集合。

length 和 numberOfItems IDL 属性 表示列表长度，获取时直接返回 列表长度。

clear 方法用于 删除列表中的所有项目。调用 clear() 时，执行以下步骤：

1. 如果列表是只读的，则抛出 NoModificationAllowedError。
2. 分离列表中的所有元素，然后将其删除。
3. 如果列表反映某个属性，或者表示某个反映属性的对象的 基值，则 重新序列化反映属性。

initialize 方法 用于清空列表并向其中添加一个指定值。 调用 initialize(newItem) 时，执行以下步骤：

1. 如果列表是只读的，则抛出 NoModificationAllowedError。
2. 分离列表中的所有元素，然后将其删除。
3. 如果 newItem 是对象类型，并且 newItem 不是分离对象，则将 newItem 设置为 一个新创建的、与 newItem 类型相同 且具有相同（数值或长度）值的对象。
4. 将 newItem 附加到列表 接口对象。
5. 将 newItem 追加到此列表。
6. 如果列表反映某个属性，或者表示某个反映属性的对象的 基值，则 重新序列化反映属性。
7. 返回 newItem。

getItem 方法用于 获取列表中指定位置的项目。调用 getItem(index) 时，执行以下步骤：

1. 如果 index 大于或等于列表 长度，则抛出 IndexSizeError。
2. 返回列表中位置 index 处的元素。

   请注意，如果列表的元素类型是对象类型， 例如 SVGLength，则返回的是该对象的引用，而不是 其副本。

insertItemBefore 方法用于在列表中特定位置插入元素。 调用 insertItemBefore(newItem, index) 时， 执行以下步骤：

1. 如果列表是只读的，则抛出 NoModificationAllowedError。
2. 如果 newItem 是对象类型，并且 newItem 不是分离对象，则将 newItem 设置为 一个新创建的、与 newItem 类型相同 且具有相同（数值或长度）值的对象。
3. 如果 index 大于列表长度，则 将 index 设置为列表长度。
4. 在索引 index 处将 newItem 插入列表。
5. 将 newItem 附加到列表接口对象。
6. 如果列表反映某个属性，或者表示某个反映属性的对象的 基值，则 重新序列化反映属性。
7. 返回 newItem。

replaceItem 方法 用于用新项目替换列表中的现有项目。 调用 replaceItem(newItem, index) 时， 执行以下步骤：

1. 如果列表是只读的，则抛出 NoModificationAllowedError。
2. 如果 index 大于或等于列表 长度，则抛出 IndexSizeError。
3. 如果 newItem 是对象类型，并且 newItem 不是分离对象，则将 newItem 设置为 一个新创建的、与 newItem 类型相同 且具有相同（数值或长度）值的对象。
4. 分离列表中索引为 index 的元素。
5. 使用 newItem 替换列表中索引为 index 的元素。
6. 将 newItem 附加到列表 接口对象。
7. 如果列表反映某个属性，或者表示某个反映属性的对象的 基值，则 重新序列化反映属性。
8. 返回 newItem。

removeItem 方法 用于从列表中删除项目。调用 removeItem(index) 时，执行以下步骤：

1. 如果列表是只读的，则抛出 NoModificationAllowedError。
2. 如果 index 大于或等于列表 长度，则抛出带有代码的 IndexSizeError。
3. 令 item 为索引 index 处的列表元素。
4. 分离 item。
5. 删除索引 index 处的列表元素。
6. 返回 item。

appendItem 方法 用于将项目追加到列表末尾。调用 appendItem(newItem) 时，执行以下步骤：

1. 如果列表是只读的，则抛出 NoModificationAllowedError。
2. 如果 newItem 是对象类型，并且 newItem 不是分离对象，则将 newItem 设置为 一个新创建的、与 newItem 类型相同 且具有相同（数值或长度）值的对象。
3. 令 index 为列表长度。
4. 将 newItem 追加到列表末尾。
5. 将 newItem 附加到列表 接口对象。
6. 如果列表反映某个属性，或者表示某个反映属性的对象的 基值，则 重新序列化反映属性。
7. 返回 newItem。

索引特性设置器的行为 与 replaceItem 方法相同。

4.5.5. 接口 SVGNumberList

SVGNumberList 接口是一个列表接口，其 元素为 SVGNumber 对象。SVGNumberList 对象 表示数字列表。

[Exposed=Window]
interface SVGNumberList {

  readonly attribute unsigned long length;
  readonly attribute unsigned long numberOfItems;

  undefined clear();
  SVGNumber initialize(SVGNumber newItem);
  getter SVGNumber getItem(unsigned long index);
  SVGNumber insertItemBefore(SVGNumber newItem, unsigned long index);
  SVGNumber replaceItem(SVGNumber newItem, unsigned long index);
  SVGNumber removeItem(unsigned long index);
  SVGNumber appendItem(SVGNumber newItem);
  setter undefined (unsigned long index, SVGNumber newItem);
};

SVGNumberList 的所有接口成员的行为 都在上面的列表接口一节中定义。

4.5.6. 接口 SVGLengthList

SVGLengthList 接口是一个列表接口，其 元素为 SVGLength 对象。SVGLengthList 对象 表示长度列表。

[Exposed=Window]
interface SVGLengthList {

  readonly attribute unsigned long length;
  readonly attribute unsigned long numberOfItems;

  undefined clear();
  SVGLength initialize(SVGLength newItem);
  getter SVGLength getItem(unsigned long index);
  SVGLength insertItemBefore(SVGLength newItem, unsigned long index);
  SVGLength replaceItem(SVGLength newItem, unsigned long index);
  SVGLength removeItem(unsigned long index);
  SVGLength appendItem(SVGLength newItem);
  setter undefined (unsigned long index, SVGLength newItem);
};

SVGLengthList 的所有接口成员的行为 都在上面的列表接口一节中定义。

4.5.7. 接口 SVGStringList

SVGStringList 接口是一个列表接口，其 元素为 DOMString 值。SVGStringList 对象 表示字符串列表。

[Exposed=Window]
interface SVGStringList {

  readonly attribute unsigned long length;
  readonly attribute unsigned long numberOfItems;

  undefined clear();
  DOMString initialize(DOMString newItem);
  getter DOMString getItem(unsigned long index);
  DOMString insertItemBefore(DOMString newItem, unsigned long index);
  DOMString replaceItem(DOMString newItem, unsigned long index);
  DOMString removeItem(unsigned long index);
  DOMString appendItem(DOMString newItem);
  setter undefined (unsigned long index, DOMString newItem);
};

SVGStringList 的所有接口成员的行为 都在上面的列表接口一节中定义。

4.6. 用于反映 可动画 SVG 属性的 DOM 接口

以下接口用于表示 可动画内容属性的反映值。 它们各自由表示相同数据的两个组件对象组成： baseVal 和 animVal。 baseVal（基值）对象可修改， 用于更新相应属性值。

在 SVG 1.1 中，SVG DOM 接口的 animVal 属性表示 反映属性的当前动画值。在此版本的 SVG 中， animVal 不再表示当前动画值，而是 baseVal 的别名。

4.6.1. 接口 SVGAnimatedBoolean

SVGAnimatedBoolean 对象用于 反映 一个接受布尔值的可动画属性。

[Exposed=Window]
interface SVGAnimatedBoolean {
           attribute boolean baseVal;
  readonly attribute boolean animVal;
};

baseVal 和 animVal IDL 属性 都表示反映属性当前的非动画值。 获取 baseVal 或 animVal 时， 执行以下步骤：

1. 令 value 为反映属性的值， 如果不存在则为空字符串。
2. 如果 value 不是 "true" 或 "false"，则将 value 设置为反映属性的初始值。
3. 如果 value 为 "true"，则返回 true，否则返回 false。

设置 baseVal 时， 如果值为 true，则将反映属性设置为 "true"，否则设置为 "false" 。

4.6.2. 接口 SVGAnimatedEnumeration

SVGAnimatedEnumeration 对象 用于反映 一个接受关键词值的可动画属性（例如 ‘textPath’ 上的 ‘method’ 属性）， 或反映 某个可动画属性所具有的值类型（仅由 ‘marker’ 元素的 ‘orient’ 属性的 orientType IDL 属性执行）。

[Exposed=Window]
interface SVGAnimatedEnumeration {
           attribute unsigned short baseVal;
  readonly attribute unsigned short animVal;
};

对于SVGAnimatedEnumeration 对象，如果它们反映 一个只接受关键词值的可动画属性，则 baseVal 和 animVal IDL 属性 表示反映属性当前的非动画值。 对于 orientType， 它们表示反映的 ‘orient’ 属性当前非动画值的类型。获取 baseVal 或 animVal 时， 执行以下步骤：

1. 令 value 为反映属性的值 （如果该属性不存在或无效，则使用该属性的初始值）。
2. 根据反映 IDL 属性的定义， 返回 value 的数值类型 值。

设置 baseVal 时， 执行以下步骤：

1. 令 value 为赋给 baseVal 的值。
2. 如果 value 为 0，或者不是反映属性任何值的数值类型值， 则抛出 TypeError。
3. 否则，如果反映 IDL 属性是 orientType 且 value 是 SVG_MARKER_ORIENT_ANGLE， 则将反映属性设置为字符串 "0"。
4. 否则，value 是反映属性的某个特定单一关键词值的 数值类型值。 将反映属性设置为该值。

4.6.3. 接口 SVGAnimatedInteger

SVGAnimatedInteger 对象用于 反映 一个接受整数值的可动画属性（例如 ‘feTurbulence’ 上的 ‘numOctaves’）。 它还 用于反映一个接受 一个整数后跟可选第二个整数的可动画属性的一部分（例如 ‘feConvolveMatrix’ 上的 ‘order’）。

此 SVGAnimatedInteger 接口 未在本规范中使用，不过 滤镜效果 规范多处使用了它。

[Exposed=Window]
interface SVGAnimatedInteger {
           attribute long baseVal;
  readonly attribute long animVal;
};

对于SVGAnimatedInteger 对象，如果它们反映 一个接受单个整数值的可动画属性，则 baseVal 和 animVal IDL 属性 表示反映属性当前的非动画值。 对于反映一个接受 一个整数后跟可选第二个整数的属性中的一个整数的对象，它们表示 两个整数之一当前的非动画值。获取 baseVal 或 animVal 时， 执行以下步骤：

1. 令 value 为反映属性的值 （如果该属性不存在或无效，则使用该属性的初始值）。
2. 如果反映属性被定义为接受一个整数 后跟可选的第二个整数，则：
   1. 如果此 SVGAnimatedInteger 对象反映 第一个整数，则返回 value 中的第一个值。
   2. 否则，此 SVGAnimatedInteger 对象反映 第二个整数。如果 value 中显式指定了第二个值，则返回它； 如果没有，则返回 属性定义中所述的隐式值。

      例如，‘order’ 的定义指出，隐式的第二个整数与显式的 第一个整数相同。

3. 否则，反映属性被定义为接受单个 整数值。返回 value。

设置 baseVal 时， 执行以下步骤：

1. 令 value 为赋给 baseVal 的值。
2. 令 new 为整数列表。
3. 如果反映属性被定义为接受一个整数 后跟可选的第二个整数，则：
   1. 令 current 为反映属性的值 （如果该属性不存在或无效，则使用该属性的初始值）。
   2. 令 first 为 current 中的第一个整数。
   3. 如果 current 中显式指定了第二个整数， 则令 second 为该值；否则为 属性定义中所述的隐式值。
   4. 如果此 SVGAnimatedInteger 对象反映 第一个整数，则将 first 设置为 value。 否则，将 second 设置为 value。
   5. 将 first 追加到 new。
   6. 将 second 追加到 new。
4. 否则，反映属性被定义为接受单个 整数值。将 value 追加到 new。
5. 将内容属性设置为由 new 中每个整数 序列化为特定于实现的字符串组成的字符串； 如果使用 CSS 语法将这些字符串解析为 <number>， 则会返回对应的 整数，并且各字符串使用单个 U+0020 SPACE 字符连接和分隔。

4.6.4. 接口 SVGAnimatedNumber

SVGAnimatedNumber 对象用于 反映 一个接受数值的可动画属性（例如 ‘path’ 上的 ‘pathLength’）。它还 用于反映一个接受 一个数值后跟可选第二个数值的可动画属性的一部分（例如 ‘feDiffuseLighting’ 上的 ‘kernelUnitLength’）。

[Exposed=Window]
interface SVGAnimatedNumber {
           attribute float baseVal;
  readonly attribute float animVal;
};

对于SVGAnimatedNumber 对象，如果它们反映 一个接受单个数值的可动画属性，则 baseVal 和 animVal IDL 属性 表示反映属性当前的非动画值。 对于反映一个接受 一个数值后跟可选第二个数值的属性中的一个数值的对象，它们表示 两个数值之一当前的非动画值。获取 baseVal 或 animVal 时， 执行以下步骤：

1. 令 value 为反映属性的值 （如果该属性不存在或无效，则使用该属性的初始值）。
2. 如果反映属性被定义为接受一个数值 后跟可选的第二个数值，则：
   1. 如果此 SVGAnimatedNumber 对象反映 第一个数值，则返回 value 中的第一个值。
   2. 否则，此 SVGAnimatedNumber 对象反映 第二个数值。如果 value 中显式指定了第二个值，则返回它； 如果没有，则返回 属性定义中所述的隐式值。

      例如，‘kernelUnitLength’ 的定义指出，隐式的第二个数值与显式的 第一个数值相同。

3. 否则，反映属性被定义为接受单个 数值。返回 value。

设置 baseVal 时， 执行以下步骤：

1. 令 value 为赋给 baseVal 的值。
2. 令 new 为数值列表。
3. 如果反映属性被定义为接受一个数值 后跟可选的第二个数值，则：
   1. 令 current 为反映属性的值 （如果该属性不存在或无效，则使用该属性的初始值）。
   2. 令 first 为 current 中的第一个数值。
   3. 如果 current 中显式指定了第二个数值， 则令 second 为该值；否则为 属性定义中所述的隐式值。
   4. 如果此 SVGAnimatedNumber 对象反映 第一个数值，则将 first 设置为 value。 否则，将 second 设置为 value。
   5. 将 first 追加到 new。
   6. 将 second 追加到 new。
4. 否则，反映属性被定义为接受单个 数值。将 value 追加到 new。
5. 将内容属性设置为由 new 中每个数值 序列化为特定于实现的字符串组成的字符串； 如果使用 CSS 语法将这些字符串解析为 <number>， 则在给定实现所支持的 实数精度的情况下，会返回 最接近该数值的值， 并且各字符串使用单个 U+0020 SPACE 字符连接和分隔。

4.6.5. 接口 SVGAnimatedLength

SVGAnimatedLength 对象用于反映 (a) 一个接受 <length>、 <percentage> 或 <number> 值的可动画属性，或 (b) 一个 接受这些值之一的 CSS 特性及其相应的 呈现属性。

[Exposed=Window]
interface SVGAnimatedLength {
  [SameObject] readonly attribute SVGLength baseVal;
  [SameObject] readonly attribute SVGLength animVal;
};

baseVal 和 animVal IDL 属性 表示反映内容属性的当前值。 获取 baseVal 或 animVal 时， 返回一个 SVGLength 对象，该对象：

• 要么反映反映属性的基值，要么反映 给定的呈现属性，
• 与获得类型为 SVGAnimatedLength 的反映 IDL 属性所在对象的 SVG 元素 关联，并且
• 具有由特定反映属性定义的 方向性。

4.6.6. 接口 SVGAnimatedAngle

SVGAnimatedAngle 对象用于反映 ‘marker’ 上动画 ‘orient’ 属性的 <angle> 值， 通过 orientAngle IDL 属性实现。

[Exposed=Window]
interface SVGAnimatedAngle {
  [SameObject] readonly attribute SVGAngle baseVal;
  [SameObject] readonly attribute SVGAngle animVal;
};

baseVal 和 animVal IDL 属性表示 反映的 ‘orient’ 属性当前的非动画 <angle> 值。 获取 baseVal 或 animVal 时，返回一个 SVGAngle 对象，该对象：

• 反映反映的 ‘orient’ 属性的基值，并且
• 与获得类型为 SVGAnimatedAngle 的反映 IDL 属性所在对象的 SVG ‘marker’ 元素关联。

4.6.7. 接口 SVGAnimatedString

SVGAnimatedString 对象用于 反映 一个接受字符串值的可动画属性。还可以选择 定义为额外反映第二个已弃用属性。

[Exposed=Window]
interface SVGAnimatedString {
           attribute (DOMString or TrustedScriptURL) baseVal;
  readonly attribute DOMString animVal;
};

baseVal 和 animVal IDL 属性 表示反映属性当前的非动画值。 获取 baseVal 或 animVal 时， 执行以下步骤：

1. 如果反映属性不存在，则：
   1. 如果 SVGAnimatedString 对象被定义为还额外 反映第二个已弃用属性，并且该属性存在， 则返回其值。
   2. 否则，如果反映属性具有初始 值， 则返回该值。
   3. 否则，返回空字符串。
2. 否则，反映属性存在。返回其值。

对于 href 成员在 SVGURIReference 接口上的情况， 如果 已弃用的 ‘xlink:href’ 属性存在 而 ‘href’ 属性不存在， 则会返回前者， 在所有其他情况下则返回 ‘href’ 属性。

设置 baseVal 时， 执行以下步骤：

1. 如果反映属性的元素是 SVGScriptElement，令 value 为 执行 获取符合 Trusted Type 的字符串 算法的结果，参数为 TrustedScriptURL、 反映属性所属 Document 的相关全局对象、'SVGScriptElement href' 和 'script'。
2. 否则，令 value 为指定值。
3. 如果反映属性不存在， SVGAnimatedString 对象 被定义为还额外反映 第二个已弃用属性，并且该已弃用属性存在， 则将该已弃用属性设置为 value。
4. 否则，将反映属性设置为 value。

SVG 尚未拥有完整的脚本处理模型。 Trusted Types 假设属性和 文本正文修改保护的行为与 HTML 脚本类似。

对于 href 成员在 SVGURIReference 接口上的情况， 如果 已弃用的 ‘xlink:href’ 属性存在 而 ‘href’ 属性不存在， 则会设置前者， 在所有其他情况下则设置 ‘href’ 属性。

4.6.8. 接口 SVGAnimatedRect

SVGAnimatedRect 对象用于反映 一个接受矩形值的可动画属性，该矩形值由 x、y、width 和 height 指定。

在本规范中，唯一作为 SVGAnimatedRect 反映的属性是 ‘viewBox’。

[Exposed=Window]
interface SVGAnimatedRect {
  [SameObject] readonly attribute SVGRect baseVal;
  [SameObject] readonly attribute SVGRect animVal;
};

baseVal 和 animVal IDL 属性表示反映属性当前的非动画矩形值。 获取 baseVal 或 animVal 时， 返回一个 SVGRect 对象。

创建 baseVal 或 animVal SVGRect 对象时，以及 此后每当反映内容属性 被添加、删除或更改时，执行以下步骤：

1. 令 value 为反映属性的值 （如果该属性不存在或无效，则使用该属性的初始值）。
2. 令 x、y、width 和 height 为 value 中对应的各组件。
3. 将 SVGRect 对象的 x 坐标、 y 坐标、 width 和 height 分别设置为 x、y、width 和 height。

每当 baseVal 或 animVal SVGRect 对象的 x 坐标、 y 坐标、 width 或 height 特性 发生变化时， 除非是作为前述将内容属性值 反映到 SVGRect 中的算法的一部分，否则反映的 内容属性必须被重新序列化。

4.6.9. 接口 SVGAnimatedNumberList

SVGAnimatedNumberList 对象 用于反映一个接受 <number> 值列表的可动画属性。

[Exposed=Window]
interface SVGAnimatedNumberList {
  [SameObject] readonly attribute SVGNumberList baseVal;
  [SameObject] readonly attribute SVGNumberList animVal;
};

baseVal 和 animVal IDL 属性 表示反映属性当前的非动画值。 获取 baseVal 或 animVal 时， 返回一个 SVGNumberList 对象，该对象 反映 反映属性的基值。

4.6.10. 接口 SVGAnimatedLengthList

SVGAnimatedLengthList 对象 用于反映一个接受 <length>、<percentage> 或 <number> 值列表的可动画属性。

[Exposed=Window]
interface SVGAnimatedLengthList {
  [SameObject] readonly attribute SVGLengthList baseVal;
  [SameObject] readonly attribute SVGLengthList animVal;
};

baseVal 或 animVal IDL 属性 表示反映属性当前的非动画值。 获取 baseVal 或 animVal 时， 返回一个 SVGLengthList 对象，该对象 反映 反映属性的基值。

4.7. 其他 DOM 接口

4.7.1. 接口 SVGUnitTypes

SVGUnitTypes 接口定义一组常用 常量， 用于反映 ‘gradientUnits’、 ‘patternContentUnits’ 以及 其他类似属性。

[Exposed=Window]
interface SVGUnitTypes {
  // 单位类型
  const unsigned short SVG_UNIT_TYPE_UNKNOWN = 0;
  const unsigned short SVG_UNIT_TYPE_USERSPACEONUSE = 1;
  const unsigned short SVG_UNIT_TYPE_OBJECTBOUNDINGBOX = 2;
};

SVGUnitTypes 上定义的单位类型常量具有以下含义：

4.7.2. 混入 SVGTests

SVGTests 接口用于反映 条件处理属性，并被混入 支持这些属性的元素的其他 接口中。

interface mixin SVGTests {
  [SameObject] readonly attribute SVGStringList requiredExtensions;
  [SameObject] readonly attribute SVGStringList systemLanguage;
};

requiredExtensions IDL 属性 反映 ‘requiredExtensions’ 内容 属性。

systemLanguage IDL 属性 反映 ‘systemLanguage’ 内容属性。

4.7.3. 混入 SVGFitToViewBox

SVGFitToViewBox 接口用于 反映 ‘viewBox’ 和 ‘preserveAspectRatio’ 属性， 并被混入支持 这两个属性的元素的其他接口中。

interface mixin SVGFitToViewBox {
  [SameObject] readonly attribute SVGAnimatedRect viewBox;
  [SameObject] readonly attribute SVGAnimatedPreserveAspectRatio preserveAspectRatio;
};

viewBox IDL 属性 反映 ‘viewBox’ 内容属性。

preserveAspectRatio IDL 属性 反映 ‘preserveAspectRatio’ 内容 属性。

4.7.4. 混入 SVGURIReference

SVGURIReference 接口用于 反映 ‘href’ 属性和已弃用的 ‘xlink:href’ 属性。

interface mixin SVGURIReference {
  [SameObject] readonly attribute SVGAnimatedString href;
};

href IDL 属性 表示 ‘href’ 属性的值，并且对于定义为支持它的元素， 还表示已弃用的 ‘xlink:href’ 属性。获取 href 时，返回一个 SVGAnimatedString 对象，该对象：

• 反映 ‘href’ 属性，并且
• 如果该元素被定义为支持已弃用的 ‘xlink:href’ 属性，则还额外反映该已弃用属性。

SVGAnimatedString 接口被定义为通过其 baseVal 和 animVal 成员反映已弃用的 ‘xlink:href’ 属性，如果该属性存在 而 ‘href’ 不存在；在所有 其他情况下则反映 ‘href’ 属性。动画元素 将 attributeName='xlink:href' 视为以 ‘href’ 属性为目标的别名。