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

text	jQuery
JavaScript	Version 1.0+

Syntaxe

.text();	1.0+
.text(contenu);	1.0+
.text(function(index,contenucourant));	1.4+

Paramètres

Nom	Description
contenu	Ce paramètre permet d'indiquer le nouveau contenu dans les éléments sélectionnés.
function(index,contenucourant)	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 la combinaison de texte combiné pour chaque élément dans un ensemble d'éléments correspondant, incluant leurs descendants.

Remarques

Contrairement à la méthode .html(), .text() peut être utilisé dans les documents XML et HTML. Le résultat de la méthode .text() est une chaîne de caractères contenant le texte combiné de tous les éléments correspondants. (En raison des variations des analyseurs HTML dans différents navigateurs Web, le texte renvoyé peut varier dans les nouvelles lignes et autres espaces blancs.)
La méthode .text() ne peut pas être utilisée sur les entrées de formulaire ou les scripts. Pour définir ou obtenir la valeur de texte des éléments d'entrée ou de zone de texte, utilisez la méthode .val(). Pour obtenir la valeur d'un élément de script, utilisez la méthode .html().
Depuis la version 1.4 de jQuery, la méthode .text() renvoie la valeur des noeuds texte et CDATA ainsi que des noeuds élément.

Exemples

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').text());

</script>

</body>

</html>

on obtiendra le résultat suivant :

ABC Moncontenu :ABC

L'exemple suivant permet de remplacer les chiffres en lettres écrits dans des balises OPTION d'un SELECT de HTML :



<!DOCTYPE html>

<html>

<head><meta name="viewport" content="width=device-width, initial-scale=1" />

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

</head>

<body>

<select>

     <option>Un</option>

     <option>Deux</option>

     <option>Trois</option>

     <option>Quatre</option>

     <option>Cinq</option>

     <option>Six</option>

     <option>Sept</option>

</select>

<script>

jQuery(document).ready(function() {

  jQuery('select option:contains("Un")').text("Premier");

  jQuery('select option:contains("Deux")').text("Deuxième");

  jQuery('select option:contains("Trois")').text("Troisième");

  jQuery('select option:contains("Quatre")').text("Quatrième");

  jQuery('select option:contains("Cinq")').text("Cinquième");

  jQuery('select option:contains("Six")').text("Sixième");

  jQuery('select option:contains("Sept")').text("Septième");

});

</script>

</body>

</html>

on obtiendra le résultat suivant :

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

Section courante

A propos

Section administrative du site

text

Syntaxe

Paramètres

Description

Remarques

Exemples