SVGSVGElement

SVGSVGElement class

Une définition d’interface clé est l’interface SVGSVGElement, qui est l’interface qui correspond à l’élément ‘svg’. Cette interface contient diverses méthodes utilitaires couramment utilisées, telles que les opérations matricielles et la possibilité de contrôler le temps de rafraîchissement sur les appareils de rendu visuel.

public class SVGSVGElement : SVGGraphicsElement, IDocumentEvent, ISVGFitToViewBox, ISVGZoomAndPan

Propriétés

NomLa description
override Attributes { get; }Un NamedNodeMap contenant les attributs de ce nœud (si c’est un Element) ou null sinon.
virtual BaseURI { get; }L’URI de base absolu de ce nœud ou null si l’implémentation n’a pas pu obtenir d’URI absolu.
ChildElementCount { get; }Renvoie le nombre actuel de nœuds d’élément qui sont des enfants de cet élément. 0 si cet élément n’a pas de nœuds enfants qui sont de nodeType 1.
ChildNodes { get; }Une NodeList qui contient tous les enfants de ce nœud. S’il n’y a pas d’enfants, il s’agit d’une NodeList ne contenant aucun nœud..
Children { get; }Renvoie les éléments enfants de l’élément actuel.
ClassList { get; }Renvoie une DOMTokenList en direct qui contient les jetons reçus de l’analyse de l’attribut “class”.
ClassName { get; }Correspond à l’attribut ‘class’ sur l’élément donné.
ClassName { get; set; }L’attribut de classe de l’élément. Cet attribut a été renommé due en raison de conflits avec le mot clé “class” exposé par de nombreuses langues. Voir la définition d’attribut de classe dans HTML 4.01.
CurrentScale { get; set; }Sur un élément svg le plus à l’extérieur, cet attribut indique le facteur d’échelle actuel par rapport à la vue initiale pour prendre en compte les opérations d’agrandissement et de panoramique de l’utilisateur, comme décrit dans Agrandissement et panoramique. Les attributs DOM currentScale et currentTranslate sont équivalents à la matrice 2x3 [abcdef] = [currentScale 0 0 currentScale currentTranslate.x currentTranslate.y]. Si le “grossissement” est activé (c’est-à-dire zoomAndPan=“magnify”), l’effet est comme si une transformation supplémentaire était placée au niveau le plus externe sur le fragment de document SVG (c’est-à-dire à l’extérieur de l’élément svg le plus externe). un élément ‘svg’ qui n’est pas un élément svg le plus externe, le comportement de cet attribut n’est pas défini.
CurrentTranslate { get; }Sur un élément svg le plus à l’extérieur, le facteur de traduction correspondant qui prend en compte le “grossissement” de l’utilisateur. Lorsqu’il est accédé sur un élément ‘svg’ qui n’est pas un élément svg le plus à l’extérieur, le comportement de cet attribut n’est pas défini.
FarthestViewportElement { get; }L’élément ‘svg’ ancêtre le plus éloigné. Null si l’élément actuel est l’élément svg le plus externe.
FirstChild { get; }Le premier enfant de ce nœud. S’il n’y a pas de tel nœud, cela renvoie null.
FirstElementChild { get; }Renvoie le premier nœud d’élément enfant de cet élément. null si cet élément n’a pas d’éléments enfants.
Height { get; }Correspond à l’attribut ‘height’ sur l’élément ‘svg’ donné.
Id { get; set; }La valeur de l’attribut ‘id’ sur l’élément donné, ou la chaîne vide si ‘id’ n’est pas présent.
InnerHTML { get; set; }Renvoie un fragment de HTML ou XML qui représente le contenu de l’élément. Peut être défini pour remplacer le contenu de l’élément par des nœuds analysés à partir de la chaîne donnée.
LastChild { get; }Le dernier enfant de ce nœud. S’il n’y a pas de tel nœud, cela renvoie null.
LastElementChild { get; }Renvoie le dernier nœud d’élément enfant de cet élément. null si cet élément n’a pas d’éléments enfants.
override LocalName { get; }Renvoie la partie locale du nom qualifié de ce nœud. Pour les nœuds de tout type autre que ELEMENT_NODE et ATTRIBUTE_NODE et les nœuds créés avec une méthode DOM Niveau 1, comme Document.createElement(), c’est toujours null.
override NamespaceURI { get; }L’URI de l’espace de noms de ce nœud, ou null s’il n’est pas spécifié.
NearestViewportElement { get; }L’élément qui a établi la fenêtre courante. Souvent, l’élément ‘svg’ ancêtre le plus proche. Null si l’élément actuel est l’élément svg le plus externe.
NextElementSibling { get; }Renvoie le prochain nœud d’élément frère de cet élément. null si cet élément n’a aucun nœud frère d’élément qui vient après celui-ci dans l’arborescence du document.
NextSibling { get; }Le nœud suivant immédiatement ce nœud. S’il n’y a pas de tel nœud, cela renvoie null.
override NodeName { get; }Le nom de ce nœud, en fonction de son type.
override NodeType { get; }Un code représentant le type de l’objet sous-jacent.
virtual NodeValue { get; set; }La valeur de ce nœud, en fonction de son type.
OuterHTML { get; set; }Renvoie un fragment de HTML ou XML qui représente l’élément et son contenu. Peut être défini pour remplacer l’élément par des nœuds analysés à partir de la chaîne donnée.
virtual OwnerDocument { get; }L’objet Document associé à ce nœud. Il s’agit également de l’objet Document utilisé pour créer de nouveaux nœuds. Lorsque ce nœud est un Document ou un DocumentType qui n’est pas encore utilisé avec un Document, c’est null.
OwnerSVGElement { get; }L’élément ‘svg’ ancêtre le plus proche. Null si l’élément donné est l’élément svg le plus externe.
ParentElement { get; }Obtient le parentElement de ce nœud.
ParentNode { get; }Le parent de ce nœud. Tous les nœuds, à l’exception de Attr, Document, DocumentFragment, Entity et Notation peuvent avoir un parent. Cependant, si un nœud vient d’être créé et n’a pas encore été ajouté à l’arbre, ou s’il a été supprimé de l’arbre, c’est null.
override Prefix { get; }Le préfixe d’espace de noms de ce nœud, ou null s’il n’est pas spécifié. Lorsqu’il est défini comme étant nul, sa définition n’a aucun effet
PreserveAspectRatio { get; }Correspond à l’attribut ‘preserveAspectRatio’ sur l’élément donné.
PreviousElementSibling { get; }Renvoie le nœud d’élément frère précédent de cet élément. null si cet élément n’a aucun nœud frère d’élément qui précède celui-ci dans l’arborescence du document.
PreviousSibling { get; }Le nœud précédant immédiatement ce nœud. S’il n’y a pas de tel nœud, cela renvoie null.
RequiredExtensions { get; }Correspond à l’attribut ‘requiredExtensions’ sur l’élément donné.
RequiredFeatures { get; }Correspond à l’attribut ‘requiredFeatures’ sur l’élément donné.
SchemaTypeInfo { get; }Les informations de type associées à cet élément.
ShadowRoot { get; }Renvoie shadowRoot stocké sur cet élément ou null s’il est fermé.
Style { get; }Correspond à l’attribut ‘style’ sur l’élément donné. Si l’agent utilisateur ne prend pas en charge le style avec CSS, cet attribut doit toujours avoir la valeur null.
SystemLanguage { get; }Correspond à l’attribut ‘systemLanguage’ sur l’élément donné.
TagName { get; }Le nom de l’élément.
override TextContent { get; set; }Cet attribut renvoie le contenu textuel de ce nœud et de ses descendants. Lorsqu’il est défini comme étant nul, sa définition n’a aucun effet. Lors de la définition, tous les enfants possibles que ce nœud peut avoir sont supprimés et, si la nouvelle chaîne n’est pas vide ou nulle, remplacés par un seul nœud de texte contenant la chaîne à laquelle cet attribut est défini.
Transform { get; }Correspond à l’attribut ’transform’ sur l’élément donné.
ViewBox { get; }Correspond à l’attribut ‘viewBox’ sur l’élément donné.
ViewportElement { get; }L’élément qui a établi la fenêtre courante. Souvent, l’élément ‘svg’ ancêtre le plus proche. Null si l’élément donné est l’élément svg le plus externe.
Width { get; }Correspond à l’attribut ‘width’ sur l’élément ‘svg’ donné.
X { get; }Correspond à l’attribut ‘x’ sur l’élément ‘svg’ donné.
Y { get; }Correspond à l’attribut ‘y’ sur l’élément ‘svg’ donné.
ZoomAndPan { get; set; }Correspond à l’attribut ‘zoomAndPan’ sur l’élément donné. La valeur doit être l’une des constantes SVG_ZOOMANDPAN_* définies sur cette interface.

