Métodos de document

O objeto document, localizado abaixo do objeto window na hierarquia de objetos de Javascript, também tem uma lista de métodos interessantes. Veremos a seguir:

captureEvents()
Para capturar os eventos que acontecem na página web. Recebe como parâmetro o evento que se deseja capturar.

close()
Fecha o fluxo do documento. (Será visto mais adiante neste manual um artigo sobre o fluxo do documento)

contextual()
Oferece uma linha de controle dos estilos da página. No caso de desejarmos especificá-los com Javascript.

getSelection()
Devolve um string que contem o texto que foi selecionado. Funciona somente em Netscape.

handleEvent()
Invoca o manipulador de eventos do elemento especificado.

open()
Abre o fluxo do documento.

releaseEvents()
Libera os eventos capturados do tipo que se especifique, enviando-os aos objetos seguintes na hierarquia.

routeEvent()
Passa um evento capturado através da hierarquia de eventos habitual.

write()
Escreve dentro da página web. Podemos escrever etiquetas HTML e texto normal.

writeln()
Escreve igual que o método write(), embora coloque uma quebra de linha no final.

Os eventos de document servem principalmente para controlar duas coisas. Um grupo nos oferece uma série de funções para o controle dos documentos, como escrever, abrir ou fechar. Veremos no próximo capítulo que fala sobre o controle do fluxo de escritura do documento. O outro grupo oferece ferramentas para o controle dos eventos no documento e o veremos mais adiante quando tratarmos com detalhe o tema de eventos.

O método getSelection() fica para nós um pouco solto, pois só funciona nos navegadores de Netscape e portanto, não é muito útil para as aplicações que desejarmos que sejam compatíveis em todos os sistemas. Mesmo assim, faremos um exemplo sobre este método, já que os outros serão vistos nos próximos capítulos.

O exemplo consiste em uma página que tem um pouco de texto e um botão. Na página poderemos selecionar algo de texto e logo, apertar o botão que chama a uma função que mostra em uma caixa alert o texto que foi selecionado. O código é o seguinte:

<html>
<head>
<title>Resgatar o selecionado</title>
<script language="JavaScript">
function mostrarSelecionado(){
alert("Foi selecionado:\n" + document.getSelection())
}
</script>
</head>

<body>
<h1>Resgatar o selecionado</h1>
<br>

<form>
<input type="button" value="clica-me!" onClick="mostrarSelecionado()">
</form>

Selecione qualquer texto da página e clique o botão.

</body>
</html>

Pode-se ver em funcionamento o script em uma página a parte, embora somente funcionará em Netscape e Internet Explorer dará un error.