Objeto HTMLElement XML DOM

O objeto HTMLElement representa um elemento no HTML.

Propriedades do objeto HTMLElement

Cada elemento de um documento HTML tem uma propriedade correspondente à propriedade HTML do elemento. Aqui estão listadas todas as propriedades suportadas por todos os marcadores HTML. Outras propriedades são específicas de某种 HTML específico. O objeto HTMLElement herda Node e Element A propriedade padrão do objeto, que também implementa várias propriedades não padrão descritas a seguir:

className

Define a propriedade class do elemento. Atenção: o nome dessa propriedade não é "class", porque "class" é uma palavra reservada no JavaScript.

Tipo: String. Estado: Editável.

currentStyle

Essa propriedade específica do IE aplica-se ao grupo de cascata de todas as propriedades CSS do elemento. É uma alternativa específica para o IE do Window.getComputedStyle().

Tipo: String. Estado: Editável.

dir

Define a propriedade dir do elemento, que declara a direção do texto do documento.

Tipo: String. Estado: Editável.

id

Define a propriedade id do elemento. Em um documento, nenhum elemento possui o mesmo valor de id.

Tipo: String. Estado: Editável.

innerHTML

Define a string contida pelo elemento, sem incluir os marcadores de início e fim do elemento próprio. Consultar essa propriedade retornará o conteúdo do elemento como uma string de texto HTML. Definir essa propriedade como uma string de texto HTML permitirá substituir o conteúdo do elemento com a representação de análise do HTML. Não é possível definir essa propriedade no momento da carga do documento. Esta é uma propriedade não padrão originária do IE4, que já é suportada por todos os navegadores modernos.

Tipo: String. Estado: Editável.

lang

Define a propriedade lang do elemento, que declara o código de idioma do conteúdo do elemento.

Tipo: String. Estado: Editável.

offsetHeight, offsetWidth

Retorna a altura e largura do elemento, em pixels. Essas são propriedades não padrão, mas bem suportadas.

Tipo: int. Estado: Leitura.

offsetLeft

Retorna o deslocamento, em pixels, da esquerda do elemento até a esquerda do seu elemento contido.

Tipo: int. Estado: Leitura.

offsetTop

Retorna o deslocamento, em pixels, do topo do elemento até o topo do seu elemento contido.

Tipo: int. Estado: Leitura.

offsetParent

Retorna uma referência ao elemento de contorno mais recente dinamicamente posicionado, todas as quantias de deslocamento são determinadas com base nesse elemento. Se o estilo display do elemento for definido como none, essa propriedade retorna null. Essas são propriedades não padrão, mas bem suportadas.

Tipo:Node. Estado: Leitura.

scrollHeight, scrollWidth

Retorna a altura e largura completa do elemento, em pixels. Quando um elemento tiver uma barra de rolagem (por exemplo, devido ao atributo CSS overflow), essas propriedades são diferentes de offsetHeight e offsetWidth, que relatam apenas o tamanho visível do elemento. Essas são propriedades não padrão, mas bem suportadas.

Tipo: int. Estado: Leitura.

scrollTop, scrollLeft

Define ou retorna o número de pixels que já rolaram para a borda esquerda ou superior do elemento. Esses pixels são úteis apenas quando o elemento tiver uma barra de rolagem, por exemplo, quando o atributo CSS overflow do elemento for definido como auto. Esses atributos também estão definidos apenas no <body> ou <html> do documento (isto depende do navegador) e juntos determinam a posição de rolagem do documento. Observe que essas propriedades não especificam a quantidade de rolagem de uma marcação <iframe>. Essas são propriedades não padrão, mas bem suportadas.

Tipo: int. Estado: Editável.

style

Retorna o valor do atributo style CSS definido inline para o elemento atual. Observe que o valor dessa propriedade não é uma string.

Tipo:CSS2Properties. Estado: Leitura.

title

Define a propriedade title do elemento. Quando o mouse está sobre o elemento, muitos navegadores mostram o valor dessa propriedade no "tooltip" do elemento.

Tipo: String. Estado: Editável.

metodos do objeto HTMLElement

O objeto HTMLElement herda Node e Element metodos padrão do objeto. Alguns tipos de elementos implementam métodos específicos para a marcação, CodeW3C.com em Manual de referência do HTML DOMAs páginas de referência de cada marcação fornecem informações sobre esses métodos.

A maioria dos navegadores modernos também implementou os seguintes métodos não padrão:

Método Descrição
scrollIntoView() Rolar o documento. Coloca o elemento no topo ou na parte inferior da janela.

Manipuladores de eventos do objeto HTMLElement

Todos os elementos HTML que respondem a eventos de mouse e teclado podem disparar os manipuladores de eventos listados aqui. Alguns elementos, como links e botões, executam operações padrão quando esses eventos ocorrem. Para esses elementos, mais detalhes podem ser encontrados emPáginas de referência de elementos específicosencontrado.

Consulte Manual de referência das propriedades de evento do HTML, para saber mais sobre os manipuladores de eventos do HTML.

Como obter informações mais detalhadas sobre o objeto HTMLElement

No manual do HTML DOM do CodeW3C.com, criamos páginas de referência específicas para os objetos DOM correspondentes a cada marcação de HTML:

Manual de referência do HTML DOM

Páginas relacionadas

Manual de referência do XML DOM:Objeto Document

Manual de referência do XML DOM:getElementById() do Document

Manual de referência do XML DOM:getElementsByTagName() do Document