diff options
Diffstat (limited to 'files/fr/web/api/document/createdocumentfragment/index.md')
| -rw-r--r-- | files/fr/web/api/document/createdocumentfragment/index.md | 75 |
1 files changed, 31 insertions, 44 deletions
diff --git a/files/fr/web/api/document/createdocumentfragment/index.md b/files/fr/web/api/document/createdocumentfragment/index.md index 629d26ed27..d4bf794671 100644 --- a/files/fr/web/api/document/createdocumentfragment/index.md +++ b/files/fr/web/api/document/createdocumentfragment/index.md @@ -10,35 +10,37 @@ tags: - Reference translation_of: Web/API/Document/createDocumentFragment --- -<div>{{ApiRef("DOM")}}</div> +{{ApiRef("DOM")}} -<p>Crée un nouvel objet vide de type {{domxref("DocumentFragment")}}.</p> +Crée un nouvel objet vide de type {{domxref("DocumentFragment")}}. -<h2 id="Syntax">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox">var <var>fragment</var> = document.createDocumentFragment(); -</pre> + var fragment = document.createDocumentFragment(); -<p><code>fragment</code> est une référence vers un objet vide de type {{domxref("DocumentFragment")}} .</p> +`fragment` est une référence vers un objet vide de type {{domxref("DocumentFragment")}} . -<h2 id="Description">Description</h2> +## Description -<p>Les objets <code>DocumentFragments</code> sont analogues à des nœuds du DOM, mais ne font jamais partie de l'arbre DOM. Le cas d'usage le plus courant consiste à créer un fragment pour y stocker des éléments, puis à ajouter en une seule opération le fragment à l'arbre DOM, ce qui a pour effet de le remplacer par tous ses éléments enfants.</p> +Les objets `DocumentFragments` sont analogues à des nœuds du DOM, mais ne font jamais partie de l'arbre DOM. Le cas d'usage le plus courant consiste à créer un fragment pour y stocker des éléments, puis à ajouter en une seule opération le fragment à l'arbre DOM, ce qui a pour effet de le remplacer par tous ses éléments enfants. -<p>Le principal avantage de cette méthode de mise à jour du DOM vient du fait que le fragment est stocké en mémoire, et pas dans l'arbre DOM lui-même, de sorte que le modifier ne déclenche pas de <a href="http://code.google.com/speed/articles/reflow.html">reflow</a> (le calcul des positions et de la géométrie de chacun des éléments de la page affichée). Par conséquent, l´utilisation de fragments pour effectuer des mises à jour du DOM donne souvent lieu à une <a href="http://ejohn.org/blog/dom-documentfragments/">amélioration des performance</a>s.</p> +Le principal avantage de cette méthode de mise à jour du DOM vient du fait que le fragment est stocké en mémoire, et pas dans l'arbre DOM lui-même, de sorte que le modifier ne déclenche pas de [reflow](http://code.google.com/speed/articles/reflow.html) (le calcul des positions et de la géométrie de chacun des éléments de la page affichée). Par conséquent, l´utilisation de fragments pour effectuer des mises à jour du DOM donne souvent lieu à une [amélioration des performance](http://ejohn.org/blog/dom-documentfragments/)s. -<h2 id="Example">Exemple</h2> +## Exemple -<p>Cet exemple crée une liste des principaux navigateurs du web.</p> +Cet exemple crée une liste des principaux navigateurs du web. -<h3 id="HTML">HTML</h3> +### HTML -<pre class="brush: html"><ul id="ul"> -</ul></pre> +```html +<ul id="ul"> +</ul> +``` -<h3 id="JavaScript">JavaScript</h3> +### JavaScript -<pre class="brush: js">var element = document.getElementById('ul'); // en supposant qu'ul existe +```js +var element = document.getElementById('ul'); // en supposant qu'ul existe var fragment = document.createDocumentFragment(); var browsers = ['Firefox', 'Chrome', 'Opera', 'Safari', 'Internet Explorer']; @@ -49,39 +51,24 @@ browsers.forEach(function(browser) { fragment.appendChild(li); }); -element.appendChild(fragment);</pre> +element.appendChild(fragment); +``` -<h3 id="Résultat">Résultat</h3> +### Résultat -<p>{{EmbedLiveSample("Example", 600, 140)}}</p> +{{EmbedLiveSample("Example", 600, 140)}} -<h2 id="Spécification">Spécification</h2> +## Spécification -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Spécification</th> - <th scope="col">Statut</th> - <th scope="col">Commentaire</th> - </tr> - </thead> - <tbody> - <tr> - <td>{{SpecName('DOM WHATWG', '#dom-document-createdocumentfragment', 'Document.createDocumentFragment()')}}</td> - <td>{{Spec2('DOM WHATWG')}}</td> - <td>Définition initiale dans la spécification DOM 1.</td> - </tr> - </tbody> -</table> +| Spécification | Statut | Commentaire | +| ---------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------- | ------------------------------------------------ | +| {{SpecName('DOM WHATWG', '#dom-document-createdocumentfragment', 'Document.createDocumentFragment()')}} | {{Spec2('DOM WHATWG')}} | Définition initiale dans la spécification DOM 1. | -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> +## Compatibilité des navigateurs -<p>{{Compat("api.Document.createDocumentFragment")}}</p> +{{Compat("api.Document.createDocumentFragment")}} -<h2 id="Voir_aussi">Voir aussi</h2> -</div> +## Voir aussi -<ul> - <li>{{domxref("DOMImplementation.createDocument", "document.implementation.createDocument()")}}</li> - <li>{{domxref("documentFragment")}}</li> -</ul> +- {{domxref("DOMImplementation.createDocument", "document.implementation.createDocument()")}} +- {{domxref("documentFragment")}} |