제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 현행 표준의 가장 최근 Review Draft에 정의된 DOM을 완전히 지원해야 합니다. 단, 이후 제거되거나 폐기된 기능은 제외합니다. DOM을 지원하는 SVG 소프트웨어는 가능하면 최신 DOM 표준을 구현하는 것이 좋습니다 [DOM]
• SVG DOM은 UI Events 및 Clipboard API and events의 관련 측면을 지원해야 합니다 ([uievents], [clipboard-apis]). (필요한 구체적인 기능은 UI Events와의 관계를 참조하십시오.)
• SVG DOM은 최소한 CSS Object Model (CSSOM) 명세에서 삭제되지 않은 DOM Level 2 Style의 모든 인터페이스를 완전히 지원해야 합니다 ([dom-level-2-style]). SVG 소프트웨어는 가능하면 CSS Object Model (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 속성이 동일한 기반 데이터를 나타낸다는 의미입니다. 예를 들어 SVGRectElement의 SVGAnimatedLength ry는 연결된 ‘rect’ 요소의 ry 프레젠테이션 속성을 반영합니다.

이 반영 방식은 IDL 속성의 유형에 따라 달라집니다:

• 반영하는 IDL 속성의 유형이 원시 유형(예: SVGElement의 tabIndex에 사용되는 long) 또는 DOMString(예: SVGStyleElement의 title에 사용됨)이면, 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. 그렇지 않으면 객체의 값을 반영된 콘텐츠 속성의 기본값으로 업데이트합니다(속성이 없거나 유효하지 않은 경우 속성의 초기값을 사용).

   예를 들어 이는 SVGLength 객체의 value를 업데이트합니다.

반영된 콘텐츠 속성을 선택적으로 특정 값을 사용하여 재직렬화해야 할 때는 다음 단계를 수행해야 합니다:

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의 값 목록으로 둡니다.

      값은 SVGNumber, SVGLength, SVGPoint 또는 SVGTransform 객체이거나 DOMString 값이며, 이는 value의 유형에 따라 달라집니다.

   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 객체

      문자열은 SVGTransform 객체의 행렬 객체를 직렬화한 것입니다.

      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. viewport size와 font size를 각각 백분율 및 글꼴 크기 기준으로 사용하여 value를 절대 길이로 변환한 결과를 반환합니다. 연결된 요소가 없어 변환할 수 없다면 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을 반환합니다.

   따라서 valueInSpecifiedUnits는 '12%'와 12em 모두에 대해 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. factor를 value가 <percentage> 또는 <length>이면 그 숫자 계수로, 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의 값을 font size를 font-size 기준으로 사용하여 absolute를 unitType에 따라 em 또는 ex 단위를 가진 <length>로 변환한 결과로 설정합니다.
7. 그렇지 않으면:
   1. SVGLength의 값을 위 길이 단위 유형 표에서 unitType을 조회하여 찾은 단위를 가진 <length>로 absolute를 변환한 결과로 설정합니다.
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. factor를 value가 <angle>이면 그 숫자 계수로, 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의 값을 위 각도 단위 유형 표에서 unitType을 조회하여 찾은 단위를 가진 <angle>로 degrees를 변환한 결과로 설정합니다.
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가 transform 프로퍼티에서 지원하는 키워드 none이면 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 객체이면, 해당 행렬 객체의 구성 요소를 새 변환 함수 값과 일치하도록 설정합니다.
      5. index를 index + 1로 설정합니다.
5. 그렇지 않으면 목록 요소 유형은 DOMString입니다:
   1. 목록을 value의 값으로 이루어진 새 목록으로 바꿉니다.

목록 요소 객체를 분리해야 할 때마다 목록 요소 유형에 따라 다음 단계를 실행합니다:

SVGNumber

SVGNumber가 더 이상 어떤 요소와도 연결되지 않도록 설정합니다. SVGNumber가 읽기 전용이면 더 이상 읽기 전용이 아니도록 설정합니다.

SVGLength

SVGLength가 더 이상 어떤 요소와도 연결되지 않도록 설정합니다. SVGLength가 읽기 전용이면 더 이상 읽기 전용이 아니도록 설정합니다. SVGLength가 미지정 방향성을 가지도록 설정합니다.

SVGPoint

SVGPoint가 더 이상 어떤 요소와도 연결되지 않도록 설정합니다. SVGPoint가 읽기 전용이면 더 이상 읽기 전용이 아니도록 설정합니다.

SVGTransform

SVGTransform이 더 이상 어떤 요소와도 연결되지 않도록 설정합니다. SVGTransform이 읽기 전용이면 더 이상 읽기 전용이 아니도록 설정합니다.

DOMString

아무 작업도 하지 않습니다.

목록 요소 객체를 연결해야 할 때마다 목록 요소 유형에 따라 다음 단계를 실행합니다:

목록 인터페이스 객체의 지원되는 프로퍼티 인덱스는 목록 길이보다 작은 모든 음이 아닌 정수의 집합입니다.

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. newItem을 목록의 인덱스 index에 삽입합니다.
5. newItem을 목록 인터페이스 객체에 연결합니다.
6. 목록이 속성을 반영하거나, 속성을 반영하는 객체의 기본값을 나타낸다면 반영된 속성을 재직렬화합니다.
7. newItem을 반환합니다.

replaceItem 메서드는 목록의 기존 항목을 새 항목으로 바꾸는 데 사용됩니다. replaceItem(newItem, index)을 호출하면 다음 단계를 실행합니다:

1. 목록이 읽기 전용이면 NoModificationAllowedError를 발생시킵니다.
2. index가 목록의 길이보다 크거나 같으면 IndexSizeError를 발생시킵니다.
3. newItem이 객체 유형이고 newItem이 분리된 객체가 아니면 newItem을 newItem과 동일한 유형이며 동일한 (숫자 또는 길이) 값을 가진 새로 생성된 객체로 설정합니다.
4. 목록의 인덱스 index에 있는 요소를 분리합니다.
5. 목록의 인덱스 index에 있는 요소를 newItem으로 바꿉니다.
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 인터페이스는 이 명세에서는 사용되지 않지만 Filter Effects 명세에서는 여러 곳에서 사용됩니다.

[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. second를 명시적으로 지정되었다면 current의 두 번째 정수로, 그렇지 않으면 속성 정의에 설명된 암시적 값으로 둡니다.
   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. second를 명시적으로 지정되었다면 current의 두 번째 숫자로, 그렇지 않으면 속성 정의에 설명된 암시적 값으로 둡니다.
   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. 그렇지 않으면 반영된 속성이 있습니다. 그 값을 반환합니다.

SVGURIReference 인터페이스의 href 멤버에서는 ‘href’ 속성이 없고 폐기된 ‘xlink:href’ 속성이 있으면 그 값이 반환되고, 그 밖의 모든 경우에는 ‘href’ 속성이 반환됩니다.

baseVal을 설정할 때 다음 단계를 실행합니다:

1. 반영된 속성의 요소가 SVGScriptElement이면, Get Trusted Type compliant string 알고리즘을 TrustedScriptURL, 반영된 속성의 Document의 관련 전역 객체, 'SVGScriptElement href', 'script'와 함께 실행한 결과를 value로 둡니다.
2. 그렇지 않으면 value를 지정된 값으로 둡니다.
3. 반영된 속성이 없고 SVGAnimatedString 객체가 두 번째 폐기된 속성도 추가로 반영하도록 정의되어 있으며 해당 폐기된 속성이 있으면 그 폐기된 속성을 value로 설정합니다.
4. 그렇지 않으면 반영된 속성을 value로 설정합니다.

SVG에는 아직 완전한 스크립트 처리 모델이 없습니다. Trusted Types는 속성과 텍스트 본문 수정 보호가 HTML 스크립트의 보호와 비슷하게 동작한다고 가정합니다.

SVGURIReference 인터페이스의 href 멤버에서는 ‘href’ 속성이 없고 폐기된 ‘xlink: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’ 속성을 대상으로 하는 별칭으로 취급합니다.