jQuery.parseHTML()Méthode

jQuery 杂项方法Méthodes diverses jQuery

Exemple

Utilisez une chaîne HTML pour créer un tableau de nœuds DOM et l'insérer dans une div.

<div id="log"> <h3>Contenu:</h3> </div> <script> $(function () { var $log = $( "#log" ), str = "bonjour, <b>mon nom est</b> jQuery.", html = $.parseHTML( str ), nodeNames = []; //Ajouter le HTML analysé $log.append( html ); //Collecter les noms des nœuds du HTML analysé $.each( html, function( i, el ) { nodeNames[i] = "<li>" + el.nodeName + "</li>"; }); //Insérer les noms des nœuds $log.append( "<h3>Noms des nœuds :</h3>" ); $( "<ol></ol>" ) .append( nodeNames.join( "" ) ) .appendTo( $log ); }) </script>

Essayez-le vous-même »

Définition et utilisation

La fonction $.parseHTML() est utilisée pour analyser une chaîne HTML en un tableau de nœuds DOM correspondants.

Remarque :1. Cette fonction utilisera la fonction native de création d'éléments DOM pour convertir une chaîne HTML en une collection d'éléments DOM, et vous pouvez insérer ces éléments DOM dans le document.
2. Si le paramètre context n'est pas spécifié, ou s'il est null ou undefined, il prend par défaut le document actuel. Si les éléments DOM créés sont destinés à un autre document, tel qu'un iframe, vous devez spécifier l'objet document de cet iframe.
Considérations de sécurité :La plupart des API jQuery permettent aux chaînes HTML d'inclure des scripts exécutables dans le HTML. jQuery.parseHTML() n'exécute pas les scripts dans le HTML analysé, sauf si vous définissez explicitement le paramètre keepScripts sur true. Cependant, la plupart des environnements peuvent encore exécuter des scripts indirectement, par exemple, viaattributs. Les appelants doivent éviter de le faire, et nettoyer ou échapper toute entrée non fiable provenant de sources telles que les URL, les cookies, etc., afin d'éviter que cette situation ne se produise. Pour une compatibilité future, lorsque le paramètre keepScripts est omis ou false, les appelants ne doivent pas compter sur une quelconque capacité à exécuter le contenu d'un script.


Syntaxe

$.parseHTML( htmlString [, context ] [, keepScripts ] )

Parameters Description
htmlString Type String - La chaîne HTML à analyser et à convertir en un tableau de nœuds DOM.
context Type Element - Spécifie le Document dans lequel créer les éléments, par défaut l'objet document du document actuel.
keepScripts Type Boolean - Spécifie si la chaîne HTML transmise contient des scripts, false par défaut.


jQuery 杂项方法Méthodes diverses jQuery

Autres extensions