DOMImplementation.createHTMLDocument()

Baseline Large disponibilité

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 2015.

Expérimental: Il s'agit d'une technologie expérimentale.
Vérifiez attentivement le tableau de compatibilité des navigateurs avant de l'utiliser en production.

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

Dans cet article

Syntaxe

newDoc = document.implementation.createHTMLDocument(titre);

Paramètres

title Facultatif (excepté dans IE)

C'est une 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 courant.

Ci-dessous, le code HTML pour cet exemple:

html
<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():

js
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 lignes 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, est créé 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 récupère le contentDocument (contenu du document) du cadre ; c'est le document dans lequel nous allons injecter le nouveau contenu. Les deux lignes suivantes permettent d'importer le contenu du nouveau document dans le nouveau contexte du document. Pour finir, la ligne 20 remplace le contenu du cadre par le contenu du nouveau document.

Voir l'exemple sur une page

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

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

L'interface DOMImplementation.

Aider à améliorer MDN

Cette page vous a-t-elle été utile ?

Oui Non

Apprendre à contribuer

Cette page a été modifiée le 17 déc. 2024 par les contributeur·ice·s du MDN.

Voir cette page sur GitHub • Signaler un problème avec ce contenu

Référence du DOM
DOMImplementation
Méthodes d'instance
Pages liées à DOM
Guides
1. Anatomy of the DOM
2. Réflexion des attributs
3. Sélection et parcours de l'arbre DOM
4. Construire et mettre à jour l'arbre DOM
5. Travailler avec des évènements

DOMImplementation.createHTMLDocument()

Dans cet article

Syntaxe

Paramètres

Exemple

Spécifications

Compatibilité des navigateurs

Voir aussi

Aider à améliorer MDN