4 septembre 2001

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


Contenu


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 :


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 color-patchalicebluergb(240, 248, 255)
antiquewhite color-patchantiquewhitergb(250, 235, 215)
aqua color-patchaquargb( 0, 255, 255)
aquamarine color-patchaquamarinergb(127, 255, 212)
azure color-patchazurergb(240, 255, 255)
beige color-patchbeigergb(245, 245, 220)
bisque color-patchbisquergb(255, 228, 196)
black color-patchblackrgb( 0, 0, 0)
blanchedalmond color-patchblanchedalmondrgb(255, 235, 205)
blue color-patchbluergb( 0, 0, 255)
blueviolet color-patchbluevioletrgb(138, 43, 226)
brown color-patchbrownrgb(165, 42, 42)
burlywood color-patchburlywoodrgb(222, 184, 135)
cadetblue color-patchcadetbluergb( 95, 158, 160)
chartreuse color-patchchartreusergb(127, 255, 0)
chocolate color-patchchocolatergb(210, 105, 30)
coral color-patchcoralrgb(255, 127, 80)
cornflowerblue color-patchcornflowerbluergb(100, 149, 237)
cornsilk color-patchcornsilkrgb(255, 248, 220)
crimson color-patchcrimsonrgb(220, 20, 60)
cyan color-patchcyanrgb( 0, 255, 255)
darkblue color-patchdarkbluergb( 0, 0, 139)
darkcyan color-patchdarkcyanrgb( 0, 139, 139)
darkgoldenrod color-patchdarkgoldenrodrgb(184, 134, 11)
darkgray color-patchdarkgrayrgb(169, 169, 169)
darkgreen color-patchdarkgreenrgb( 0, 100, 0)
darkgrey color-patchdarkgreyrgb(169, 169, 169)
darkkhaki color-patchdarkkhakirgb(189, 183, 107)
darkmagenta color-patchdarkmagentargb(139, 0, 139)
darkolivegreen color-patchdarkolivegreenrgb( 85, 107, 47)
darkorange color-patchdarkorangergb(255, 140, 0)
darkorchid color-patchdarkorchidrgb(153, 50, 204)
darkred color-patchdarkredrgb(139, 0, 0)
darksalmon color-patchdarksalmonrgb(233, 150, 122)
darkseagreen color-patchdarkseagreenrgb(143, 188, 143)
darkslateblue color-patchdarkslatebluergb( 72, 61, 139)
darkslategray color-patchdarkslategrayrgb( 47, 79, 79)
darkslategrey color-patchdarkslategreyrgb( 47, 79, 79)
darkturquoise color-patchdarkturquoisergb( 0, 206, 209)
darkviolet color-patchdarkvioletrgb(148, 0, 211)
deeppink color-patchdeeppinkrgb(255, 20, 147)
deepskyblue color-patchdeepskybluergb( 0, 191, 255)
dimgray color-patchdimgrayrgb(105, 105, 105)
dimgrey color-patchdimgreyrgb(105, 105, 105)
dodgerblue color-patchdodgerbluergb( 30, 144, 255)
firebrick color-patchfirebrickrgb(178, 34, 34)
floralwhite color-patchfloralwhitergb(255, 250, 240)
forestgreen color-patchforestgreenrgb( 34, 139, 34)
fuchsia color-patchfuchsiargb(255, 0, 255)
gainsboro color-patchgainsbororgb(220, 220, 220)
ghostwhite color-patchghostwhitergb(248, 248, 255)
gold color-patchgoldrgb(255, 215, 0)
goldenrod color-patchgoldenrodrgb(218, 165, 32)
gray color-patchgrayrgb(128, 128, 128)
grey color-patchgreyrgb(128, 128, 128)
green color-patchgreenrgb( 0, 128, 0)
greenyellow color-patchgreenyellowrgb(173, 255, 47)
honeydew color-patchhoneydewrgb(240, 255, 240)
hotpink color-patchhotpinkrgb(255, 105, 180)
indianred color-patchindianredrgb(205, 92, 92)
indigo color-patchindigorgb( 75, 0, 130)
ivory color-patchivoryrgb(255, 255, 240)
khaki color-patchkhakirgb(240, 230, 140)
lavender color-patchlavenderrgb(230, 230, 250)
lavenderblush color-patchlavenderblushrgb(255, 240, 245)
lawngreen color-patchlawngreenrgb(124, 252, 0)
lemonchiffon color-patchlemonchiffonrgb(255, 250, 205)
lightblue color-patchlightbluergb(173, 216, 230)
lightcoral color-patchlightcoralrgb(240, 128, 128)
lightcyan color-patchlightcyanrgb(224, 255, 255)
lightgoldenrodyellow color-patchlightgoldenrodyellowrgb(250, 250, 210)
lightgray color-patchlightgrayrgb(211, 211, 211)
lightgreen color-patchlightgreenrgb(144, 238, 144)
lightgrey color-patchlightgreyrgb(211, 211, 211)
    
