CKTIS / HTML
loading — adiar o carregamento de recursos
O atributo loading indica se o carregamento de um recurso pode ser adiado com base na posição do elemento em relação à área visível da página. Aceita lazy ou eager; se for omitido ou tiver um valor inválido, aplica-se eager. A norma define-o para img, iframe, audio e video.
Versão: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxe
loading="eager" | loading="lazy"loading é um atributo enumerado, não booleano nem global. Em img, iframe, audio e video, lazy adia a obtenção até serem satisfeitas condições relacionadas com a posição. eager desativa este adiamento; não garante que o carregamento termine nem que tenha prioridade elevada. Se o atributo for omitido, estiver vazio (loading="") ou tiver um valor inválido, como loading="false", aplica-se o estado eager.
Com lazy, o navegador pode iniciar a obtenção antes de o elemento entrar na área visível. A margem que desencadeia o carregamento depende da implementação, pelo que não deve pressupor uma distância ou um tempo específicos. Quando a execução de scripts está desativada, este mecanismo não adia o carregamento, como medida contra o seguimento da deslocação. No entanto, não é necessário JavaScript para utilizar o atributo.
Nos elementos multimédia, lazy tem precedência sobre preload: primeiro adia a obtenção e, quando o carregamento é retomado, continuam a aplicar-se as regras de preload. Também adia o início da reprodução através de autoplay e a obtenção da imagem poster de um elemento video. Um elemento audio sem controls não é apresentado, o que impede o seu carregamento diferido. A inclusão destas funcionalidades na norma não significa que todos os navegadores as suportem.
A propriedade DOM element.loading reflete o atributo e devolve os valores conhecidos; um valor inválido resulta em eager. Alterar o estado para eager retoma o carregamento pendente. O exemplo mostra os valores da propriedade para as opções válidas lazy e eager. Depois de definir loading="invalid", limita-se a comparar image.loading com o valor literal do atributo devolvido por image.getAttribute('loading'). O resultado false indica que os dois valores são diferentes; não confirma que a propriedade tenha devolvido eager. O exemplo não mede quando é obtida a imagem. Especifique width e height nas imagens para reservar espaço na disposição.
Exemplos
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Image loading attribute</title>
</head>
<body>
<img id="sample" loading="lazy" width="80" height="40" alt="Blue rectangle" src="data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='80' height='40'%3E%3Crect width='80' height='40' fill='blue'/%3E%3C/svg%3E">
<pre id="result"></pre>
<script>
const image = document.getElementById('sample');
const lazy = image.loading;
image.setAttribute('loading', 'eager');
const eager = image.loading;
image.setAttribute('loading', 'invalid');
const preservesInvalidToken = image.loading === image.getAttribute('loading');
document.getElementById('result').textContent = [
`Initial loading property: ${lazy}`,
`After setting loading="eager": ${eager}`,
`Invalid token preserved by the property: ${preservesInvalidToken}`
].join('\n');
</script>
</body>
</html>Resultado
Initial loading property: lazy After setting loading="eager": eager Invalid token preserved by the property: false
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.