SVG SET ATTRIBUTE

La commande SVG SET ATTRIBUTE permet de modifier la valeur d’un attribut existant dans l’arbre de rendu SVG d’une image affichée ou dans l'arbre DOM interne d'une image.

Si vous passez le premier paramètre optionnel *, vous indiquez que le paramètre objetImage est un nom d’objet (une chaîne). Dans ce cas, la commande s’applique aux paramètres de l’image de rendu attachée à l’objet (à noter que les paramètres et donc l’image de rendu de l’objet ne sont créés que si la commande SVG SET ATTRIBUTE est appelée au moins une fois).
Si vous ne passez pas le premier paramètre *, vous indiquez que le paramètre objetImage est une variable ou un champ. Vous ne passez alors pas une chaîne mais une référence de variable (variable objet uniquement) ou de champ. Dans ce cas, la commande s’applique aux images de rendu de tous les objets qui utilisent la variable ou le champ.

Par défaut, les modifications effectuées par cette commande s’appliquent uniquement aux images de rendu, elle ne sont pas stockées dans la source de données (l'arbre DOM interne) et sont perdues lorsque l’image est effacée par programmation ou lorsque le formulaire est fermé. Il est toutefois possible de reporter ces modifications dans l'arbre DOM interne de l'image lorsque le paramètre objetImage référence une variable : il suffit pour cela de passer un second * en dernier paramètre. Ce principe permet de préserver des modifications effectuées à la volée. 

Notes :

• Le report des modifications dans l'arbre DOM interne n'est pas possible lorsque le paramètre objetImage référence un objet.
• Pour que le report des modifications soit possible, la variable SVG doit avoir été créée à partir d'un document DOM (avec DOM EXPORT TO VAR). Si la variable SVG a été créée à partir d'un fichier et si vous passez le second paramètre *, la commande ne fera rien et une erreur sera générée car dans ce cas la source de données ne contient pas de document DOM modifiable.
• Pour modifier la source de données d'une image SVG, vous pouvez également utiliser les commandes XML DOM ou le composant MissingRef fourni par 4D.

Le paramètre id_Element permet de définir l'ID (attribut "id" ou "xml:id") de l’élément dont vous souhaitez modifier un ou plusieurs attribut(s).

Passez dans les paramètres nomAttribut et valeurAttribut respectivement l'attribut à écrire et sa valeur (sous forme de variables, champs ou valeurs littérales). Vous pouvez passer autant de couples attribut/valeur que vous voulez. 

La commande SVG SET ATTRIBUTE vous permet de modifier (mais pas d’ajouter ou de supprimer) la plupart des attributs SVG, comme par exemple 'fill', 'opacity', 'font-family', etc. Pour une définition complète des attributs SVG, reportez-vous aux documents de référence disponibles sur Internet, par exemple http://www.w3.org/TR/SVG11/attindex.html. La mise à jour de l’image de rendu est immédiate, les modifications sont reportées en cascade sur les éléments enfants pour les styles héritables. 

A noter que pour des raisons techniques, les attributs de certains éléments ainsi que certains attributs ne sont pas modifiables. Le tableau suivant liste les éléments modifiables, les éléments non modifiables ainsi que les attributs non modifiables :

Eléments dont les attributs sont modifiables 

Eléments dont les attributs ne sont pas modifiables 

Attributs non modifiables

(1) Ces attributs ne peuvent être modifiés car ils définissent et structurent l’image résultante. Les attributs width et height de l’élément svg servent à définir les dimensions initiales de l’image dans 4D et ces dimensions doivent rester constantes après la création de l’image (il est toutefois possible de modifier les dimensions de l’image résultante avec la commande TRANSFORM PICTURE de 4D).

Reportez-vous également à la description de la commande SVG GET ATTRIBUTE pour obtenir la liste des attributs 4D réservés et dédiés à l’animation.

Si vous tentez de modifier un attribut d’un élément non pris en charge ou l’un de ses enfants, la commande ne fait rien et aucune erreur n’est générée.

Si la commande est exécutée en-dehors du contexte d'un formulaire ou si un objetImage invalide est passé, la variable OK prend la valeur 0. Si la commande a été exécutée correctement, elle prend la valeur 1.

Modification du contenu d’un élément de type texte :

Note : Il n’y a pas de namespace pour que l’attribut puisse être utilisé dans une feuille de style CSS sans risque de conflit.