Como posso verificar se uma imagem de fundo está carregada?

Quero definir uma imagem de plano de fundo na tag body e, em seguida, executar um código - como este:

$('body').css('background-image','http://picture.de/image.png').load(function() {
    alert('Background image done loading');
    // This doesn't work
});

Como posso garantir que a imagem de plano de fundo esteja totalmente carregada?

tente isto:

$('<img/>').attr('src', 'http://picture.de/image.png').on('load', function() {
   $(this).remove(); // prevent memory leaks as @benweet suggested
   $('body').css('background-image', 'url(http://picture.de/image.png)');
});

isso criará uma nova imagem na memória e usará o evento load para detectar quando o src é carregado.

Eu tenho um plugin jQuery chamado waitForImagesque pode detectar quando as imagens de fundo foram baixadas.

$('body')
  .css('background-image','url(http://picture.de/image.png)')
  .waitForImages(function() {
    alert('Background image done loading');
    // This *does* work
  }, $.noop, true);

Algo assim:

var $div = $('div'),
  bg = $div.css('background-image');
  if (bg) {
    var src = bg.replace(/(^url\()|(\)$|[\"\'])/g, ''),
      $img = $('<img>').attr('src', src).on('load', function() {
        // do something, maybe:
        $div.fadeIn();
      });
  }
});

Não há retornos de chamada JS para ativos CSS.

solução JS pura que adicionará o pré-carregador, defina a imagem de plano de fundo e configure-a para a coleta de lixo junto com seu ouvinte de eventos :

Versão curta:

const imageUrl = "https://www.google.com/images/branding/googlelogo/1x/googlelogo_color_272x92dp.png";
let bgElement = document.querySelector("body");
let preloaderImg = document.createElement("img");
preloaderImg.src = imageUrl;

preloaderImg.addEventListener('load', (event) => {
    bgElement.style.backgroundImage = `url(${imageUrl})`;
    preloaderImg = null;
});

Um pouco mais com boa transição de opacidade:

const imageUrl = "https://www.google.com/images/branding/googlelogo/1x/googlelogo_color_272x92dp.png";
let bgElement = document.querySelector(".bg-lazy");
bgElement.classList.add("bg-loading");
let preloaderImg = document.createElement("img");
preloaderImg.src = imageUrl;

preloaderImg.addEventListener('load', (event) => {
  bgElement.classList.remove("bg-loading");
  bgElement.style.backgroundImage = `url(${imageUrl})`;
  preloaderImg = null;
});

.bg-lazy {
  height: 100vh;
  width: 100vw;
  transition: opacity 1s ease-out;
}

.bg-loading {
  opacity: 0;
}

<div class="bg-lazy"></div>

Aqui está um pequeno plugin que eu criei para permitir que você faça exatamente isso, ele também funciona em várias imagens de fundo e em vários elementos:

Leia o artigo:

http://catmull.uk/code-lab/background-image-loaded/

ou vá direto para o código do plugin:

http://catmull.uk/downloads/bg-loaded/bg-loaded.js

Portanto, inclua o plug-in e chame-o no elemento:

<script type="text/javascript" src="http://catmull.uk/downloads/bg-loaded/bg-loaded.js"></script>
<script type="text/javascript">
   $('body').bgLoaded();
</script>

Obviamente, baixe o plug-in e armazene-o em sua própria hospedagem.

Por padrão, ele adiciona uma classe "bg-loaded" adicional a cada elemento correspondente depois que o plano de fundo é carregado, mas você pode facilmente mudar isso passando uma função diferente como esta:

<script type="text/javascript" src="http://catmull.uk/downloads/bg-loaded/bg-loaded.js"></script>
<script type="text/javascript">
   $('body').bgLoaded({
      afterLoaded : function() {
         alert('Background image done loading');
      }
   });
</script>

Aqui está um codepen demonstrando seu funcionamento.

http://codepen.io/catmull/pen/Lfcpb

Eu localizei uma solução que funcionou melhor para mim e que tem a vantagem de ser utilizável com várias imagens (caso não ilustrado neste exemplo).

Da resposta de @ adeneo nesta pergunta :

Se você tiver um elemento com uma imagem de plano de fundo, assim

<div id="test" style="background-image: url(link/to/image.png)"><div>

Você pode esperar o carregamento do plano de fundo obtendo o URL da imagem e usando-o para um objeto de imagem em javascript com um manipulador de onload

var src = $('#test').css('background-image');
var url = src.match(/\((.*?)\)/)[1].replace(/('|")/g,'');

var img = new Image();
img.onload = function() {
    alert('image loaded');
}
img.src = url;
if (img.complete) img.onload();

Eu fiz um truque de javascript puro para tornar isso possível.

<div class="my_background_image" style="background-image: url(broken-image.jpg)">
<img class="image_error" src="broken-image.jpg" onerror="this.parentElement.style.display='none';">
</div>

Ou

onerror="this.parentElement.backgroundImage = "url('image_placeHolder.png')";

css:

.image_error {
    display: none;
}

https://github.com/alexanderdickson/waitForImages

$('selector').waitForImages({
    finished: function() {
       // ...
    },
    each: function() {
       // ...
    },
    waitForAll: true
});