Node.setUserData()

Diese Übersetzung ist unvollständig. Bitte helfen Sie uns, diesen Artikel aus dem Englischen zu übersetzen

Veraltet
Dieses Feature ist veraltet. Obwohl es in manchen Browsern immer noch funktioniert, wird von seiner Benutzung abgeraten, da es jederzeit entfernt werden kann. Es sollte daher nicht mehr verwendet werden.

Die Methode Node.setUserData()erlaubt es dem Benutzer Daten dem Element hinzuzufügen (oder löschen), ohne dabei die DOM zu modifizieren. Beachte dabei, dass die Daten durch das Nutzen von Node.importNode, Node.cloneNode() und Node.renameNode() nicht mitgegeben werden kann (jedoch kann Node.adoptNode die Information behalten), und bei Vergleichstest mit Node.isEqualNode() werden die Daten nicht berücksichtigt.

This method offers the convenience of associating data with specific nodes without needing to alter the structure of a document and in a standard fashion, but it also means that extra steps may need to be taken if one wishes to serialize the information or include the information upon clone, import, or rename operations.

The Node.getUserData and Node.setUserData methods are no longer available from Web content. Element.dataset or WeakMap can be used instead.

Syntax

var prevUserData = someNode.setUserData(userKey, userData, handler);

Parameters

  • userKey is used as the key by which one may subsequently obtain the stored data. More than one key can be set for a given node.
  • handler is a callback which will be called any time the node is being cloned, imported, renamed, as well as if deleted or adopted; a function can be used or an object implementing the handle method (part of the UserDataHandler interface). The handler will be passed five arguments: an operation type integer (e.g., 1 to indicate a clone operation), the user key, the data on the node, the source node (null if being deleted), the destination node (the newly created node or null if none).If no handler is desired, one must specify null.
  • userData is the object to associate to userKey on someNode. If null, any previously registered object and UserDataHandler associated to userKey on this node will be removed.

Beispiel

var d = document.implementation.createDocument('', 'test', null); 
d.documentElement.setUserData('key', 15, {handle:function (o, k, d, s, ds) {console.log(o+'::'+k+'::'+d+'::'+s+'::'+ds)}}); // 2::key::15::[object Element]::[object Element]
console.log(d.documentElement.getUserData('key')); // 15
var e = document.importNode(d.documentElement, true); // causes handler to be called
console.log(e.getUserData('key')); // null since user data is not copied

Spezifikationen

Spezifikationen Status Kommentar
DOM
Die Definition von 'Node' in dieser Spezifikation.		 Lebender Standard Removed from the specification.
Document Object Model (DOM) Level 3 Core Specification
Die Definition von 'Node.setUserData()' in dieser Spezifikation.		 Veraltet Initial definition

Browser Kompabilität

Wir konvertieren die Kompatibilitätsdaten in ein maschinenlesbares JSON Format. Diese Kompatibilitätstabelle liegt noch im alten Format vor, denn die darin enthaltenen Daten wurden noch nicht konvertiert. Finde heraus wie du helfen kannst!

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari
Basic support Nicht unterstützt 1.0 (1.7 oder früher)
Nicht unterstützt 22.0 (22.0)[1]		 ? Nicht unterstützt Nicht unterstützt
Feature Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Basic support Nicht unterstützt 1.0 (1.0)
Nicht unterstützt 22.0 (22.0)[1]		 (Ja) Nicht unterstützt Nicht unterstützt

[1] The method is still available from within chrome scripts.

Siehe auch