4 Les types de données de base et les interfaces

Contenu

• 4.1 Les types de données de base
• 4.2 Les noms des mots-clés de couleur reconnus
• 4.3 Les interfaces du Modèle Objet de Document (DOM) de base

4.1 Les types de données de base

Les types de données communs aux propriétés et aux attributs de SVG se rangent dans les catégories suivantes :

• <entier> : un type <entier> est spécifié par un caractère de signe optionnel ('+' ou '-'), suivi par un ou plusieurs chiffres de "0" à "9". Si le caractère de signe n'est pas présent, le nombre est positif.
  À moins d'être indiqué autrement pour un attribut ou une propriété donnés, l'étendu d'un <entier> englobe (au minimum) les valeurs de -2147483648 à 2147483647.
  Dans le DOM de SVG, le type <entier> est représenté au travers des interfaces long ou SVGAnimatedInteger ;
• <nombre> (une valeur de nombre réel) : la spécification des valeurs de nombre réel est différente pour les valeurs des propriétés et pour les valeurs des attributs XML.
  • CSS2 [CSS2 vf.] déclare qu'une valeur de propriété de type <nombre> est spécifié en notation décimale (i.e., un type <nombre-décimal>), qui consiste soit en un <entier>, soit en un caractère de signe optionnel suivi par zéro ou plus chiffres suivis d'un point (.) suivi par un ou plusieurs chiffres. Ainsi, pour une conformité avec CSS2, toute propriété de SVG qui admet une valeur de type <nombre> n'est spécifiée qu'en notation décimale ;
  • Dans le cas des attributs XML de SVG, pour offrir la plus grande adaptabilité possible des valeurs numériques, les valeurs de nombre réel peuvent être données en notation décimale ou en notation scientifique (i.e., un type <nombre-scientifique>), qui consiste en un <nombre-décimal> immédiatement suivi par la lettre « e » ou « E » immédiatement suivi par un <entier>.
  À moins d'être indiqué autrement pour un attribut ou une propriété donnés, un type <nombre> a la capacité pour une précision d'au moins un chiffre derrière la virgule (voir [ICC32]) et a une étendue (au minimum) de -3.4e+38F à +3.4e+38F.
  On recommande une conservation et un calcul avec une précision plus significative pour des opérations telles que les transformations de système de coordonnées pour offrir la meilleure précision possible et pour éviter les erreurs dues aux arrondis.
  On requiert des visionneurs SVG conformes de haute qualité l'utilisation d'une précision d'au moins deux chiffres après la virgule (voir [ICC32]) pour les calculs intermédiaires dans certaines opérations numériques.
  Dans le DOM de SVG, le type <nombre> est représenté au travers des interfaces float ou SVGAnimatedNumber ;