lightpink color-patchlightpinkrgb(255, 182, 193)
lightsalmon color-patchlightsalmonrgb(255, 160, 122)
lightseagreen color-patchlightseagreenrgb( 32, 178, 170)
lightskyblue color-patchlightskybluergb(135, 206, 250)
lightslategray color-patchlightslategrayrgb(119, 136, 153)
lightslategrey color-patchlightslategreyrgb(119, 136, 153)
lightsteelblue color-patchlightsteelbluergb(176, 196, 222)
lightyellow color-patchlightyellowrgb(255, 255, 224)
lime color-patchlimergb( 0, 255, 0)
limegreen color-patchlimegreenrgb( 50, 205, 50)
linen color-patchlinenrgb(250, 240, 230)
magenta color-patchmagentargb(255, 0, 255)
maroon color-patchmaroonrgb(128, 0, 0)
mediumaquamarine color-patchmediumaquamarinergb(102, 205, 170)
mediumblue color-patchmediumbluergb( 0, 0, 205)
mediumorchid color-patchmediumorchidrgb(186, 85, 211)
mediumpurple color-patchmediumpurplergb(147, 112, 219)
mediumseagreen color-patchmediumseagreenrgb( 60, 179, 113)
mediumslateblue color-patchmediumslatebluergb(123, 104, 238)
mediumspringgreen color-patchmediumspringgreenrgb( 0, 250, 154)
mediumturquoise color-patchmediumturquoisergb( 72, 209, 204)
mediumvioletred color-patchmediumvioletredrgb(199, 21, 133)
midnightblue color-patchmidnightbluergb( 25, 25, 112)
mintcream color-patchmintcreamrgb(245, 255, 250)
mistyrose color-patchmistyrosergb(255, 228, 225)
moccasin color-patchmoccasinrgb(255, 228, 181)
navajowhite color-patchnavajowhitergb(255, 222, 173)
navy color-patchnavyrgb( 0, 0, 128)
oldlace color-patcholdlacergb(253, 245, 230)
olive color-patcholivergb(128, 128, 0)
olivedrab color-patcholivedrabrgb(107, 142, 35)
orange color-patchorangergb(255, 165, 0)
orangered color-patchorangeredrgb(255, 69, 0)
orchid color-patchorchidrgb(218, 112, 214)
palegoldenrod color-patchpalegoldenrodrgb(238, 232, 170)
palegreen color-patchpalegreenrgb(152, 251, 152)
paleturquoise color-patchpaleturquoisergb(175, 238, 238)
palevioletred color-patchpalevioletredrgb(219, 112, 147)
papayawhip color-patchpapayawhiprgb(255, 239, 213)
peachpuff color-patchpeachpuffrgb(255, 218, 185)
peru color-patchperurgb(205, 133, 63)
pink color-patchpinkrgb(255, 192, 203)
plum color-patchplumrgb(221, 160, 221)
powderblue color-patchpowderbluergb(176, 224, 230)
purple color-patchpurplergb(128, 0, 128)
red color-patchredrgb(255, 0, 0)
rosybrown color-patchrosybrownrgb(188, 143, 143)
royalblue color-patchroyalbluergb( 65, 105, 225)
saddlebrown color-patchsaddlebrownrgb(139, 69, 19)
salmon color-patchsalmonrgb(250, 128, 114)
sandybrown color-patchsandybrownrgb(244, 164, 96)
seagreen color-patchseagreenrgb( 46, 139, 87)
seashell color-patchseashellrgb(255, 245, 238)
sienna color-patchsiennargb(160, 82, 45)
silver color-patchsilverrgb(192, 192, 192)
skyblue color-patchskybluergb(135, 206, 235)
slateblue color-patchslatebluergb(106, 90, 205)
slategray color-patchslategrayrgb(112, 128, 144)
slategrey color-patchslategreyrgb(112, 128, 144)
snow color-patchsnowrgb(255, 250, 250)
springgreen color-patchspringgreenrgb( 0, 255, 127)
steelblue color-patchsteelbluergb( 70, 130, 180)
tan color-patchtanrgb(210, 180, 140)
teal color-patchtealrgb( 0, 128, 128)
thistle color-patchthistlergb(216, 191, 216)
tomato color-patchtomatorgb(255, 99, 71)
turquoise color-patchturquoisergb( 64, 224, 208)
violet color-patchvioletrgb(238, 130, 238)
wheat color-patchwheatrgb(245, 222, 179)
white color-patchwhitergb(255, 255, 255)
whitesmoke color-patchwhitesmokergb(245, 245, 245)
yellow color-patchyellowrgb(255, 255, 0)
yellowgreen color-patchyellowgreenrgb(154, 205, 50)
blank entry  

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

Utilisée pour les attributs de type booléen qui peuvent être animés.

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

Utilisée pour les attributs de type DOMString qui peuvent être animés.

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

Utilisée pour les attributs dont la valeur doit être une constante d'une énumération donnée et qui peuvent être animés.

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

Utilisée pour les attributs du type de base <entier> qui peuvent être animés.

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

Utilisée pour les attributs du type de base <nombre>.

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

Utilisée pour les attributs du type de base <nombre> qui peuvent être animés.

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

Utilisée pour les attributs qui prennent une liste de nombres et qui peuvent être animés.

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

Utilisée pour les attributs de type de base <longueur> qui peuvent être animés.

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

Utilisée pour les attributs de type SVGLengthList qui peuvent être animés.

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

Correspond à toutes les propriétés et attributs dont les valeurs peuvent être du type de base <angle> et qui peuvent être animés.

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

Utilisée pour les attributs de type SVGRect qui peuvent être animés.

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

L'interface SVGZoomAndPan définit l'attribut 'zoomAndPan' et ses constantes associées.

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.