Méthodes

NomLa description
AddEventListener(string, IEventListener)Cette méthode permet l’enregistrement des écouteurs d’événement sur la cible de l’événement.
AddEventListener(string, DOMEventHandler, bool)Cette méthode permet l’enregistrement des écouteurs d’événement sur la cible de l’événement.
AddEventListener(string, IEventListener, bool)Cette méthode permet l’enregistrement des écouteurs d’événement sur la cible de l’événement.
AnimationsPaused()Renvoie true si ce fragment de document SVG est en pause.
AppendChild(Node)Ajoute le nœud newChild à la fin de la liste des enfants de ce nœud. Si le newChild est déjà dans l’arborescence, il est d’abord supprimé.
AttachShadow(ShadowRootMode)Crée une racine fantôme et l’attache à l’élément actuel.
CloneNode()Renvoie un doublon de ce nœud, c’est-à-dire qu’il sert de constructeur de copie générique pour les nœuds. Le nœud dupliqué n’a pas de parent (parentNode est nul) et pas de données utilisateur.
CloneNode(bool)Renvoie un doublon de ce nœud, c’est-à-dire qu’il sert de constructeur de copie générique pour les nœuds. Le nœud dupliqué n’a pas de parent (parentNode est nul) et pas de données utilisateur.
CreateEvent(string)Crée unEvent d’un type pris en charge par l’implémentation.
CreateSVGAngle()Crée un objet SVGAngle en dehors de toute arborescence de documents. L’objet est initialisé à la valeur 0 degrés (sans unité).
CreateSVGLength()Crée un objet SVGLength en dehors de toute arborescence de documents. L’objet est initialisé à la valeur de 0 unités utilisateur.
CreateSVGMatrix()Crée un objet SVGMatrix en dehors de toute arborescence de documents. L’objet est initialisé à la matrice d’identité.
CreateSVGNumber()Crée un objet SVGNumber en dehors de toute arborescence de documents. L’objet est initialisé à une valeur de zéro.
CreateSVGPoint()Crée un objet SVGPoint en dehors de toute arborescence de documents. L’objet est initialisé au point (0,0) dans le système de coordonnées utilisateur.
CreateSVGRect()Crée un objet SVGRect en dehors de toute arborescence de documents. L’objet est initialisé de sorte que toutes les valeurs soient définies sur 0 unités utilisateur.
CreateSVGTransform()Crée un objet SVGTransform en dehors de toute arborescence de documents. L’objet est initialisé à une transformation de matrice d’identité (SVG_TRANSFORM_MATRIX).
CreateSVGTransformFromMatrix(SVGMatrix)Crée un objet SVGTransform en dehors de toute arborescence de documents. L’objet est initialisé à la transformation matricielle donnée (c’est-à-dire, SVG_TRANSFORM_MATRIX). Les valeurs du paramètre matrix sont copiées, le paramètre matrix n’est pas adopté comme SVGTransform::matrix.
DispatchEvent(Event)Cette méthode permet de répartir les événements dans le modèle d’événement des implémentations.
Dispose()Effectue des tâches définies par l’application associées à la libération, à la libération ou à la réinitialisation des ressources non gérées.
GetAttribute(string)Récupère une valeur d’attribut par nom.
GetAttributeNode(string)Récupère un nœud d’attribut par nom.
GetAttributeNodeNS(string, string)Récupère un nœud Attr par nom local et URI d’espace de noms.
GetAttributeNS(string, string)Récupère une valeur d’attribut par nom local et URI d’espace de noms.
GetBBox()Renvoie la boîte englobante étroite dans l’espace utilisateur actuel (c’est-à-dire après l’application de l’attribut ’transform’, le cas échéant) sur la géométrie de tous les éléments graphiques contenus, à l’exclusion des effets de contour, de découpage, de masquage et de filtre). Notez que getBBox doit renvoyer la boîte englobante réelle au moment où la méthode a été appelée, même si l’élément n’a pas encore été rendu.
GetCTM()Renvoie la matrice de transformation des unités utilisateur actuelles (c’est-à-dire après l’application de l’attribut ’transform’, le cas échéant) au système de coordonnées de la fenêtre pour le ViewportElement le plus proche.
GetCurrentTime()Renvoie l’heure actuelle en secondes par rapport à l’heure de début du fragment de document SVG actuel. Si getCurrentTime est appelé avant le début de la chronologie du document (par exemple, par un script exécuté dans un élément ‘script’ avant que l’événement SVGLoad du document ne soit envoyé), alors 0 est renvoyé.
GetElementById(string)Recherche dans ce fragment de document SVG (c’est-à-dire que la recherche est limitée à un sous-ensemble de l’arborescence du document) un élément dont l’identifiant est donné par elementId. Si un élément est trouvé, cet élément est renvoyé. Si aucun élément de ce type n’existe, renvoie null. Le comportement n’est pas défini si plus d’un élément a cet identifiant.
GetElementsByClassName(string)Renvoie un objet NodeList actif contenant tous les éléments du document qui ont toutes les classes spécifiées dans l’argument. http://www.w3.org/TR/dom/
GetElementsByTagName(string)Renvoie une NodeList de tous les éléments descendants avec un nom de balise donné, dans l’ordre du document.
GetElementsByTagNameNS(string, string)Renvoie une NodeList de tous les éléments descendants avec un nom local et un URI d’espace de noms donnés dans l’ordre du document.
virtual GetPlatformType()Cette méthode est utilisée pour récupérer l’objet ECMAScriptType .
GetScreenCTM()Renvoie la matrice de transformation à partir des unités utilisateur actuelles (c’est-à-dire après application de l’attribut ’transform’, s’il y en a) à l’avis de l’agent utilisateur parent d’un “pixel”. Pour les appareils d’affichage, cela représente idéalement un pixel d’écran physique. Pour les autres appareils ou environnements où les tailles de pixels physiques ne sont pas connues, un algorithme similaire à la définition CSS2 d’un “pixel” peut être utilisé à la place. Notez que null est renvoyé si cet élément n’est pas accroché à l’arborescence du document. Cette méthode aurait été plus justement nommée getClientCTM, mais le nom getScreenCTM est conservé pour des raisons historiques.
HasAttribute(string)Renvoie vrai lorsqu’un attribut avec un nom donné est spécifié sur cet élément ou a une valeur par défaut, faux sinon.
HasAttributeNS(string, string)Renvoie vrai lorsqu’un attribut avec un nom local et un URI d’espace de noms donnés est spécifié sur cet élément ou a une valeur par défaut, faux sinon.
override HasAttributes()Renvoie si ce nœud (s’il s’agit d’un élément) a des attributs
HasChildNodes()Renvoie si ce nœud a des enfants.
InsertBefore(Node, Node)Insère le nœud avant le nœud enfant existant. Si enfant est nul, insère le nœud à la fin de la liste des enfants. Si enfant est un objet DocumentFragment, tous ses enfants sont insérés, dans le même ordre, avant enfant. Si l’enfant est déjà dans l’arborescence, il est d’abord supprimé.
IsDefaultNamespace(string)Cette méthode vérifie si le namespaceURI spécifié est l’espace de noms par défaut ou non.
IsEqualNode(Node)Teste si deux nœuds sont égaux. Cette méthode teste l’égalité des nœuds, pas la similitude (c’est-à-dire si les deux nœuds sont des références au même objet) qui peut être testée avec Node.isSameNode(). Tous les nœuds identiques seront également égaux, bien que l’inverse puisse ne pas être vrai.
IsSameNode(Node)Renvoie si ce nœud est le même nœud que celui donné. Cette méthode permet de déterminer si deux références de nœud renvoyées par l’implémentation font référence au même objet. Lorsque deux références de nœud sont des références au même objet, même via un proxy, les références peuvent être utilisées de manière complètement interchangeable, de sorte que tous les attributs ont les mêmes valeurs et que l’appel de la même méthode DOM sur l’une ou l’autre des références a toujours exactement le même effet.
LookupNamespaceURI(string)Recherchez l’URI de l’espace de noms associé au préfixe donné, à partir de ce nœud.
LookupPrefix(string)Recherchez le préfixe associé à l’URI de l’espace de noms donné, à partir de ce nœud. Les déclarations d’espace de noms par défaut sont ignorées par cette méthode. Voir Recherche de préfixe d’espace de noms pour plus de détails sur l’algorithme utilisé par cette méthode.
Normalize()Met tous les nœuds de texte dans toute la profondeur de la sous-arborescence sous ce nœud, y compris les nœuds d’attribut, dans une forme “normale” où seule la structure (par exemple, les éléments, les commentaires, les instructions de traitement, les sections CDATA et les références d’entité) sépare le texte nœuds, c’est-à-dire qu’il n’y a ni nœuds Text adjacents ni nœuds Text vides. Cela peut être utilisé pour s’assurer que la vue DOM d’un document est la même que s’il avait été enregistré et rechargé, et est utile lorsque des opérations (telles que les recherches XPointer [XPointer]) qui dépendent d’une arborescence de document particulière doivent être utilisé. Si le paramètre “normalize-characters” de l’objet DOMConfiguration attaché au Node.ownerDocument est vrai, cette méthode normalisera également complètement les caractères des nœuds Text.
PauseAnimations()Suspend (c’est-à-dire met en pause) toutes les animations en cours d’exécution qui sont définies dans le fragment de document SVG correspondant à cet élément ‘svg’, provoquant l’arrêt de l’horloge d’animation correspondant à ce fragment de document jusqu’à ce qu’il soit rétabli.
QuerySelector(string)Renvoie le premier élément du document, qui correspond à selector
QuerySelectorAll(string)Renvoie une NodeList de tous les éléments du document, qui correspondent à selector
Remove()Supprime cette instance.
RemoveAttribute(string)Supprime un attribut par nom.
RemoveAttributeNode(Attr)Supprime le nœud d’attribut spécifié.
RemoveAttributeNS(string, string)Supprime un attribut par nom local et URI d’espace de noms.
RemoveChild(Node)Supprime le nœud enfant indiqué par oldChild de la liste des enfants et le renvoie.
RemoveEventListener(string, IEventListener)Cette méthode permet de supprimer les écouteurs d’événement de la cible de l’événement. Si unIEventListener est retiré d’unEventTarget pendant qu’il traite un événement, il ne sera pas déclenché par les actions en cours. Les écouteurs d’événement ne peuvent jamais être invoqués après avoir été supprimés.
RemoveEventListener(string, DOMEventHandler, bool)Cette méthode permet de supprimer les écouteurs d’événement de la cible de l’événement. Si unIEventListener est retiré d’unEventTarget pendant qu’il traite un événement, il ne sera pas déclenché par les actions en cours. Les écouteurs d’événement ne peuvent jamais être invoqués après avoir été supprimés.
RemoveEventListener(string, IEventListener, bool)Cette méthode permet de supprimer les écouteurs d’événement de la cible de l’événement. Si unIEventListener est retiré d’unEventTarget pendant qu’il traite un événement, il ne sera pas déclenché par les actions en cours. Les écouteurs d’événement ne peuvent jamais être invoqués après avoir été supprimés.
ReplaceChild(Node, Node)Remplace le nœud enfant oldChild par newChild dans la liste des enfants et renvoie le nœud oldChild. Si newChild est un objet DocumentFragment, oldChild est remplacé par tous les enfants DocumentFragment, qui sont insérés dans le même ordre. Si le newChild est déjà dans l’arborescence, il est d’abord supprimé.
SetAttribute(string, string)Ajoute un nouvel attribut. Si un attribut portant ce nom est déjà présent dans l’élément, sa valeur est modifiée pour être celle de la valeur parameter
SetAttributeNode(Attr)Ajoute un nouveau nœud d’attribut. Si un attribut portant ce nom (nodeName) est déjà présent dans l’élément, il est remplacé par le nouveau.
SetAttributeNodeNS(Attr)Ajoute un nouvel attribut. Si un attribut avec ce nom local et cet URI d’espace de noms est déjà présent dans l’élément, il est remplacé par le nouveau.
SetAttributeNS(string, string, string)Ajoute un nouvel attribut. Si un attribut avec le même nom local et le même URI d’espace de noms est déjà présent sur l’élément, son préfixe est modifié pour être la partie préfixe du qualifiéName, et sa valeur est modifiée pour être le paramètre de valeur.
SetCurrentTime(float)Ajuste l’horloge pour ce fragment de document SVG, établissant une nouvelle heure actuelle. Si setCurrentTime est appelée avant le début de la chronologie du document (par exemple, par un script exécuté dans un élément ‘script’ avant que l’événement SVGLoad du document ne soit envoyé), alors la valeur de secondes dans la dernière invocation de la méthode donne l’heure à laquelle le document cherchera à une fois que la chronologie du document a commencé.
SetIdAttribute(string, bool)Si le paramètre isId est vrai, cette méthode déclare l’attribut spécifié comme étant un attribut d’ID déterminé par l’utilisateur.
SetIdAttributeNode(Attr, bool)Si le paramètre isId est vrai, cette méthode déclare l’attribut spécifié comme étant un attribut d’ID déterminé par l’utilisateur.
SetIdAttributeNS(string, string, bool)Si le paramètre isId est vrai, cette méthode déclare l’attribut spécifié comme étant un attribut d’ID déterminé par l’utilisateur.
override ToString()Renvoie unString qui représente cette instance.
UnpauseAnimations()Annule la suspension (c’est-à-dire, rétablit la pause) des animations en cours d’exécution qui sont définies dans le fragment de document SVG, entraînant la poursuite de l’horloge de l’animation à partir du moment où elle a été suspendue.

Voir également