• <longueur> : une longueur est la mesure d'une distance. Le format du type <longueur> est un <nombre>, immédiatement suivi, en option, d'un identifiant d'unité. (Remarquer que la spécification d'un <nombre> est différente pour une valeur de propriété de celle d'un attribut XML).
  Si la valeur de <longueur> est exprimée sans identifiant d'unité (par exemple 48), alors cette valeur de <longueur> représente une distance dans le système de coordonnées utilisateur courant.
  Si un des identifiants d'unité est fournie (par exemple, 12mm), alors la valeur de <longueur> est traitée selon sa description dans le chapitre Les unités.
  Les valeurs en pourcentage (par exemple, 10%) dépendent de la propriété ou de l'attribut particuliers auquel le pourcentage est assigné. Deux cas se présentent habituellement : (a) quand une valeur de pourcentage représente un pourcentage de la zone de visualisation (voir le chapitre Les unités pour le cas général) et (b) quand la valeur en pourcentage représente un pourcentage de la boîte englobante d'un objet donné (voir les descriptions au chapitre Les unités de la boîte englobante de l'object).
  Dans le DOM de SVG, le type <longueur> est représenté au travers des interfaces SVGLength ou SVGAnimatedLength ;
• <coordonnée> : un type <coordonnée> représente une <longueur>, dans le système de coordonnées utilisateur, qui correspond à la distance partant de l'origine du système de coordonnées utilisateur le long de l'axe concerné (l'axe-x pour les coordonnées X, l'axe-y pour les coordonnées Y).
  Dans le DOM de SVG, le type <coordonnée> est représenté au travers des interfaces SVGLength ou SVGAnimatedLength, les deux valeurs ayant la même syntaxe ;
• <liste de xxx> (où « xxx » représente une valeur d'un certain type) : une liste consiste en une succession de valeurs distinctes. La spécification des listes est différente pour les valeurs des propriétés et pour les valeurs des attributs XML.
  • Les valeurs des listes de valeurs de propriété sont séparées soit par des virgules, avec un blanc optionnel avant ou après la virgule, soit par des blancs, comme indiqué dans la spécification CSS2 vf. (si la propriété y est définie) ou bien dans la présente spécification (si la propriété n'est pas définie dans CSS2) ;
  • À moins d'une description explicite différente, les valeurs des listes de valeurs des attributs XML de SVG sont séparées soit par des virgules, avec un blanc optionnel avant ou après la virgule, soit par des blancs.
  On définit un blanc dans une liste comme étant un ou plus parmi les caractères consécutifs suivants : « espace » (code Unicode 32), « tabulation » (9), « saut de ligne » (10), « retour chariot » (13) et « saut de page » (12).
  Dans le DOM de SVG, le type <liste de xxx> est représenté au travers de diverses interfaces personnalisées, comme SVGTransformList.
  Voici une description grammaticale pour le type <liste de xxx> :

  ListeDeXXX:
      XXX
      | XXX virgule-blanc ListeDeXXX
  
  virgule-blanc:
      (blanc+ virgule? blanc*) | (virgule blanc*)
  
  virgule:
      ","
  
  blanc:
      (#x20 | #x9 | #xD | #xA)
  

  XXX représentant un type de valeur donné.
  
  
• <nombre-nombre-optionnel> : un cas particulier du type <liste de xxx> où il existe au moins une et au plus deux entrées dans la liste, les entrées étant du type <nombre> ;
• <angle> : une valeur d'angle est de type <nombre> immédiatement suivi en option d'un identifiant d'unité d'angle. Les identifiants d'unités d'angle sont :
  • deg : degrés
  • grad : grades
  • rad : radians
  Pour les propriétés définies dans [CSS2 vf.], on doit fournir un identifiant d'unité d'angle. Pour les propriétés et les attributs propres à SVG, l'identifiant d'unité d'angle est optionnel. Si celui-ci est absent, la valeur d'angle est censée être exprimée en degrés.
  La définition de l'interface du DOM de SVG correspondante au type <angle> est SVGAngle ou SVGAnimatedAngle ;
• <couleur> : le type de base <couleur> est une spécification de couleur compatible avec CSS2 dans l'espace de couleur sRGB [SRGB]. Le type <couleur> s'emploie avec la propriété 'color' de SVG, ce type intervient également dans les définitions des propriétés 'fill', 'stroke' 'stop-color', 'flood-color' et 'lighting-color', qui apportent aussi en option des spécifications de couleur basées sur ICC.
  SVG reconnaît toutes les syntaxes alternatives pour <couleur> qui sont définies dans les [types de couleur CSS2 vf.], excepté que SVG contient une liste développée de noms de mots-clés de couleur reconnus.
  Une valeur de <couleur> est soit un mot-clé (voir le chapitre Les noms des mots-clés de couleur reconnus) soit une spécification RGB numérique.
  En supplément, les utilisateurs peuvent spécifier d'autres mots-clés qui correspondent aux couleurs employées par les objets dans l'environnement de l'utilisateur. Voir leur définition normative dans [Les couleurs système de CSS2 vf.].
  Le format d'une valeur RGB en notation hexadécimale est un caractère '#' immédiatement suivi par trois ou bien six caractères hexadécimaux. La notation RGB en trois chiffres (#rgb) est convertie en leur forme en six chiffres (#rrggbb) par réplication des chiffres, non par ajout de zéros. Par exemple, "#fb0" se transforme en "#ffbb00". Ceci garantie que l'on puisse spécifier la couleur blanche (#ffffff) avec la notation brêve (#fff) et enlever toutes les dépendances à la profondeur de couleur de l'affichage. Le format d'une valeur RGB en notation fonctionnelle est 'rgb(' suivi par liste de trois valeurs numériques (soit trois valeurs entières, soit trois valeurs en pourcentage), séparées par une virgule, suivi par ')'. La valeur entière "255" équivaut à "100%" et "F" à "FF" en notation hexadécimale : rgb(255,255,255) = rgb(100%,100%,100%) = #FFF. Les blancs sont admis autour des valeurs numériques. Toutes les couleurs RGB sont spécifiées dans l'espace de couleur sRGB (voir [SRGB]). L'utilisation de sRGB offre une définition de la couleur objective et sans ambiguïté, qui peut être reliée aux standards internationaux (voir [COLORIMETRY]).
  Les défintions des interfaces DOM de SVG pour le type <couleur> sont décrites dans [DOM2-CSS] ; notamment, voir la section [DOM2-CSS-RGBCOLOR]. Les extensions SVG pour la couleur, y compris la possibilité de spécifier des couleurs fondées sur ICC, sont représentées par l'interface DOM SVGColor ;
• <peinture> : les valeurs des propriétés 'fill' et 'stroke' sont des spécifications du type de peinture à utiliser pour le remplissage et le tracé d'un élément graphique donné. Les options disponibles et la syntaxe pour le type <peinture> sont décrites au chapitre La spécification de la peinture.
  Dans le DOM de SVG, le type <peinture> est représenté au travers de l'interface SVGPaint ;
• <pourcentage> : le format d'une valeur en pourcentage consiste en un <nombre>, immédiatement suivi par un caractère pour-cent (%). Une valeur en pourcentage est toujours relative à une autre valeur, par exemple une longueur. Chaque attribut ou propriété, qui admettent des pourcentages, définissent aussi la mesure de la distance de référence à laquelle le pourcentage se rapporte.
  Dans le DOM de SVG, un <pourcentage> est habituellement représenté au travers des interfaces SVGLength ou SVGAnimatedLength ;
• <liste-transformation> : la description détaillée des valeurs possibles pour le type <liste-transformation> est précisée au chapitre L'attribut transform.
  Dans le DOM de SVG, le type <liste-transformation> est représenté au travers des interfaces SVGTransformList ou SVGAnimatedTransformList ;
• <uri> (une référence d'Identifiant de Ressource Uniforme [URI]) : un URI est l'adresse d'une ressource sur le Web. Pour la spécification des références d'URI en SVG, voir le passage sur les références d'URI.
  Dans le DOM de SVG, le type <uri> est représenté au travers des interfaces DOMString ou SVGAnimatedString ;
• <fréquence> : les valeurs de fréquence sont utilisées par les propriétés auditives. On peut trouver la définition normative des valeurs de fréquence dans [CSS2-AURAL vf.]. Une valeur de fréquence est un <nombre>, immédiatement suivi par un identifiant d'unité de fréquence. Les identifiants d'unité de fréquence sont :
  • Hz : Hertz
  • kHz : kilo Hertz
  Les valeurs de fréquence ne peuvent pas être négatives.
  Les définitions des interfaces DOM de SVG correspondantes sont dans [DOM2-CSS] ;
• <durée>: Une valeur de durée est un <nombre>, immédiatement suivi par un identifiant d'unité de durée. Les identifiants d'unité de durée sont :
  • ms : millisecondes
  • s : secondes
  Les valeurs de durée sont employées dans des propriétés CSS, elles ne peuvent pas être négatives.
  Les définitions des interfaces DOM de SVG correspondantes pour le type <durée> sont dans [DOM2-CSS].

4.2 Les noms des mots-clés de couleur reconnus

Voici la liste des mots-clés de couleur reconnus qui peut être employée pour une valeur de mot-clé du type de données <couleur> :

aliceblue rgb(240, 248, 255) antiquewhite rgb(250, 235, 215) aqua rgb( 0, 255, 255) aquamarine rgb(127, 255, 212) azure rgb(240, 255, 255) beige rgb(245, 245, 220) bisque rgb(255, 228, 196) black rgb( 0, 0, 0) blanchedalmond rgb(255, 235, 205) blue rgb( 0, 0, 255) blueviolet rgb(138, 43, 226) brown rgb(165, 42, 42) burlywood rgb(222, 184, 135) cadetblue rgb( 95, 158, 160) chartreuse rgb(127, 255, 0) chocolate rgb(210, 105, 30) coral rgb(255, 127, 80) cornflowerblue rgb(100, 149, 237) cornsilk rgb(255, 248, 220) crimson rgb(220, 20, 60) cyan rgb( 0, 255, 255) darkblue rgb( 0, 0, 139) darkcyan rgb( 0, 139, 139) darkgoldenrod rgb(184, 134, 11) darkgray rgb(169, 169, 169) darkgreen rgb( 0, 100, 0) darkgrey rgb(169, 169, 169) darkkhaki rgb(189, 183, 107) darkmagenta rgb(139, 0, 139) darkolivegreen rgb( 85, 107, 47) darkorange rgb(255, 140, 0) darkorchid rgb(153, 50, 204) darkred rgb(139, 0, 0) darksalmon rgb(233, 150, 122) darkseagreen rgb(143, 188, 143) darkslateblue rgb( 72, 61, 139) darkslategray rgb( 47, 79, 79) darkslategrey rgb( 47, 79, 79) darkturquoise rgb( 0, 206, 209) darkviolet rgb(148, 0, 211) deeppink rgb(255, 20, 147) deepskyblue rgb( 0, 191, 255) dimgray rgb(105, 105, 105) dimgrey rgb(105, 105, 105) dodgerblue rgb( 30, 144, 255) firebrick rgb(178, 34, 34) floralwhite rgb(255, 250, 240) forestgreen rgb( 34, 139, 34) fuchsia rgb(255, 0, 255) gainsboro rgb(220, 220, 220) ghostwhite rgb(248, 248, 255) gold rgb(255, 215, 0) goldenrod rgb(218, 165, 32) gray rgb(128, 128, 128) grey rgb(128, 128, 128) green rgb( 0, 128, 0) greenyellow rgb(173, 255, 47) honeydew rgb(240, 255, 240) hotpink rgb(255, 105, 180) indianred rgb(205, 92, 92) indigo rgb( 75, 0, 130) ivory rgb(255, 255, 240) khaki rgb(240, 230, 140) lavender rgb(230, 230, 250) lavenderblush rgb(255, 240, 245) lawngreen rgb(124, 252, 0) lemonchiffon rgb(255, 250, 205) lightblue rgb(173, 216, 230) lightcoral rgb(240, 128, 128) lightcyan rgb(224, 255, 255) lightgoldenrodyellow rgb(250, 250, 210) lightgray rgb(211, 211, 211) lightgreen rgb(144, 238, 144) lightgrey rgb(211, 211, 211)

lightpink rgb(255, 182, 193) lightsalmon rgb(255, 160, 122) lightseagreen rgb( 32, 178, 170) lightskyblue rgb(135, 206, 250) lightslategray rgb(119, 136, 153) lightslategrey rgb(119, 136, 153) lightsteelblue rgb(176, 196, 222) lightyellow rgb(255, 255, 224) lime rgb( 0, 255, 0) limegreen rgb( 50, 205, 50) linen rgb(250, 240, 230) magenta rgb(255, 0, 255) maroon rgb(128, 0, 0) mediumaquamarine rgb(102, 205, 170) mediumblue rgb( 0, 0, 205) mediumorchid rgb(186, 85, 211) mediumpurple rgb(147, 112, 219) mediumseagreen rgb( 60, 179, 113) mediumslateblue rgb(123, 104, 238) mediumspringgreen rgb( 0, 250, 154) mediumturquoise rgb( 72, 209, 204) mediumvioletred rgb(199, 21, 133) midnightblue rgb( 25, 25, 112) mintcream rgb(245, 255, 250) mistyrose rgb(255, 228, 225) moccasin rgb(255, 228, 181) navajowhite rgb(255, 222, 173) navy rgb( 0, 0, 128) oldlace rgb(253, 245, 230) olive rgb(128, 128, 0) olivedrab rgb(107, 142, 35) orange rgb(255, 165, 0) orangered rgb(255, 69, 0) orchid rgb(218, 112, 214) palegoldenrod rgb(238, 232, 170) palegreen rgb(152, 251, 152) paleturquoise rgb(175, 238, 238) palevioletred rgb(219, 112, 147) papayawhip rgb(255, 239, 213) peachpuff rgb(255, 218, 185) peru rgb(205, 133, 63) pink rgb(255, 192, 203) plum rgb(221, 160, 221) powderblue rgb(176, 224, 230) purple rgb(128, 0, 128) red rgb(255, 0, 0) rosybrown rgb(188, 143, 143) royalblue rgb( 65, 105, 225) saddlebrown rgb(139, 69, 19) salmon rgb(250, 128, 114) sandybrown rgb(244, 164, 96) seagreen rgb( 46, 139, 87) seashell rgb(255, 245, 238) sienna rgb(160, 82, 45) silver rgb(192, 192, 192) skyblue rgb(135, 206, 235) slateblue rgb(106, 90, 205) slategray rgb(112, 128, 144) slategrey rgb(112, 128, 144) snow rgb(255, 250, 250) springgreen rgb( 0, 255, 127) steelblue rgb( 70, 130, 180) tan rgb(210, 180, 140) teal rgb( 0, 128, 128) thistle rgb(216, 191, 216) tomato rgb(255, 99, 71) turquoise rgb( 64, 224, 208) violet rgb(238, 130, 238) wheat rgb(245, 222, 179) white rgb(255, 255, 255) whitesmoke rgb(245, 245, 245) yellow rgb(255, 255, 0) yellowgreen rgb(154, 205, 50)

4.3 Les interfaces DOM de base

Les interfaces suivantes sont définies ci-dessous : SVGElement, SVGAnimatedBoolean, SVGAnimatedString, SVGStringList, SVGAnimatedEnumeration, SVGAnimatedInteger, SVGNumber, SVGAnimatedNumber, SVGNumberList, SVGAnimatedNumberList, SVGLength, SVGAnimatedLength, SVGLengthList, SVGAnimatedLengthList, SVGAngle, SVGAnimatedAngle, SVGColor, SVGICCColor, SVGRect, SVGAnimatedRect, SVGUnitTypes, SVGStylable, SVGLocatable, SVGTransformable, SVGTests, SVGLangSpace, SVGExternalResourcesRequired, SVGFitToViewBox, SVGZoomAndPan, SVGViewSpec, SVGURIReference, SVGCSSRule, SVGRenderingIntent.

L'interface SVGElement

Toutes les interfaces DOM de SVG qui correspondent directement aux éléments dans le langage SVG (par exemple, l'interface SVGPathElement correspond directement à l'élément 'path' dans le langage) sont dérivés de la classe de base SVGElement.

Définition IDL

interface SVGElement : Element { 
           attribute DOMString id;
                       // déclenche DOMException à l'initialisation
           attribute DOMString xmlbase;
                       // déclenche DOMException à l'initialisation
  readonly attribute SVGSVGElement ownerSVGElement;
  readonly attribute SVGElement viewportElement;
};

Attributs

DOMString id

La valeur de l'attribut id de l'élément en question.

Exceptions à l'initialisation

DOMException

NO_MODIFICATION_ALLOWED_ERR : déclenchée lors d'une tentative de modification de la valeur d'un attribut en lecture seule.

DOMString xmlbase

Correspond à l'attribut xml:base pour l'élément en question.

Exceptions à l'initialisation

DOMException

NO_MODIFICATION_ALLOWED_ERR : déclenchée lors d'une tentative de modification de la valeur d'un attribut en lecture seule.

readonly SVGSVGElement ownerSVGElement

L'élément 'svg' ancêtre le plus proche. Nul si l'élément en question est l'élément 'svg' le plus externe.

readonly SVGElement viewportElement

L'élément qui établit la zone de visualisation courante. Souvent, l'élément 'svg' ancêtre le plus proche. Nul si l'élément en question est l'élément 'svg' le plus externe.

L'interface SVGAnimatedBoolean

Définition IDL

interface SVGAnimatedBoolean { 

           attribute boolean baseVal;
                       // déclenche DOMException à l'initialisation
  readonly attribute boolean animVal;
};

Attributs

boolean baseVal

La valeur de base de l'attribut en question avant application de toute animation.

Exceptions à l'initialisation

DOMException

NO_MODIFICATION_ALLOWED_ERR : déclenchée lors d'une tentative de modification de la valeur d'un attribut en lecture seule.

readonly boolean animVal

Si l'attribut ou la propriété en question sont en cours d'animation, contient leur valeur animée courante. Si l'attribut ou la propriété en question ne sont pas en cours d'animation, contient la même valeur que 'baseVal'.

L'interface SVGAnimatedString

Définition IDL

interface SVGAnimatedString { 

           attribute DOMString baseVal;
                       // déclenche DOMException à l'initialisation
  readonly attribute DOMString animVal;
};

Attributs

DOMString baseVal

La valeur de base de l'attribut en question avant application de toute animation.

Exceptions à l'initialisation

DOMException

NO_MODIFICATION_ALLOWED_ERR : déclenchée lors d'une tentative de modification de la valeur d'un attribut en lecture seule.

readonly DOMString animVal

Si l'attribut ou la propriété en question sont en cours d'animation, contient leur valeur animée courante. Si l'attribut ou la propriété en question ne sont pas en cours d'animation, contient la même valeur que 'baseVal'.

L'interface SVGStringList

Cette interface définit une liste d'objets de type DOMString.

SVGStringList possède les mêmes attributs et méthodes que les autres interfaces de type SVGxxxList. Les implémenteurs peuvent envisager d'utiliser une seule classe de base pour l'implémentation des diverses interfaces SVGxxxList.

Définition IDL

interface SVGStringList { 

  readonly attribute unsigned long numberOfItems;

  void   clear (  )
                  raises( DOMException );
  DOMString initialize ( in DOMString newItem )
                  raises( DOMException, SVGException );
  DOMString getItem ( in unsigned long index )
                  raises( DOMException );
  DOMString insertItemBefore ( in DOMString newItem, in unsigned long index )
                  raises( DOMException, SVGException );
  DOMString replaceItem ( in DOMString newItem, in unsigned long index )
                  raises( DOMException, SVGException );
  DOMString removeItem ( in unsigned long index )
                  raises( DOMException );
  DOMString appendItem ( in DOMString newItem )
                  raises( DOMException, SVGException );
};

Attributs

readonly unsigned long numberOfItems

Le nombre d'items de la liste.

Méthodes

clear

Efface tous les items existants courants de la liste, le résultat étant une liste vide.

Aucun paramètre

Aucune valeur retournée

Exceptions

DOMException

NO_MODIFICATION_ALLOWED_ERR : déclenchée quand la liste ne peut être modifiée.

initialize

Efface tous les items existants courants de la liste et ré-initialise celle-ci pour recevoir le seul item spécifié en paramètre.

Paramètres

in DOMString newItem

L'item qui devrait devenir le seul membre de la liste.

Valeur retournée

DOMString

L'item qui est inséré dans la liste.

Exceptions

DOMException		NO_MODIFICATION_ALLOWED_ERR : déclenchée quand la liste ne peut être modifiée.
SVGException		SVG_WRONG_TYPE_ERR : déclenchée si le paramètre newItem n'est pas un objet du bon type pour la liste en question.

getItem

Retourne l'item spécifié de la liste.

Paramètres

in unsigned long index

L'index de l'item de la liste qui doit être retourné. Le premier item porte le numéro 0.

Valeur retournée

DOMString

L'item sélectionné.

Exceptions

DOMException

INDEX_SIZE_ERR : déclenchée si le numéro de l'index est négatif ou supérieur ou égal à la valeur du paramètre numberOfItems.

insertItemBefore

Insère un nouvel item dans la liste à la position spécifiée. Le premier item porte le numéro 0. Si newItem est déjà dans une liste, il est retiré de sa liste précédente avant d'être inséré dans cette liste.

Paramètres

in DOMString newItem		L'item qui doit être inséré dans la liste.
in unsigned long index		L'index de l'item avant lequel le nouvel item doit être inséré. Le premier item porte le numéro 0. Si l'index est égal à 0, alors le nouvel item est inséré au début de la liste. Si l'index est supérieur ou égal à la valeur du paramètre numberOfItems, alors le nouvel item est rattaché à la fin de la liste.

Valeur retournée

DOMString

L'item inséré.

Exceptions

DOMException		NO_MODIFICATION_ALLOWED_ERR : déclenchée quand la liste ne peut être modifiée.
SVGException		SVG_WRONG_TYPE_ERR : déclenchée si le paramètre newItem n'est pas un objet du bon type pour la liste en question.

replaceItem

Remplace un item existant dans la liste par un nouvel item. Si newItem est déjà dans une liste, il est retiré de la liste précédente avant d'être inséré dans cette liste.

Paramètres

in DOMString newItem		L'item qui doit être inséré dans la liste.
in unsigned long index		L'index de l'item qui doit être remplacé. Le premier item porte le numéro 0.

Valeur retournée

DOMString

L'item inséré.

Exceptions

DOMException		NO_MODIFICATION_ALLOWED_ERR : déclenchée quand la liste ne peut être modifiée. INDEX_SIZE_ERR : déclenchée si le numéro de l'index est négatif ou supérieur ou égal à la valeur du paramètre numberOfItems.
SVGException		SVG_WRONG_TYPE_ERR : déclenchée si le paramètre newItem n'est pas un objet du bon type pour la liste en question.

removeItem

Retire un item existant de la liste.

Paramètres

in unsigned long index

L'index de l'item qui doit être retiré. Le premier item porte le numéro 0.

Valeur retournée

DOMString

L'item retiré.

Exceptions

DOMException

NO_MODIFICATION_ALLOWED_ERR : déclenchée quand la liste ne peut être modifiée. INDEX_SIZE_ERR : déclenchée si le numéro de l'index est négatif ou supérieur ou égal à la valeur du paramètre numberOfItems.

appendItem

Insère un nouvel item à la fin de la liste. Si newItem est déjà dans une liste, il est retiré de la liste précédente avant d'être inséré dans cette liste.

Paramètres

in DOMString newItem

L'item qui doit être inséré dans la liste. Le premier item porte le numéro 0.

Valeur retournée

DOMString

L'item inséré.

Exceptions

DOMException		NO_MODIFICATION_ALLOWED_ERR : déclenchée quand la liste ne peut être modifiée.
SVGException		SVG_WRONG_TYPE_ERR : déclenchée si le paramètre newItem n'est pas un objet du bon type pour la liste en question.

L'interface SVGAnimatedEnumeration

Définition IDL

interface SVGAnimatedEnumeration { 

           attribute unsigned short baseVal;
                       // déclenche DOMException à l'initialisation
  readonly attribute unsigned short animVal;
};

Attributs

unsigned short baseVal

La valeur de base de l'attribut en question avant l'application de toute animation.

Exceptions à l'initialisation

DOMException

NO_MODIFICATION_ALLOWED_ERR : déclenchée lors d'une tentative de modification de la valeur d'un attribut en lecture seule.

readonly unsigned short animVal

Si l'attribut ou la propriété en question sont en cours d'animation, contient leur valeur animée courante. Si l'attribut ou la propriété en question ne sont pas en cours d'animation, contient la même valeur que 'baseVal'.

L'interface SVGAnimatedInteger

Définition IDL

interface SVGAnimatedInteger { 

           attribute long baseVal;
                       // déclenche DOMException à l'initialisation
  readonly attribute long animVal;
};

Attributs

long baseVal

La valeur de base de l'attribut en question avant l'application de toute animation.

Exceptions à l'initialisation

DOMException

NO_MODIFICATION_ALLOWED_ERR : déclenchée lors d'une tentative de modification de la valeur d'un attribut en lecture seule.

readonly long animVal

Si l'attribut ou la propriété en question sont en cours d'animation, contient leur valeur animée courante. Si l'attribut ou la propriété en question ne sont pas en cours d'animation, contient la même valeur que 'baseVal'.

L'interface SVGNumber

Définition IDL

interface SVGNumber { 

           attribute float value;
                       // déclenche DOMException à l'initialisation
};

Attributs

float value

La valeur de l'attribut en question

Exceptions à l'initialisation

DOMException

NO_MODIFICATION_ALLOWED_ERR : déclenchée lors d'une tentative de modification de la valeur d'un attribut en lecture seule.

L'interface SVGAnimatedNumber

Définition IDL

interface SVGAnimatedNumber { 

           attribute float baseVal;
                       // déclenche DOMException à l'initialisation
  readonly attribute float animVal;
};

Attributs

float baseVal

La valeur de base de l'attribut en question avant l'application de toute animation.

Exceptions à l'initialisation

DOMException

NO_MODIFICATION_ALLOWED_ERR : déclenchée lors d'une tentative de modification de la valeur d'un attribut en lecture seule.

readonly float animVal

Si l'attribut ou la propriété en question sont en cours d'animation, contient leur valeur animée courante. Si l'attribut ou la propriété en question ne sont pas en cours d'animation, contient la même valeur que 'baseVal'.

L'interface SVGNumberList

Cette interface définit une liste d'objets SVGNumber.

L'interface SVGNumberList possède les mêmes attributs et méthodes que les autres interfaces SVGxxxList. Les implémenteurs peuvent envisager d'utiliser une seule classe de base pour l'implémentation des diverses interfaces SVGxxxList.

Définition IDL

interface SVGNumberList { 

  readonly attribute unsigned long numberOfItems;

  void   clear (  )
                  raises( DOMException );
  SVGNumber initialize ( in SVGNumber newItem )
                  raises( DOMException, SVGException );
  SVGNumber getItem ( in unsigned long index )
                  raises( DOMException );
  SVGNumber insertItemBefore ( in SVGNumber newItem, in unsigned long index )
                  raises( DOMException, SVGException );
  SVGNumber replaceItem ( in SVGNumber newItem, in unsigned long index )
                  raises( DOMException, SVGException );
  SVGNumber removeItem ( in unsigned long index )
                  raises( DOMException );
  SVGNumber appendItem ( in SVGNumber newItem )
                  raises( DOMException, SVGException );
};

Attributs

readonly unsigned long numberOfItems

Le nombre d'items dans la liste.

Méthodes

clear

Efface tous les items existants courants de la liste, le résultat étant une liste vide.

Aucun paramètre

Aucune valeur retournée

Exceptions

DOMException

NO_MODIFICATION_ALLOWED_ERR : déclenchée quand la liste ne peut être modifiée.

initialize

Efface tous les items existants courants de la liste et ré-initialise celle-ci pour recevoir le seul item spécifié en paramètre.

Paramètres

in SVGNumber newItem

L'iteme qui devrait devenir le seul membre de la liste.

Valeur retournée

SVGNumber

L'item qui doit être inséré dans la liste.

Exceptions

DOMException		NO_MODIFICATION_ALLOWED_ERR : déclenchée quand la liste ne peut être modifiée.
SVGException		SVG_WRONG_TYPE_ERR : déclenchée si le paramètre newItem n'est pas un objet du bon type pour la liste en question.

getItem

Retourne l'item spécifié de la liste.

Paramètres

in unsigned long index

L'index de l'item de la liste qui doit être retourné. Le premier item porte le numéro 0.

Valeur retournée

SVGNumber

L'item sélectionné

Exceptions

DOMException

INDEX_SIZE_ERR : déclenchée si le numéro de l'index est négatif ou supérieur ou égal à la valeur du paramètre numberOfItems.

insertItemBefore

Insère un nouvel item dans la liste à l'endroit spécifié. Le premier item porte le numéro 0. Si newItem est déjà dans une liste, il est retiré de la liste précédente avant d'être inséré dans cette liste.

Paramètres

in SVGNumber newItem		L'item qui doit être inséré dans la liste.
in unsigned long index		L'index de l'item avant lequel le nouvel item doit être inséré. Le premier item porte le numéro 0. Si l'index est égal à 0, alors le nouvel item est inséré au début de la liste. Si l'index est supérieur ou égal à la valeur de numberOfItems, alors le nouvel item est rattaché à la fin de liste.

Valeur retournée

SVGNumber

L'item inséré.

Exceptions

DOMException		NO_MODIFICATION_ALLOWED_ERR : déclenchée quand la liste ne peut être modifiée.
SVGException		SVG_WRONG_TYPE_ERR : déclenchée si le paramètre newItem n'est pas un objet du bon type pour la liste en question.

replaceItem

Remplace un item existant dans la liste par un nouvel item. Si newItem est déjà dans une liste, il est retiré de la liste précédente avant d'être inséré dans cette liste.

Paramètres

in SVGNumber newItem		L'item qui doit être inséré dans la liste.
in unsigned long index		L'index de l'item qui doit être remplacé. Le premier item porte le numéro 0.

Valeur retournée

SVGNumber

L'item inséré.

Exceptions

DOMException		NO_MODIFICATION_ALLOWED_ERR : déclenchée quand la liste ne peut être modifiée. INDEX_SIZE_ERR : déclenchée si le numéro de l'index est négatif ou supérieur ou égal à la valeur du paramètre numberOfItems.
SVGException		SVG_WRONG_TYPE_ERR : déclenchée si le paramètre newItem n'est pas un objet du bon type pour la liste en question.

removeItem

Retire un item existant de la liste.

Paramètres

in unsigned long index

L'index de l'item qui doit être retiré. Le premier item porte le numéro 0.

Valeur retournée

SVGNumber

L'item retiré.

Exceptions

DOMException

NO_MODIFICATION_ALLOWED_ERR : déclenchée quand la liste ne peut être modifiée. INDEX_SIZE_ERR : déclenchée si le numéro de l'index est négatif ou supérieur ou égal à la valeur du paramètre numberOfItems.

appendItem

Insère un nouvel item à la fin de la liste. Si newItem est déjà dans une liste, il est retiré de la liste précédente avant d'être inséré dans cette liste.

Paramètres

in SVGNumber newItem

L'item qui doit être inséré dans la liste. Le premier item porte le numéro 0.

Valeur retournée

SVGNumber

L'item inséré.

Exceptions

DOMException		NO_MODIFICATION_ALLOWED_ERR : déclenchée quand la liste ne peut être modifiée.
SVGException		SVG_WRONG_TYPE_ERR : déclenchée si le paramètre newItem n'est pas un objet du bon type pour la liste en question.

L'interface SVGAnimatedNumberList

Définition IDL

interface SVGAnimatedNumberList { 

  readonly attribute SVGNumberList baseVal;
  readonly attribute SVGNumberList animVal;
};

Attributs

readonly SVGNumberList baseVal

La valeur de base de l'attribut en question avant l'application de toute animation.

readonly SVGNumberList animVal

Si l'attribut ou la propriété en question sont en cours d'animation, alors cet attribut contient la valeur animée courante de l'attribut ou de la propriété et l'objet lui-même et son contenu sont tous deux en lecture seule. Si l'attribut ou la propriété en question ne sont pas en cours d'animation, alors cet attribut contient la même valeur que 'baseVal'.

L'interface SVGLength

L'interface SVGLength correspond au type de données de base <longueur>.

Définition IDL

interface SVGLength { 

  // Types d'unité de longueur
  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;
                       // déclenche DOMException à l'initialisation
           attribute float          valueInSpecifiedUnits;
                       // déclenche DOMException à l'initialisation
           attribute DOMString      valueAsString;
                       // déclenche DOMException à l'initialisation

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

Groupe de définition des types d'unité de longueur

Constantes définies

SVG_LENGTHTYPE_UNKNOWN		Le type d'unité ne fait pas partie de ceux prédéfinis. Tenter de définir une nouvelle valeur de ce type ou tenter de changer une valeur existante vers ce type est illégal.
SVG_LENGTHTYPE_NUMBER		Aucun type d'unité n'a été fourni (i.e. une valeur sans unité a été spécifiée), ce qui indique une valeur en unités utilisateur.
SVG_LENGTHTYPE_PERCENTAGE		Une valeur en pourcentage a été spécifiée.
SVG_LENGTHTYPE_EMS		Une valeur a été spécifiée en unité « em », définie dans CSS2.
SVG_LENGTHTYPE_EXS		Une valeur a été spécifiée en unité « ex », définie dans CSS2.
SVG_LENGTHTYPE_PX		Une valeur a été spécifiée en unité « px », définie dans CSS2.
SVG_LENGTHTYPE_CM		Une valeur a été spécifiée en unité « cm », définie dans CSS2.
SVG_LENGTHTYPE_MM		Une valeur a été spécifiée en unité « mm », définie dans CSS2.
SVG_LENGTHTYPE_IN		Une valeur a été spécifiée en unité « in », définie dans CSS2.
SVG_LENGTHTYPE_PT		Une valeur a été spécifiée en unité « pt », définie dans CSS2.
SVG_LENGTHTYPE_PC		Une valeur a été spécifiée en unité « pc », définie dans CSS2.

Attributs

readonly unsigned short unitType

Le type de la valeur comme spécifié par l'une des constantes indiquées ci-dessus.

float value

La valeur en valeur décimale, en unités utilisateur. Le fait de donner une valeur à cet attribut va provoquer en retour une mise à jour automatique des paramètres valueInSpecifiedUnits et valueAsString.

Exceptions à l'initialisation

DOMException

NO_MODIFICATION_ALLOWED_ERR : déclenchée lors d'une tentative de modification de la valeur d'un attribut en lecture seule.

float valueInSpecifiedUnits

La valeur en valeur décimale, dans l'unité exprimée par le paramètre unitType. Le fait de donner une valeur à cet attribut va provoquer en retour une mise à jour automatique des paramètres value et valueAsString.

Exceptions à l'initialisation

DOMException

NO_MODIFICATION_ALLOWED_ERR : déclenchée lors d'une tentative de modification de la valeur d'un attribut en lecture seule.

DOMString valueAsString

La valeur en valeur de chaîne, dans l'unité exprimée par le paramètre unitType. Le fait de donner une valeur à cet attribut va provoquer en retour une mise à jour automatique des paramètres value et valueAsString.

Exceptions à l'initialisation

DOMException

NO_MODIFICATION_ALLOWED_ERR : déclenchée lors d'une tentative de modification de la valeur d'un attribut en lecture seule.

Méthodes

newValueSpecifiedUnits

Ré-initialise la valeur comme nombre avec un type d'unité unitType associé, remplaçant ainsi les valeurs de tous les attributs de l'objet.

Paramètres

in unsigned short unitType		Le type d'unité unitType pour la valeur (par exemple, SVG_LENGTHTYPE_MM).
in float valueInSpecifiedUnits		La nouvelle valeur.

Aucune valeur retournée

Aucune exception

convertToSpecifiedUnits

Préserve la même valeur stockée sous-jacente, mais ré-initialise l'identifiant d'unité stocké pour le type d'unité unitType donné. Les attributs d'objet unitType, valueAsSpecified et valueAsString peuvent être modifiés suite à l'emploi de cette méthode. Par exemple, si la valeur originale était "0.5cm" et la méthode avait été invoquée pour une conversion en millimètres, alors unitType aurait été changé pour SVG_LENGTHTYPE_MM, valueAsSpecified pour la valeur numérique "5" et valueAsString pour "5mm".

Paramètres

in unsigned short unitType

Le type d'unité unitType vers lequel basculer (par exemple, SVG_LENGTHTYPE_MM).

Aucune valeur retournée

Aucune exception

L'interface SVGAnimatedLength

Définition IDL

interface SVGAnimatedLength { 

  readonly attribute SVGLength baseVal;
  readonly attribute SVGLength animVal;
};

Attributs

readonly SVGLength baseVal

La valeur de base de l'attribut en question avant l'application de toute animation.

readonly SVGLength animVal

Si l'attribut ou la propriété en question sont en cours d'animation, contient leur valeur animée courante et l'objet lui-même et son contenu sont tous deux en lecture seule. Si l'attribut ou la propriété en question ne sont pas en cours d'animation, contient la même valeur que 'baseVal'.

L'interface SVGLengthList

Cette interface définit une liste d'objets SVGLength.

L'interface SVGLengthList possède les mêmes attributs et méthodes que les autres interfaces SVGxxxList. Les implémenteurs peuvent envisager d'utiliser une seule classe de base pour l'implémentation des diverses interfaces SVGxxxList.

Définition IDL

interface SVGLengthList { 

  readonly attribute unsigned long numberOfItems;

  void   clear (  )
                  raises( DOMException );
  SVGLength initialize ( in SVGLength newItem )
                  raises( DOMException, SVGException );
  SVGLength getItem ( in unsigned long index )
                  raises( DOMException );
  SVGLength insertItemBefore ( in SVGLength newItem, in unsigned long index )
                  raises( DOMException, SVGException );
  SVGLength replaceItem ( in SVGLength newItem, in unsigned long index )
                  raises( DOMException, SVGException );
  SVGLength removeItem ( in unsigned long index )
                  raises( DOMException );
  SVGLength appendItem ( in SVGLength newItem )
                  raises( DOMException, SVGException );
};

Attributs

readonly unsigned long numberOfItems

Le nombre d'items dans la liste.

Méthodes

clear

Efface tous les items existants courants de la liste, le résultat étant une liste vide.

Aucun paramètre

Aucune valeur retournée

Exceptions

DOMException

NO_MODIFICATION_ALLOWED_ERR : déclenchée quand la liste ne peut être modifiée.

initialize

Efface tous les items existants courants de la liste et ré-initialise celle-ci pour recevoir le seul item spécifié en paramètre.

Paramètres

in SVGLength newItem

L'item qui devrait devenir le seul membre de la liste.

Valeur retournée

SVGLength

L'item qui doit être inséré dans la liste.

Exceptions

DOMException		NO_MODIFICATION_ALLOWED_ERR : déclenchée quand la liste ne peut être modifiée.
SVGException		SVG_WRONG_TYPE_ERR : déclenchée si le paramètre newItem n'est pas un objet du bon type pour la liste en question.

getItem

Retourne l'item spécifié de la liste.

Paramètres

in unsigned long index

L'index de l'item de la liste qui doit être retourné. Le premier item porte le numéro 0.

Valeur retournée

SVGLength

L'item sélectionné

Exceptions

DOMException

INDEX_SIZE_ERR : déclenchée si le numéro de l'index est négatif ou supérieur ou égal à la valeur du paramètre numberOfItems.

insertItemBefore

Insère un nouvel item dans la liste à l'endroit spécifié. Le premier item porte le numéro 0. Si newItem est déjà dans une liste, il est retiré de la liste précédente avant d'être inséré dans cette liste.

Paramètres

in SVGLength newItem		L'item qui doit être inséré dans la liste.
in unsigned long index		L'index de l'item avant lequel le nouvel item doit être inséré. Le premier item porte le numéro 0. Si l'index est égal à 0, alors le nouvel item est inséré au début de la liste. Si l'index est supérieur ou égal à la valeur de numberOfItems, alors le nouvel item est rattaché à la fin de la liste.

Valeur retournée

SVGLength

L'item inséré.

Exceptions

DOMException		NO_MODIFICATION_ALLOWED_ERR : déclenchée quand la liste ne peut être modifiée.
SVGException		SVG_WRONG_TYPE_ERR : déclenchée si le paramètre newItem n'est pas un objet du bon type pour la liste en question.

replaceItem

Remplace un item existant dans la liste par un nouvel item. Si newItem est déjà dans une liste, il est retiré de la liste précédente avant d'être inséré dans cette liste.

Paramètres

in SVGLength newItem		L'item qui doit être inséré dans la liste.
in unsigned long index		L'index de l'item qui doit être remplacé. Le premier item porte le numéro 0.

Valeur retournée

SVGLength

L'item inséré.

Exceptions

DOMException		NO_MODIFICATION_ALLOWED_ERR : déclenchée quand la liste ne peut être modifiée. INDEX_SIZE_ERR : déclenchée si le numéro de l'index est négatif ou supérieur ou égal à la valeur du paramètre numberOfItems.
SVGException		SVG_WRONG_TYPE_ERR : déclenchée si le paramètre newItem n'est pas un objet du bon type pour la liste en question.

removeItem

Retire un item existant de la liste.

Paramètres

in unsigned long index

L'index de l'item qui doit être retiré. Le premier item porte le numéro 0.

Valeur retournée

SVGLength

L'item retiré.

Exceptions

DOMException

NO_MODIFICATION_ALLOWED_ERR : déclenchée quand la liste ne peut être modifiée. INDEX_SIZE_ERR : déclenchée si le numéro de l'index est négatif ou supérieur ou égal à la valeur du paramètre numberOfItems.

appendItem

Insère un nouvel item à la fin de la liste. Si newItem est déjà dans une liste, il est retiré de la liste précédente avant d'être inséré dans cette liste.

Paramètres

in SVGLength newItem

L'item qui doit être inséré dans la liste. Le premier item porte le numéro 0.

Valeur retournée

SVGLength

L'item inséré.

Exceptions

DOMException		NO_MODIFICATION_ALLOWED_ERR : déclenchée quand la liste ne peut être modifiée.
SVGException		SVG_WRONG_TYPE_ERR : déclenchée si le paramètre newItem n'est pas un objet du bon type pour la liste en question.

L'interface SVGAnimatedLengthList

Définition IDL

interface SVGAnimatedLengthList { 

  readonly attribute SVGLengthList baseVal;
  readonly attribute SVGLengthList animVal;
};

Attributs

readonly SVGLengthList baseVal

La valeur de base de l'attribut en question avant l'application de toute animation.

readonly SVGLengthList animVal

Si l'attribut ou la propriété en question sont en cours d'animation, contient leur valeur animée courante et l'objet lui-même et son contenu sont tous deux en lecture seule. Si l'attribut ou la propriété en question ne sont pas en cours d'animation, contient la même valeur que 'baseVal'.

L'interface SVGAngle

The SVGAngle interface corresponds to the <angle> basic data type.

Définition IDL

interface SVGAngle { 

  // Angle Unit Types
  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;
                       // déclenche DOMException à l'initialisation
           attribute float          valueInSpecifiedUnits;
                       // déclenche DOMException à l'initialisation
           attribute DOMString      valueAsString;
                       // déclenche DOMException à l'initialisation

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

Definition group Angle Unit Types

Constantes définies

SVG_ANGLETYPE_UNKNOWN		Le type d'unité ne fait pas partie de ceux prédéfinis. Tenter de définir une nouvelle valeur de ce type ou tenter de changer une valeur existante vers ce type est illégal.
SVG_ANGLETYPE_UNSPECIFIED		Aucun type d'unité n'a été fourni (i.e., une valeur sans unité a été spécifiée). Pour les angles, une valeur nue est traitée comme si des degrés avaient été spécifiés.
SVG_ANGLETYPE_DEG		Le type d'unité a été donné explicitement en degrés.
SVG_ANGLETYPE_RAD		Le type d'unité est donné en radians.
SVG_ANGLETYPE_GRAD		Le type d'unité est donné en grades.

Attributs

readonly unsigned short unitType

Le type de la valeur tel que spécifié par l'une des constantes indiquées ci-dessus.

float value

La valeur d'angle en valeur décimale, en degrés. Le fait de donner une valeur à cet attribut va provoquer en retour la mise à jour des paramètres valueInSpecifiedUnits et valueAsString.

Exceptions à l'initialisation

DOMException

NO_MODIFICATION_ALLOWED_ERR : déclenchée lors d'une tentative de modification de la valeur d'un attribut en lecture seule.

float valueInSpecifiedUnits

La valeur d'angle en valeur décimale, dans l'unité exprimée par unitType. Le fait de donner une valeur à cet attribut va provoquer en retour la mise à jour des paramètres value et valueAsString.

Exceptions à l'initialisation

DOMException

NO_MODIFICATION_ALLOWED_ERR : déclenchée lors d'une tentative de modification de la valeur d'un attribut en lecture seule.

DOMString valueAsString

La valeur d'angle en valeur de chaîne, dans l'unité exprimée par unitType. Le fait de donner une valeur à cet attribut va provoquer en retour la mise à jour des paramètres value et valueInSpecifiedUnits.

Exceptions à l'initialisation

DOMException

NO_MODIFICATION_ALLOWED_ERR : déclenchée lors d'une tentative de modification de la valeur d'un attribut en lecture seule.

Méthodes

newValueSpecifiedUnits

Ré-initialise la valeur comme un nombre avec un type d'unité unitType associé, remplaçant ainsi les valeurs de tous les attributs de l'objet.

Paramètres

in unsigned short unitType		Le type d'unité unitType pour la valeur d'angle (par exemple, SVG_ANGLETYPE_DEG).
in float valueInSpecifiedUnits		La valeur d'angle.

Aucune valeur retournée

Aucune exception

convertToSpecifiedUnits

Préserve la même valeur stockée sous-jacente, mais ré-initialise l'identifiant d'unité pour le type d'unité unitType. Les attributs de l'objet unitType, valueAsSpecified et valueAsString peuvent être modifié à la suite de cette méthode.

Paramètres

in unsigned short unitType

Le type d'unité unitType vers lequel basculer (par exemple, SVG_ANGLETYPE_DEG).

Aucune valeur retournée

Aucune exception

L'interface SVGAnimatedAngle

Définition IDL

interface SVGAnimatedAngle { 

  readonly attribute SVGAngle baseVal;
  readonly attribute SVGAngle animVal;
};

Attributs

readonly SVGAngle baseVal

La valeur de base de l'attribut en question avant l'application de toute animation.

readonly SVGAngle animVal

Si l'attribut ou la propriété en question sont en cours d'animation, contient leur valeur animée courante et l'objet lui-même et son contenu sont tous deux en lecture seule. Si l'attribut ou la propriété en question ne sont pas en cours d'animation, contient la même valeur que 'baseVal'.

L'interface SVGColor

L'interface SVGColor correspond à la définition de valeur de couleur pour les propriétés 'stop-color', 'flood-color' et 'lighting-color', c'est aussi une classe de base pour l'interface SVGPaint. Elle incorpore la notion de couleur étendue de SVG, qui comprend des spécifications de couleur basées sur ICC.

L'interface SVGColor ne correspond pas au type de données de base <couleur>. Pour le type de données de base <couleur>, les interfaces DOM concernées sont définies dans [DOM2-CSS] ; notamment, voir [DOM2-CSS-RGBCOLOR].

Définition IDL

interface SVGColor : css::CSSValue { 
  // Types de couleur
  const unsigned short SVG_COLORTYPE_UNKNOWN           = 0;
  const unsigned short SVG_COLORTYPE_RGBCOLOR          = 1;
  const unsigned short SVG_COLORTYPE_RGBCOLOR_ICCCOLOR = 2;
  const unsigned short SVG_COLORTYPE_CURRENTCOLOR      = 3;

  readonly attribute unsigned short colorType;
  readonly attribute css::RGBColor  rgbColor;
  readonly attribute SVGICCColor    iccColor;

  void        setRGBColor ( in DOMString rgbColor )
                  raises( SVGException );
  void        setRGBColorICCColor ( in DOMString rgbColor, in DOMString iccColor )
                  raises( SVGException );
  void        setColor ( in unsigned short colorType, in DOMString rgbColor, in DOMString iccColor )
                  raises( SVGException );
};

Groupe de définition des types de couleur

Constantes définies

SVG_COLORTYPE_UNKNOWN		Le type de couleur ne fait pas partie des types prédéfinis. Tenter de définir une nouvelle valeur de ce type ou tenter de changer une valeur existante vers ce type est illégal.
SVG_COLORTYPE_RGBCOLOR		Une couleur sRGB a été spécifiée sans la spécification d'une couleur ICC alternative.
SVG_COLORTYPE_RGBCOLOR_ICCCOLOR		Une couleur sRGB a été spécifiée en même temps qu'une spécification d'une couleur ICC alternative.
SVG_COLORTYPE_CURRENTCOLOR		Correspond quand le mot-clé 'currentColor' a été spécifié.

Attributs

readonly unsigned short colorType

Le type de la valeur tel que spécifié par l'une des constantes indiquées ci-dessus.

readonly css::RGBColor rgbColor

La couleur spécifiée dans l'espace de couleur sRGB.

readonly SVGICCColor iccColor

La spécification d'une couleur ICC alternative.

Méthodes

setRGBColor

Modifie la valeur de couleur pour être la couleur sRGB spécifiée, sans spécification de couleur ICC alternative.

Paramètres

in DOMString rgbColor

La nouvelle valeur de couleur.

Aucune valeur retournée

Exceptions

SVGException

SVG_INVALID_VALUE_ERR : déclenchée si l'un des paramètres a une valeur illégale.

setRGBColorICCColor

Modifie la valeur de couleur pour être la couleur sRGB spécifiée, avec une spécification de couleur ICC alternative.

Paramètres

in DOMString rgbColor		La nouvelle valeur de couleur.
in DOMString iccColor		La spécification de couleur ICC alternative.

Aucune valeur retournée

Exceptions

SVGException

SVG_INVALID_VALUE_ERR : déclenchée si l'un des paramètres a une valeur illégale.

setColor

Fixe le type de couleur colorType comme spécifié par les paramètres. Si colorType requiert un type RGBColor, alors rgbColor doit être un objet RGBColor valide ; sinon rgbColor doit être nul. Si colorType requiert un type SVGICCColor, alors iccColor doit être un objet SVGICCColor valide ; sinon, iccColor doit être nul.

Paramètres

in unsigned short colorType		Une des constantes définies pour colorType.
in DOMString rgbColor		La spécification d'une couleur sRGB ou une valeur nulle.
in DOMString iccColor		La spécification d'une couleur ICC ou une valeur nulle.

Aucune valeur retournée

Exceptions

SVGException

SVG_INVALID_VALUE_ERR : déclenchée si l'un des paramètres a une valeur illégale.

L'interface SVGICCColor

L'interface SVGICCColor exprime une spécification de couleur basée sur ICC.

Définition IDL

interface SVGICCColor { 

           attribute DOMString      colorProfile;
                       // déclenche DOMException à l'initialisation
  readonly attribute SVGNumberList colors;
};

Attributs

DOMString colorProfile

Le nom du profil de couleur, qui est le premier paramètre d'un spécification de couleur ICC.

Exceptions à l'initialisation

DOMException

NO_MODIFICATION_ALLOWED_ERR : déclenchée lors d'une tentative de modification de la valeur d'un attribut en lecture seule.

readonly SVGNumberList colors

La liste des valeurs de couleur qui définissent cette couleur ICC. Chaque valeur de couleur est un nombre décimal arbitraire.

L'interface SVGRect

On définit les rectangles comme consistant en une paire de coordonnées (x,y) identifiant une valeur minimum X, une valeur minimum Y et une hauteur et une largeur, généralement contraintes pour ne pas être négatives.

Définition IDL

interface SVGRect { 

           attribute float x;
                       // déclenche DOMException à l'initialisation
           attribute float y;
                       // déclenche DOMException à l'initialisation
           attribute float width;
                       // déclenche DOMException à l'initialisation
           attribute float height;
                       // déclenche DOMException à l'initialisation
};

Attributs

float x

Correspond à l'attribut x de l'élément en question.

Exceptions à l'initialisation

DOMException

NO_MODIFICATION_ALLOWED_ERR : déclenchée lors d'une tentative de modification de la valeur d'un attribut en lecture seule.

float y

Correspond à l'attribut y de l'élément en question.

Exceptions à l'initialisation

DOMException

NO_MODIFICATION_ALLOWED_ERR : déclenchée lors d'une tentative de modification de la valeur d'un attribut en lecture seule.

float width

Correspond à l'attribut width de l'élément en question.

Exceptions à l'initialisation

DOMException

NO_MODIFICATION_ALLOWED_ERR : déclenchée lors d'une tentative de modification de la valeur d'un attribut en lecture seule.

float height

Correspond à l'attribut height de l'élément en question.

Exceptions à l'initialisation

DOMException

NO_MODIFICATION_ALLOWED_ERR : déclenchée lors d'une tentative de modification de la valeur d'un attribut en lecture seule.

L'interface SVGAnimatedRect

Définition IDL

interface SVGAnimatedRect { 

  readonly attribute SVGRect baseVal;
  readonly attribute SVGRect animVal;
};

Attributs

readonly SVGRect baseVal

La valeur de base de l'attribut en question avant l'application de toute animation.

readonly SVGRect animVal

Si l'attribut ou la propriété en question sont en cours d'animation, contient leur valeur animée courante et l'objet lui-même et son contenu sont tous deux en lecture seule. Si l'attribut ou la propriété en question ne sont pas en cours d'animation, contient la même valeur que 'baseVal'.

L'interface SVGUnitTypes

L'interface SVGUnitTypes définit un jeu de constantes couramment employé, c'est aussi une interface de base utilisée par SVGGradientElement, SVGPatternElement, SVGClipPathElement, SVGMaskElement et SVGFilterElement.

Définition IDL

interface SVGUnitTypes { 

  // Unit Types
  const unsigned short SVG_UNIT_TYPE_UNKNOWN           = 0;
  const unsigned short SVG_UNIT_TYPE_USERSPACEONUSE    = 1;
  const unsigned short SVG_UNIT_TYPE_OBJECTBOUNDINGBOX = 2;
};

Groupe de définition des types d'unités

Constantes définies

SVG_UNIT_TYPE_UNKNOWN		Le type ne fait pas partie de ceux prédéfinis. Tenter de définir une nouvelle valeur de ce type ou tenter de changer une valeur existante vers ce type est illégal.
SVG_UNIT_TYPE_USERSPACEONUSE		Correspond à la valeur de userSpaceOnUse.
SVG_UNIT_TYPE_OBJECTBOUNDINGBOX		Correspond à la valeur de objectBoundingBox.

L'interface SVGStylable

Définition IDL

interface SVGStylable { 

  readonly attribute SVGAnimatedString className;
  readonly attribute css::CSSStyleDeclaration style;

  css::CSSValue getPresentationAttribute ( in DOMString name );
};

Attributs

readonly SVGAnimatedString className

Correspond à l'attribut class de l'élément en question.

readonly css::CSSStyleDeclaration style

Correspond à l'attribut style de l'élément en question. Si l'agent utilisateur ne reconnaît pas le style avec CSS, alors cet attribut doit toujours avoir une valeur nulle.

Méthodes

getPresentationAttribute

Retourne la valeur de base (i.e., statique) d'un attribut de présentation donné en tant qu'objet de type CSSValue. L'objet retourné est vivant ; les changements apportés aux objets représentent des changements immédiats sur les objets auxquels CSSValue est rattaché.

Paramètres

in DOMString name

Rapporte un « attribut de présentation » par son nom.

Valeur retournée

css::CSSValue

La valeur de base, ou statique, d'un attribut de présentation donné en tant qu'objet CSSValue ou la valeur NULL si l'attribut en question n'a pas de valeur spécifiée.

Aucune exception

L'interface SVGLocatable

L'interface SVGLocatable est pour tous les éléments, soit qui ont un attribut transform, soit qui n'ont pas d'attribut transform mais dont le contenu peut avoir une boîte englobante dans l'espace utilisateur courant.

Définition IDL

interface SVGLocatable { 

  readonly attribute SVGElement              nearestViewportElement;
  readonly attribute SVGElement              farthestViewportElement;

  SVGRect   getBBox (  );
  SVGMatrix getCTM (  );
  SVGMatrix getScreenCTM (  );
  SVGMatrix getTransformToElement ( in SVGElement element )
                  raises( SVGException );
};

Attributs

readonly SVGElement nearestViewportElement

L'élément qui établi la zone de visualisation courante. Souvent l'élément 'svg' ancêtre le plus proche. Nul si l'élément courant est l'éléent 'svg' le plus externe.

readonly SVGElement farthestViewportElement

L'élément 'svg' ancêtre le plus lointain. Nul si l'élément courant est l'élément 'svg' le plus externe.

Méthodes

getBBox

Retourne la boîte englobante resserrée dans l'espace utilisateur courant (i.e., après application, le cas échéant, de l'attribut transform sur la géométrie de tous les éléments graphiques contenus, à l'exclusion de l'épaisseur du tracé et des effets de filtre).

Aucun paramètre

Valeur retournée

SVGRect

Un objet SVGRect qui définit la boître de délimitation.

Aucune exception

getCTM

Retourne la matrice de transformation des unités utilisateur courantes (i.e., après application, le cas échéant, de l'attribut transform) vers le système de coordonnées de la zone de visualisation pour l'objet nearestViewportElement.

Aucun paramètre

Valeur retournée

SVGMatrix

Un objet SVGMatrix qui définit la Matrice de Transformation Courante.

Aucune exception

getScreenCTM

Retourne la matrice de transformation des unités utilisateur courantes (i.e., après application, le cas échéant, de l'attribut transform) vers la notification de l'agent utilisateur parent pour un « pixel ». Pour les dispositifs d'affichage, cela représente idéalement un pixel d'écran physique. Pour les autres appareils ou environnements où les dimensions du pixel physique ne sont pas connues, alors un algorithme semblable à celui de la définition CSS2 pour le « pixel » peut être employé à la place.

Aucun paramètre

Valeur retournée

SVGMatrix

Un objet SVGMatrix qui définit la matrice de transformation en question.

Aucune exception

getTransformToElement

Retourne la matrice de transformation du système de coordonnées utilisateur sur l'élément courant (après application, le cas échéant, de l'attribut transform) vers le système de coordonnées utilisateur sur le paramètre element (après application, le cas échéant, de son attribut transform).

Paramètres

in SVGElement element

L'élément cible.

Valeur retournée

SVGMatrix

Un objet SVGMatrix qui définit la transformation.

Exceptions

SVGException

SVG_MATRIX_NOT_INVERTABLE : déclenchée si les matrices de transformation définies couramment rendent impossible le calcul de la matrice en question (par exemple, parce que l'une des transformations est singulière).

L'interface SVGTransformable

L'interface SVGTransformable contient des propriétés et des méthodes qui s'appliquent à tous les éléments qui ont l'attribut transform.

Définition IDL

interface SVGTransformable : SVGLocatable { 
  readonly attribute SVGAnimatedTransformList transform;
};

Attributs

readonly SVGAnimatedTransformList transform

Correspond à l'attribut transform de l'élément en question.

L'interface SVGTests

L'interface SVGTests définit une interface qui s'applique à tous les éléments qui ont les attributs requiredFeatures, requiredExtensions et systemLanguage.

Définition IDL

interface SVGTests { 

  readonly attribute SVGStringList requiredFeatures;
  readonly attribute SVGStringList requiredExtensions;
  readonly attribute SVGStringList systemLanguage;

  boolean hasExtension ( in DOMString extension );
};

Attributs

readonly SVGStringList requiredFeatures

Correspond à l'attribut requiredFeatures de l'élément en question.

readonly SVGStringList requiredExtensions

Correspond à l'attribut requiredExtensions de l'élément en question.

readonly SVGStringList systemLanguage

Correspond à l'attribut systemLanguage de l'élément en question.

Méthodes

hasExtension

Retourne la valeur true si l'agent utilisateur reconnaît l'extension en question, spécifiée par un URI.

Paramètres

in DOMString extension

Le nom de l'extension, exprimée sous la forme d'un URI.

Valeur retournée

boolean

Les valeurs true ou false, selon que l'extension en question est reconnue ou non.

Aucune exception

L'interface SVGLangSpace

L'interface SVGLangSpace définit une interface qui s'applique à tous les éléments qui ont les attributs xml:lang et xml:space.

Définition IDL

interface SVGLangSpace { 

           attribute DOMString xmllang;
                       // déclenche DOMException à l'initialisation
           attribute DOMString xmlspace;
                       // déclenche DOMException à l'initialisation
};

Attributs

DOMString xmllang

Correspond à l'attribut xml:lang de l'élément en question.

Exceptions à l'initialisation

DOMException

NO_MODIFICATION_ALLOWED_ERR : déclenchée lors d'une tentative de modification de la valeur d'un attribut en lecture seule.

DOMString xmlspace

Correspond à l'attribut xml:space de l'élément en question.

Exceptions à l'initialisation

DOMException

NO_MODIFICATION_ALLOWED_ERR : déclenchée lors d'une tentative de modification de la valeur d'un attribut en lecture seule.

L'interface SVGExternalResourcesRequired

L'interface SVGExternalResourcesRequired définit une interface qui s'applique à tout élément quand cet élément lui-même ou l'un de ses descendants peut appeler une ressource externe.

Définition IDL

interface SVGExternalResourcesRequired { 

  readonly attribute SVGAnimatedBoolean externalResourcesRequired;
};

Attributs

readonly SVGAnimatedBoolean externalResourcesRequired

Correspond à l'attribut externalResourcesRequired de l'élément en question.
« errata 2002-11-15 »

L'interface SVGFitToViewBox

L'interface SVGFitToViewBox définit les attributs DOM qui s'appliquent aux éléments ayant les attributs XML viewBox et preserveAspectRatio.

Définition IDL

interface SVGFitToViewBox { 

  readonly attribute SVGAnimatedRect                viewBox;
  readonly attribute SVGAnimatedPreserveAspectRatio preserveAspectRatio;
};

Attributs

readonly SVGAnimatedRect viewBox

Correspond à l'attribut viewBox de l'élément en question.

readonly SVGAnimatedPreserveAspectRatio preserveAspectRatio

Correspond à l'attribut preserveAspectRatio de l'élément en question.

L'interface SVGZoomAndPan

Définition IDL

interface SVGZoomAndPan { 

  // Les types zoom et panoramique
  const unsigned short SVG_ZOOMANDPAN_UNKNOWN   = 0;
  const unsigned short SVG_ZOOMANDPAN_DISABLE = 1;
  const unsigned short SVG_ZOOMANDPAN_MAGNIFY = 2;

           attribute unsigned short zoomAndPan;
                       // déclenche DOMException à l'initialisation
};

Definition group Zoom and Pan Types

Constantes définies

SVG_ZOOMANDPAN_UNKNOWN		L'énumération a été paramétrée à une valeur qui ne fait pas partie des types prédéfinis. Tenter de définir une nouvelle valeur de ce type ou tenter de changer une valeur existante pour ce type est illégal.
SVG_ZOOMANDPAN_DISABLE		Correspond à la valeur disable.
SVG_ZOOMANDPAN_MAGNIFY		Correspond à la valeur magnify.

Attributs

unsigned short zoomAndPan

Correspond à l'attribut zoomAndPan de l'élément en question. La valeur doit être l'une des constantes de zoom et de panoramique spécifiées ci-dessus.

Exceptions à l'initialisation

DOMException

NO_MODIFICATION_ALLOWED_ERR : déclenchée lors d'une tentative de modification de la valeur d'un attribut en lecture seule.

L'interface SVGViewSpec

L'interface correspond à une spécification de vue SVG.

Définition IDL

interface SVGViewSpec : 
                SVGZoomAndPan,
                SVGFitToViewBox { 

  readonly attribute SVGTransformList transform;
  readonly attribute SVGElement       viewTarget;
  readonly attribute DOMString        viewBoxString;
  readonly attribute DOMString        preserveAspectRatioString;
  readonly attribute DOMString        transformString;
  readonly attribute DOMString        viewTargetString;
};

Attributs

readonly SVGTransformList transform

Correspond au paramétrage de l'attribut transform pour la spécification de vue SVG.

readonly SVGElement viewTarget

Correspond au paramétrage de l'attribut viewTarget pour la spécification de vue SVG.

readonly DOMString viewBoxString

Correspond au paramétrage de l'attribut viewBox pour la spécification de vue SVG.

readonly DOMString preserveAspectRatioString

Correspond au paramétrage de l'attribut preserveAspectRatio pour la spécification de vue SVG.

readonly DOMString transformString

Correspond au paramétrage de l'attribut transform pour la spécification de vue SVG.

readonly DOMString viewTargetString

Correspond au paramétrage de l'attribut viewTarget pour la spécification de vue SVG.

L'interface SVGURIReference

L'interface SVGURIReference définit une interface qui s'applique à tous les éléments qui ont la collection des attributs XLink, comme xlink:href, qui établissent une référence d'URI.

Définition IDL

interface SVGURIReference { 

  readonly attribute SVGAnimatedString href;
};

Attributs

readonly SVGAnimatedString href

Correspond à l'attribut xlink:href de l'élément en question.

L'interface SVGCSSRule

SVG augmente le champs d'action de l'interface CSSRule avec l'interface SVGCSSRule en lui ajoutant une règle SVGColorProfileRule qui autorise la spécification de couleurs basées sur ICC.

Il est vraisemblable que cette extension fera partie de versions ultérieures de CSS et de DOM.

Définition IDL

interface SVGCSSRule : css::CSSRule { 
  // Un type de règle CSS supplémentaire pour la gestion des spécifications de couleur ICC.
  const unsigned short COLOR_PROFILE_RULE = 7;
};

Groupe de définition d'un type de règle CSS supplémentaire pour la gestion des spécifications de couleur ICC

Constantes définies

COLOR_PROFILE_RULE

La règle est un profil de couleur @color-profile.

L'interface SVGRenderingIntent

L'interface SVGRenderingIntent définit la liste énumérée des valeurs possibles pour des attributs 'rendering-intent' ou des descripteurs.

Définition IDL

interface SVGRenderingIntent { 

  // Les types d'intention de rendu
  const unsigned short RENDERING_INTENT_UNKNOWN               = 0;
  const unsigned short RENDERING_INTENT_AUTO                  = 1;
  const unsigned short RENDERING_INTENT_PERCEPTUAL            = 2;
  const unsigned short RENDERING_INTENT_RELATIVE_COLORIMETRIC = 3;
  const unsigned short RENDERING_INTENT_SATURATION            = 4;
  const unsigned short RENDERING_INTENT_ABSOLUTE_COLORIMETRIC = 5;
};

Groupe de définition des types d'intention de rendu

Constantes définies

RENDERING_INTENT_UNKNOWN		Le type ne fait pas partie de ceux prédéfinis. Tenter de définir une nouvelle valeur de ce type ou tenter de changer une valeur existante pour ce type est illégal.
RENDERING_INTENT_AUTO		Correspond à une valeur de auto.
RENDERING_INTENT_PERCEPTUAL		Correspond à une valeur de perceptual.
RENDERING_INTENT_RELATIVE_COLORIMETRIC		Correspond à une valeur de relative-colorimetric.
RENDERING_INTENT_SATURATION		Correspond à une valeur de saturation.
RENDERING_INTENT_ABSOLUTE_COLORIMETRIC		Correspond à une valeur de absolute-colorimetric.