setAttribute (méthode W3C Dom Core)

retourne

void

lance

invalid_character_err, no_modification_allowed_err

Les plats clés

• La méthode SetAttribute dans JavaScript permet aux développeurs d'ajouter, de modifier ou de mettre à jour les attributs et leurs valeurs dans un élément HTML. Cela fait partie du modèle d'objet de document (DOM) et il prend deux paramètres: le nom d'attribut et sa valeur.
• La méthode SetAttribute est sensible à la casse et peut être utilisée pour modifier les styles CSS et les attributs de données personnalisés. Cependant, pour les gestionnaires d'événements, il est recommandé d'utiliser la méthode AddeveventListener au lieu de setAttribute.
• Soyez prudent lorsque vous utilisez des noms basés sur Camel dans SetAttribute, car cela peut provoquer des incohérences dans différents navigateurs. De plus, lors de la définition d'une valeur, la valeur n'est pas analysée, ce qui signifie que toute référence d'entité ou autre majoration sera traitée comme du texte littéral.

Exemple

element.setAttribute('rel', 'me');

L'exemple ci-dessus définit un attribut rel avec la valeur me sur un élément.

Donc, si l'élément en question était ce HTML:

<a href="http://www.brothercake.com/">brothercake</a>

Ensuite, l'opération ci-dessus en résulterait:

<a href="http://www.brothercake.com/" rel="me">brothercake</a>

Arguments

Nom (Domstring) requis

le nom de l'attribut à créer ou altérer.

Valeur (Domstring) requis

la valeur de chaîne pour le attribut.

Description

Définissez un nouvel attribut avec le nom et la valeur spécifiés à cet élément.

Si un attribut existe déjà avec le nom spécifié, sa valeur est remplacée.

Lors de la définition d'une valeur, la valeur n'est pas analysée, donc toute référence entité ou autre majoration sera traitée comme du texte littéral. Pour créer un attribut contenant des entités, la spécification suggère de créer un nœud ATTR avec des nœuds de texte et d'entité de référence appropriés en tant qu'enfants, puis ajoutez-le à un élément à l'aide de setAttributeNode, mais dans la pratique, cela fonctionne rarement (voir ATRA pour plus de détails).

Cette méthode est pour travailler avec des attributs non conformes aux noms; Pour ajouter un attribut d'espace de nom, utilisez plutôt la méthode Dom 2 SetAttributens.

Soyez prudent avec les noms d'attribut de camel

Vous devez être prudent en utilisant des noms basés sur Camel dans le code destiné à tous les navigateurs, car en mode Opera en mode XHTML, la définition d'un attribut avec un nom basé sur Camel peut affecter sa propriété DOM correspondante. Par exemple, si vous définissez un attribut appelé tabindex sur n'importe quelle valeur, il aura pour effet de réinitialiser la propriété Tabindex sur 0 (sa valeur par défaut), de supprimer entièrement l'attribut Tabindex d'origine et de créer un nouvel attribut avec le nom Tabindex et l'on Valeur de chaîne spécifiée.

Ce comportement est probablement dû à une incohérence dans la façon dont la sensibilité case est gérée en mode xhtml. Dans d'autres navigateurs (Firefox et Safari), le faire créera un nouvel attribut appelé Tabindex, tout en laissant l'attribut Tabindex d'origine et sa propriété Tabindex correspondante inchangée.

Cette note ne s'applique qu'à ces navigateurs en mode xhtml - en mode html2 L'argument de nom est insensible à la cas, donc tabindex est traité comme tabindex.

De plus, IE dans HTML ne peut pas définir l'attribut de type d'un élément d'entrée - tenter de le faire lancer une erreur (cette commande n'est pas prise en charge). Il ne peut pas non plus définir l'attribut de style (cela n'a tout simplement aucun effet) et ne peut pas définir les attributs de gestion des événements en tant que chaînes (pour le faire n'a aucun effet, à moins que cet élément ait déjà un attribut de gestion des événements du même nom, Dans lequel le cas de l'opération pour en définir un nouveau supprimera l'ancien, ne laissant rien - bien que GetAttribute renvoie par la suite la valeur de chaîne définie, il n'y aura pas de gestionnaire d'événements actif sur l'élément). IE peut cependant définir les attributs de gestion des événements si une fonction est transmise comme argument de valeur, plutôt qu'une chaîne:

element.setAttribute('rel', 'me');

Enfin, si cette méthode est utilisée pour définir l'attribut SRC d'une image, la valeur qui est ensuite renvoyée de GetAttribute sera un URI pleinement qualifié; C'est la même chose que son comportement lors de la récupération d'un SRC qui a été réglé en HTML statique. Cependant, lors de la définition du HREF d'un lien, la valeur qui est retournée par la suite sera la valeur littérale qui a été définie; Ceci est différent de son comportement avec un HTML statique dans lequel la valeur est renvoyée en tant qu'URI qualifié.

comment puis-je savoir si cela fonctionne?

Déterminer si cette méthode fonctionne comme prévu est particulièrement difficile, car il est possible de définir un attribut de tout nom, bien que ce ne soit pas l'attribut que vous attendez. Par exemple, dans Internet Explorer, vous pouvez toujours définir un attribut appelé Class, et le récupérer par la suite avec GetAttribute ('Class'), mais il ne correspondra pas à la propriété ClassName - ce sera un attribut entièrement distinct qui ne fait aucune différence visuelle pour l'élément.

