DOMImplementation.createHTMLDocument()

Cette fonction est expérimentale
Puisque cette fonction est toujours en développement dans certains navigateurs, veuillez consulter le tableau de compatibilité pour les préfixes à utiliser selon les navigateurs.
Il convient de noter qu'une fonctionnalité expérimentale peut voir sa syntaxe ou son comportement modifié dans le futur en fonction des évolutions de la spécification.

La méthode DOMImplementation.createHTMLDocument()  crée un nouveau Document HTML.

Syntaxe

newDoc = document.implementation.createHTMLDocument(titre);

Paramètres

titre  Facultatif
C'est un DOMString qui contient le titre à donner au nouveau document HTML.

Exemple

Dans cet exemple, on crée un nouveau document HTML que l'on insère dans un <iframe> dans le document courrant.

Ci-dessous, le code HTML pour cet exemple:

<body>
  <p>Cliquez <a href="javascript:makeDocument()">ici</a> pour créer un nouveau document et l'insérer au dessous.</p>
  <iframe id="laFrame" src="about:blank" />
</body>

L'implémentation en JavaScript de la méthode makeDocument():

function makeDocument() {
  var frame = document.getElementById("laFrame");
          
  var doc = document.implementation.createHTMLDocument("Nouveau Document");
  var p = doc.createElement("p");
  p.innerHTML = "Ceci est un nouveau paragraphe.";
  
  try {
    doc.body.appendChild(p);
  } catch(e) {
    console.log(e);
  }

  // Copie le nouveau document HTML dans la frame

  var destDocument = frame.contentDocument;
  var srcNode = doc.documentElement;
  var newNode = destDocument.importNode(srcNode, true);
  
  destDocument.replaceChild(newNode, destDocument.documentElement);
}

Le code des ligne 4 à 12 permet la création du nouveau document HTML et l'insertion de contenu dans ce dernier. La ligne 4 utilise la méthode createHTMLDocument() pour construire le nouveau document HTML et définir son <title> comme "Nouveau Document". Dans les lignes 5 et 6, on crée un nouvel élément paragraphe avec un simple contenu, enfin, les lignes 8 à 12 permettent l'insertion de ce nouveau paragraphe dans le nouveau document.

La ligne 16 permet de "tirer" le contentDocument de la frame; ceci est le document dans lequel nous allons injecter le nouveau contenu. Les deux lignes suivantes permettent d'importer le contenu de notre nouveau document dans le nouveau contexte du document. Pour finir, la ligne 20 remplace le contenu de la frame par le contenu du nouveau document.

Voir l'exemple sur une page

Le document retourné est préconstruit avec le code HTML suivant:

<!doctype html>
<html>
<head>
<title>titre</title>
</head>
<body>
</body>
</html>

Documentation

Documentation Statut Commentaire
DOM
La définition de 'DOMImplementation.createHTMLDocument' dans cette spécification.
Standard évolutif Première définition>

Compatibilité avec les navigateurs

Caractéristiques Chrome Firefox (Gecko) Internet Explorer Opera Safari
Support basique (Oui) 4.0 (2.0) [1] 9.0 (Oui) (Oui)
Caractéristiques Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Support basique (Oui) 4.0 (2.0) [1] (Oui) (Oui) (Oui)

[1] Le paramètre titre a seulement été créé dans Firefox 23.

Voir aussi

Étiquettes et contributeurs liés au document

 Contributeurs à cette page : SphinxKnight, tazzcoco
 Dernière mise à jour par : SphinxKnight,