Objeto Janela

Objeto Janela

O objeto Window representa a janela aberta no navegador.

Se o documento contiver uma estrutura (frame ou iframe), o navegador criará um objeto window para o documento HTML e um objeto window adicional para cada estrutura.

Anotação:Não há padrão aberto aplicado ao objeto window, mas todos os navegadores suportam o objeto.

Conjunto do objeto Window

Conjunto Descrição
frames[]

Retorna todos os frames nomeados na janela.

Este conjunto é um array do objeto Window, onde cada objeto Window contém um frame ou <iframe> na janela. O atributo frames.length armazena o número de elementos no array frames[]. Note que os frames[] no array podem referenciar outros frames que também têm um array frames[].

Atributo do objeto Window

Atributo Descrição
closed Retorna se a janela foi fechada.
defaultStatus Define ou retorna o texto padrão da barra de estado da janela.
document Referência apenas para o objeto Document. Veja Objeto Document.
history Referência apenas para o objeto History. Verifique os parâmetros. Objeto História.
innerheight Retorna a altura da área de exibição do documento da janela.
innerwidth Retorna a largura da área de exibição do documento da janela.
length Define ou retorna o número de frames na janela atual.
location Objeto Location usado para janelas ou frames. Veja Objeto Location.
name Define ou retorna o nome da janela.
Navigator Referência apenas para o objeto Navigator. Verifique os parâmetros. Objeto Navigator.
opener Retorna uma referência para a janela que criou esta janela.
outerheight Retorna a altura externa da janela.
outerwidth Retorna a largura externa da janela.
pageXOffset Define ou retorna a posição X da página em relação ao canto superior esquerdo da área de exibição da janela.
pageYOffset Define ou retorna a posição Y da página em relação ao canto superior esquerdo da área de exibição da janela.
parent Retorna a janela pai.
Screen Referência apenas para o objeto Screen. Verifique os parâmetros. Objeto Screen.
self Retorna uma referência para a janela atual. É equivalente à propriedade Window.
status Define o texto da barra de estado da janela.
top Retorna a janela ancestral mais alta.
window A propriedade window é equivalente à propriedade self, que contém uma referência para a própria janela.
  • screenLeft
  • screenTop
  • screenX
  • screenY
Só leitura inteira. Declara as coordenadas x e y do canto superior esquerdo da janela na tela. IE, Safari e Opera suportam screenLeft e screenTop, enquanto Firefox e Safari suportam screenX e screenY.

Métodos do objeto Window

Métodos Descrição
alert() Exibe uma caixa de aviso com uma mensagem e um botão de confirmação.
blur() Tira o foco do teclado da janela superior.
clearInterval() Cancela o timeout configurado pelo setInterval().
clearTimeout() Cancela o timeout configurado pelo método setTimeout().
close() Fecha a janela do navegador.
confirm() Exibe uma caixa de diálogo com uma mensagem e botões de confirmação e cancelamento.
createPopup() Cria uma janela pop-up.
focus() Dá foco ao teclado para uma janela.
moveBy() Move o objeto a uma distância específica em pixels em relação às coordenadas atuais da janela.
moveTo() Move o canto superior esquerdo da janela para um ponto de coordenada especificado.
open() Abre uma nova janela do navegador ou busca uma janela nomeada existente.
print() Imprime o conteúdo da janela atual.
prompt() Exibe uma caixa de diálogo que permite ao usuário inserir entrada.
resizeBy() Ajusta o tamanho da janela com base no valor de pixels especificado.
resizeTo() Ajusta o tamanho da janela para a largura e altura especificadas.
scrollBy() Rola o conteúdo com base no valor de pixels especificado.
scrollTo() Rola o conteúdo para as coordenadas especificadas.
setInterval() Chama uma função ou calcula uma expressão em um ciclo específico (medido em milissegundos).
setTimeout() Chama uma função ou calcula uma expressão após um número especificado de milissegundos.

Descrição do objeto Window

O objeto Window representa uma janela do navegador ou um frame. No JavaScript do cliente, o objeto Window é um objeto global, e todas as expressões são calculadas no ambiente atual. Isso significa que para referenciar a janela atual, não é necessário um sintaxe especial, e pode usar as propriedades daquela janela como variáveis globais. Por exemplo, pode-se escrever apenas document,sem necessidade de escrever window.document。

Da mesma forma, os métodos do objeto janela atual podem ser usados como funções, por exemplo, apenas escrever alert(), sem necessidade de escrever Window.alert().

Além das propriedades e métodos listados acima, o objeto Window implementou todas as propriedades e métodos globais definidos pelo JavaScript nuclear.

A propriedade window do objeto Window e Propriedade selfAmbos referenciam a si mesmos. Quando você deseja referenciar explicitamente a janela atual, e não apenas implicitamente, você pode usar essas duas propriedades. Além dessas duas propriedades, a propriedade parent, a propriedade top e o array frame[] também referenciam outros objetos Window relacionados ao objeto Window atual.

Para referenciar um frame dentro da janela, você pode usar a seguinte sintaxe:

frame[i]		//Frame atual da janela
self.frame[i]	//Frame atual da janela
w.frame[i]	//Frame w da janela

Para referenciar o pai de um frame (ou frame pai), você pode usar a seguinte sintaxe:

parent		//Janela pai da janela atual
self.parent	//Janela pai da janela atual
w.parent 		//Janela pai da janela w

Para referenciar qualquer frame contido na janela superior, você pode usar a seguinte sintaxe:

top		//Janela superior do frame atual
self.top		//Janela superior do frame atual
f.top		//Janela superior do frame f

Uma nova janela de navegador de topo é criada pelo método Window.open(). Quando você chama este método, você deve armazenar o valor de retorno da chamada open() em uma variável e usar essa variável para referenciar a nova janela. A nova janela Propriedade openerE vice-versa, referindo-se à janela que a abriu.

Geralmente, os métodos do objeto Window são operações de algum tipo no navegador ou na janela de frames. Método alert()EMétodo confirm()E Método promptDiferem, interagindo com o usuário através de diálogos simples.