Document.registerElement()

**Nota:**document.registerElement() está depreciado em favor do customElements.define().

O método document.registerElement() registra um novo elemento personalizado (en-US) no browser e retorna 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 com navegadores

BCD tables only load in the browser

Veja também