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'a