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

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!

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

Veja também

Etiquetas do documento e colaboradores

 Colaboradores desta página: rener_bz, mak213k
 Última atualização por: rener_bz,