Document.readyState

Cette traduction est incomplète. Aidez à traduire cet article depuis l'anglais.

Résumé

La valeur Document.readyState est une propriété de document qui décrit l'état de chargement du document.

Valeurs

La variable readyState peut valoir : 

loading
Le document est encore en chargement.
interactive
Le document a été chargé, mais les ressources (images, scripts, css..) sont encore en cours d'acquisition. En revanche la structure DOM est générée, et DOMContentLoaded a été émis.
complete
Le document et toutes les sous-ressources ont été chargés, et load a été émis..

À chaque évolution de la valeur, un évenement readystatechange est émis dans l'objet document.

Syntaxe

var string = document.readyState;

Exemples

Différents états de chargement

switch (document.readyState) {
  case "loading":
    // Encore en chargement.
    break;
  case "interactive":
    // Le DOM est construit, on peut y accéder.
    var span = document.createElement("span");
    span.textContent = "A <span> element.";
    document.body.appendChild(span);
    break;
  case "complete":
    // La page est pleinement chargée.
    console.log("The first CSS rule is: " + document.styleSheets[0].cssRules[0].cssText);
    break;
}

readystatechange comme alternative à  DOMContentLoaded

// alternative à DOMContentLoaded 
document.onreadystatechange = function () {
  if (document.readyState == "interactive") {
    initApplication();
  }
}

readystatechange comme alternative à load

// alternative à load
document.onreadystatechange = function () {
  if (document.readyState == "complete") {
    initApplication();
  }
}

Spécifications

Spécifications Status Commentaires
WHATWG HTML Living Standard
La définition de 'Document readiness' dans cette spécification.
Standard évolutif  
HTML5.1
La définition de 'Document readiness' dans cette spécification.
Version de travail  
HTML5
La définition de 'Document readiness' dans cette spécification.
Recommendation Initial specification.

Voir aussi

Étiquettes et contributeurs liés au document

Étiquettes : 
 Contributeurs à cette page : tobozo, thefractaler
 Dernière mise à jour par : tobozo,