Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / HTML

onload — tratar o evento load

O atributo onload contém JavaScript que trata o evento load. No elemento body, diz respeito ao carregamento da página e trata o evento do objeto Window, e não um evento do próprio body.

Versão: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaxe

onload="JavaScript statements"

onload é um atributo de conteúdo de tratamento do evento load. O seu valor é o corpo de uma função JavaScript, não o endereço de um ficheiro de script. A adição do atributo não inicia, por si só, o carregamento de um recurso.

No elemento body, onload trata o evento do objeto Window. Por isso, não significa apenas que o elemento body está pronto. O evento da página ocorre depois de a análise terminar e de deixarem de existir fatores que atrasem o carregamento da página; DOMContentLoaded ocorre mais cedo neste processo e não é equivalente.

O código do atributo é JavaScript executável: não introduza nele dados não fidedignos. Content Security Policy pode bloquear estes tratadores inline.

O exemplo altera o texto do parágrafo de Waiting para Loaded depois de a página carregar. Não obtém recursos externos. Guarde-o como um ficheiro HTML e abra-o num navegador com JavaScript ativado e sem uma política que bloqueie tratadores inline.

Exemplos

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>onload example</title>
</head>
<body onload="document.getElementById('status').textContent = 'Loaded'">
  <p id="status">Waiting</p>
</body>
</html>

Resultado

Loaded

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes