Document.registerElement()
Warnung: document.registerElement() läuft zu Gunsten von customElements.define() aus.
Draft
This page is not complete.
Die document.registerElement()
-Methode registriert ein neues benutzerdefiniertes Element im Browser und gibt einen Konstruktor für das neue Element zurück.
Hinweis: Dies ist eine experimentelle Technologie. Der Browser, der sie benutzen soll, muss Web Components unterstützen. Siehe Web Components in Firefox erlauben.
Syntax
var constructor = document.registerElement(tag-name, options);
Parameter
- tag-name
- Der Name des benutzerdefinierten Elements. Der Name muss einen Bindestrich (-) enthalten, zum Beispiel
my-tag
. - options Optional
-
Ein Objekt mit den Eigenschaften prototype, auf dem das benutzerdefinierte Element basieren soll, und extends, einem bestehenden Tag, der erweitert werden soll. Beide sind optional.
Beispiel
Hier ist ein einfaches Beispiel:
var Mytag = document.registerElement('my-tag');
Der Tag ist num im Browser registriert. Die Mytag
-Variable enthält einen Konstruktor, der benutzt werden kann, um ein my-tag
-Element wie folgt im Dokument zu erzeugen:
document.body.appendChild(new Mytag());
Das fügt ein leeres my-tag
-Element ein, dass sichtbar wird, wenn die Entwicklerwerkzeuge des Browsers benutzt werden aber nicht, wenn mit Hilfe des Brwoser der Quellcode betrachtet wird. So lange dem Tag kein Inhalt beigefügt wird, wird es auch in der normalen Browser-Ansicht nicht sichtbar sein. Inhalt kann beispielsweise folgendermaßen hinzugefügt werden:
var mytag = document.getElementsByTagName("my-tag")[0];
mytag.textContent = "I am a my-tag element.";
Browserkompatibilität
Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|
Grundlegende Unterstützung | 35 | 31[1] | Nicht unterstützt | 25 | Nicht unterstützt |
Feature | Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|
Grundlegende Unterstützung | 4.4.4 | 31[1] | Nicht unterstützt | 25 | Nicht unterstützt |
[1] Diese API ist hinter einer Einstellung versteckt.