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.