Langage de programmation - JavaScript - Références des bibliothèques et cadres d'application - jQuery

html	jQuery
JavaScript	Version 1.0+

Syntaxe

.html();	1.0+
.html(htmlString);	1.0+
.html(function(index, oldhtml));	1.4+

Paramètres

Nom	Description
htmlString	Ce paramètre permet d'indiquer le nouveau contenu dans les éléments sélectionnés.
function(index, oldhtml)	Ce paramètre optionnel permet d'indiquer une fonction retournant le nouveau contenu pour les éléments sélectionnés.

Description

Cette méthode permet de demander le contenu HTML du premier élément dans l'ensemble d'élément correspondant.

Remarques

Cette méthode n'est pas disponible sur les documents XML.
Cette méthode est l'équivalente d'une propriété «innerHTML» de JavaScript et de ce fait contient les mêmes bogues que celle-ci. Ainsi, par exemple sous IE8 le paramètre «href» des balises «a» sont tous convertis en lien absolue.
Lorsque vous lisez le contenu et que vous avez de multiple contenu avec le même identificateur ou sélecteur, seul le premier trouvé sera retourné.
Lorsque vous modifier le contenu, tous le contenu présent est complètement remplacer par le nouveau spécifié.
Si vous souhaitez uniquement fixer ou retourner le texte du contenu, vous devriez plutôt envisager d'utiliser la méthode «text()».
De par sa conception, tout constructeur ou méthode jQuery acceptant une chaîne de caractères HTML - jQuery(), .append(), .after(),... - peut potentiellement exécuter du code. Cette situation peut se produire en injectant des balises de script ou en utilisant des attributs HTML exécutant du code (par exemple, <img onload="">). N'utilisez pas ces méthodes pour insérer des chaînes de caractères obtenues à partir de sources non fiables telles que les paramètres de requête d'URL, les Cookies ou les entrées de formulaire. Cela peut introduire des vulnérabilités de cross-site-scripting (XSS). Supprimer ou enlever toute entrée utilisateur avant d'ajouter du contenu au document.

Exemples

L'exemple suivant permet de remplacer les lettres «ABC» par les lettres «DEF» et les mettras en caractères gras également :



<!DOCTYPE html>

<html>

<head>

     <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.5/jquery.min.js"></script>

</head>

<body>

<div id="moncontenu">ABC</div>

<script>

$('#moncontenu').html("<b>DEF</b>");

</script>

</body>

</html>

on obtiendra le résultat suivant :

DEF

L'exemple suivant permet de lire le contenu de la balise «moncontenu» et de le retourner :



<!DOCTYPE html>

<html>

<head>

     <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.5/jquery.min.js"></script>

</head>

<body>

<div id="moncontenu">ABC</div>

<script>

document.write('Moncontenu :', $('#moncontenu').html());

</script>

</body>

</html>

on obtiendra le résultat suivant :

ABC Moncontenu :ABC

Dernière mise à jour : Dimanche, le 1 mars 2015

Section courante

A propos

Section administrative du site

html

Syntaxe

Paramètres

Description

Remarques

Exemples