Note:document.registerElement() está depreciado em favor do customElements.define().
O método document.registerElement()
registra um novo elemento personalizado no browser e returna um construtor para o novo elemento.
Nota: Esta é uma tecnologia experimental. O browser você precisa usar suporte à componentes web. Veja Habilitando componentes web no Firefox.
Sintaxe
var constructor = document.registerElement(tag-name, options);
Parâmetros
- tag-name
- O nome do elemento personalizado. O nome precisa conter um dash (-), por exemplo minha-tag.
- OpçõesOptional
-
Um projeto com propriedades protótipo como base para o elememento personalizado, e extends, uma existente tag para estender. Ambos são opcionais.
Exemplo
Aqui é um exemplo muito simples:
var Mytag = document.registerElement('my-tag');
Agora as novas tags são registradas no browser.
Uma variável Mytag tem um construtor que você pode usar para criar um elemento my-tag nos documentos como seguem:
document.body.appendChild(new Mytag());
Isto insere um elemento vazio my-tag que será visível se você usar o browser para desenvolvedores. Isto não será visível se você usar a ferramenta visão da capacidade do código fonte do browser. E isto não será visível no browser a menos que você adicione alguns conteúdos para a tag. Aqui está um caminho para adicionar conteúdo a nova tag:
var mytag = document.getElementsByTagName("my-tag")[0];
mytag.textContent = "I am a my-tag element.";
Especificações
Especificação | Estado | Comentário |
---|---|---|
Unknown | Desconhecido |
definição inicial |
Compatibilidade do Browser
Característica | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|
Suporte básico | 35 | 31[1] | Não suportado | 25 | Não suportado |
Feature | Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|
Suporte básico | 4.4.4 | 31[1] | Não suportado | 25 | Não suportado |
[1] Esta API é implementada uma preferência