Dans tous les navigateurs, un attribut qui évalue à un booléen (comme les désactivé) ne peut être défini sur true - le définir sur FALSE n'a aucun effet. Il s'agit d'un comportement correct, et est dû au fait que ces attributs ne devraient avoir qu'une seule valeur possible (c.-à-d. Disabled = ”Disabled”), ou ne sont pas définies (ce qui les rend donc à faire avec RemoveAttribute). Dans Opera 9.5, Firefox et Safari, la valeur d'attribut reviendra par la suite comme fausse, mais l'élément sera toujours désactivé, dans Opera 9.0, la valeur continuera à revenir en tant que désactivée, et dans Internet Explorer, la valeur continuera de revenir en tant que Boolean True; Ce sont des réflexions précises de l'état de l'élément, même s'ils sont un peu déroutants! Cependant, comme IE considère que ces attributs ont une valeur booléenne réelle, la valeur peut être basculée (et l'élément désactivé et activé en conséquence) en le définissant comme un booléen plutôt qu'une chaîne:

element.setAttribute('rel', 'me');

Internet Explorer implémente un deuxième argument à SetAttribute, qui est un indicateur de sensibilité de cas qui peut prendre la valeur 0 (insensible à la casse) ou 1 (par défaut, sensible à la casse). Cet argument fonctionne comme prévu dans IE et n'affecte aucun autre navigateur.

Des questions fréquemment posées sur SetAttribute W3C Dom Core Méthode

Quelle est la méthode SetAttribute dans JavaScript?

La méthode SetAttribute en JavaScript est une partie cruciale du modèle d'objet de document (DOM) qui permet aux développeurs de manipuler les éléments HTML. Cette méthode est utilisée pour ajouter, modifier ou mettre à jour les attributs et leurs valeurs dans un élément HTML. Il prend deux paramètres: le nom d'attribut et sa valeur. Par exemple, si vous souhaitez modifier la couleur d'un texte, vous pouvez utiliser SetAttribute pour modifier l'attribut de style de l'élément.

En quoi SetAttribute diffère-t-il de GetAttribute?

Pendant que SetAttribute est utilisé Pour ajouter ou modifier la valeur d'un attribut, GetAttribute est utilisé pour récupérer la valeur d'un attribut. Les deux sont des méthodes de l'interface d'élément dans le DOM. Ils travaillent ensemble pour permettre aux développeurs d'interagir et de manipuler des éléments HTML.

Puis-je utiliser SetAttribute pour modifier les styles CSS?

Oui, vous pouvez utiliser SetAttribute pour modifier les styles CSS. La méthode peut modifier l'attribut de style d'un élément HTML, qui contient des propriétés CSS. Cependant, il est important de noter que l'utilisation de setAttribute écrasera tous les styles en ligne existants. Si vous souhaitez modifier une propriété de style spécifique sans affecter les autres, il est préférable d'utiliser la propriété de style de l'élément.

Que se passe-t-il si l'attribut n'existe pas?

Si l'attribut ne fait pas existe, la méthode setAttribute le créera avec la valeur spécifiée. C'est l'une des raisons pour lesquelles SetAttribute est si puissant: il permet aux développeurs d'ajouter dynamiquement des attributs aux éléments HTML.

Puis-je utiliser SetAttribute avec des attributs de données personnalisés?

Oui, SetAttribute peut être utilisé avec des attributs de données personnalisés. Cela est particulièrement utile lorsque vous devez stocker des informations supplémentaires qui n'ont aucune représentation visuelle. N'oubliez pas de préfixer le nom d'attribut avec «Data» pour se conformer aux normes HTML5.

est-ce que SetAttribute est sensible à la cas?

Oui, SetAttribute est sensible à la casse. Cela signifie que la «classe» et la «classe» seraient traitées comme deux attributs différents. Assurez-vous toujours d'utiliser le bon cas lorsque vous travaillez avec des attributs.

Puis-je utiliser SetAttribute pour ajouter des gestionnaires d'événements?

Bien qu'il soit techniquement possible d'utiliser SetAttribute pour ajouter des gestionnaires d'événements, il n'est pas recommandé. En effet, la valeur d'un attribut d'événement est toujours une chaîne, ce qui signifie que vous ne pouvez pas attribuer directement une fonction en tant que gestionnaire d'événements. Au lieu de cela, utilisez la méthode addEventListener, qui est spécialement conçue à cet effet.

SetAttribute fonctionne-t-il avec tous les éléments HTML?

Oui, SetAttribute fonctionne avec tous les éléments HTML. Cependant, tous les attributs ne sont pas applicables à tous les éléments. Par exemple, l'attribut «src» est pertinent pour les éléments «img», mais pas pour les éléments «p».

Quels sont les cas d'utilisation courants pour setAttribute?

SetAttribute est couramment utilisé pour changer dynamiquement l'apparence ou le comportement d'un élément HTML. Par exemple, vous pouvez l'utiliser pour modifier la couleur d'un texte, ajouter une bordure à une image ou modifier la source d'une image. Il est également utilisé pour ajouter des attributs de données personnalisés.

Y a-t-il des alternatives à setAttribute?

Oui, il existe des alternatives à setAttribute. Par exemple, vous pouvez modifier directement les propriétés d'un élément HTML. Ceci est souvent plus simple et plus intuitif que l'utilisation de setAttribute. Cependant, SetAttribute a l'avantage de pouvoir travailler avec n'importe quel attribut, y compris les attributs de données personnalisés.

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!