Objet String


Cet objet est prédéfini dans le langage Javascript. Il représente une chaîne de caractères. Une chaîne de caractères peut être représentée par des apostrophes simples ou doubles, tel que: 'Texte' ou "Texte". Les chaînes de caractères peuvent être créées en utilisant le constructeur String().

Syntaxe

Pour créer un objet "string":

nomObjetString = new String(chaîneCaractères)

nomObjetString est le nom d'un nouvel objet "string".

Pour utiliser l'objet "string":

  1. nomString.nomPropriété
  2. nomString.nomMéthode(paramètres)

nomString est le nom d'une variable de type "string".

Propriétés

length		(>JavaScript1.0, JScript1.0)
prototype		(>JavaScript1.1)

Méthodes

anchor(attributNom)		(>JavaScript1.0, JScript1.0)
big()				(>JavaScript1.0, JScript1.0)
blink()				(>JavaScript1.0, JScript1.0)
bold()				(>JavaScript1.0, JScript1.0)
charAt(index)			(>JavaScript1.0, JScript1.0)
charCodeAt([index])		(>JavaScript1.2)
concat(string2)			(>JavaScript1.2)
fixed()				(>JavaScript1.0, JScript1.0)
fontcolor(couleur)		(>JavaScript1.0, JScript1.0)
fontsize(taille)		(>JavaScript1.0, JScript1.0)
fromCharCode(num1,num2,...,numn)(>JavaScript1.2)
indexOf(valeurCherche[,index])	(>JavaScript1.0, JScript1.0)
italics()			(>JavaScript1.0, JScript1.0)
lastIndexOf(valeurCherche[,index])	(>JavaScript1.0, JScript1.0)
link(url)			(>JavaScript1.0, JScript1.0)
match(expression)		(>JavaScript1.2)
replace(expression, nouvChaine)	(>JavaScript1.2)
search(expression)		(>JavaScript1.2)
slice(debutIndex[,finIndex])	(>JavaScript1.2)
small()				(>JavaScript1.0, JScript1.0)
split([separateur], [limite])	(>JavaScript1.2)
strike()			(>JavaScript1.0, JScript1.0)
sub()				(>JavaScript1.0, JScript1.0)
substr(debut[,taille])		(>JavaScript1.2)
substring(index1,index2)	(>JavaScript1.0, JScript1.0)
substring(index1[,index2])	(>JavaScript1.2)
sup()				(>JavaScript1.0, JScript1.0)
toLowerCase()			(>JavaScript1.0, JScript1.0)
toUpperCase()			(>JavaScript1.0, JScript1.0)

Événement

aucun (les objets prédéfinis ne possèdent jamais d'événements)

Exemple

<FORM><INPUT TYPE="button" VALUE="majuscule"
onClick="form.result.value = form.chaine.value.toUpperCase() ">
  <INPUT TYPE="text" NAME="chaine" VALUE=gilles SIZE=6>
  <INPUT TYPE="text" NAME="result" >
</FORM>


length

Cette propriété est un entier qui spécifie la longueur d'un objet ou d'un tableau. Utiliser en lecture seulement.
(représente la longueur de la chaîne de caractères)

La propriété "length" est utilisée pour spécifier:

Le nombre d'éléments d'un formulaire;
Le nombre de cadres dans un FRAMESET;
Le nombre d'entrées dans un objet "history";
Le nombre de boutons radio dans un objet "radio";
Le nombre d'options dans un objet "select";
La longueur d'un objet "string";
Le nombre de cadres dans une fenêtre parente;
Le nombre d'entrées dans l'une des propriétés d'un tableau.
Le nombre d'éléments dans un tableau.
Le nombre d'images dans un document.

Si la longueur est nulle, la valeur de "length" est zéro

Syntaxe

Lorsque utilisé avec un objet:

  1. nomFormulaire.length
  2. réfCadre.length
  3. history.length
  4. nomRadio.length
  5. nomSelect.length
  6. nomString.length
  7. RefFenêtre.length
  8. nomArray.length
  9. images.length
  10. navigator.plugins[index].length
  11. navigator.plugins[pluginName].length

Lorsque utilisé avec les propriétés d'un tableau :

  1. anchors.length
  2. elements.length
  3. forms.length
  4. réfCadre.frames.length
  5. RefFenêtre.frames.length
  6. links.length
  7. nomSelect.options.length

Objets

anchors, Array, elements, forms, frame, Image, history, links, Option, Plugin, radio, select, string, window

Exemple

<SCRIPT language="JavaScript1.1">
document.writeln("nombre d'entrées dans l'objet history :
"+history.length+"<BR>");
</SCRIPT>

prototype

Cette propriété définit une propriété qui est partagée par tous les objets d'un type spécifié. Il faut utiliser cette propriété pour ajouter des propriétés aux objets créés avec l'opérateur "new".
Permet d'ajouter une propriété à l'objet "string"

Syntaxe

typeObjet.prototype.nomPropriété = valeur

typeObjet est le nom d'un constructeur spécifié par le type de l'objet.
nomPropriété est le nom de la propriété qui devra être créée.
valeur est la valeur initiale de la propriété pour tous les objets du typeObjet spécifié.


anchor(attributNom)

Cette méthode crée un marqueur HTML qui est utilisé comme destination hypertexte. Il faut utiliser la méthode "anchor" avec les méthodes "write" ou "writeln" pour créer et afficher un marqueur dans votre document. Vous pouvez ainsi créer un marqueur avec la méthode "anchor" et ensuite l'afficher dans votre document avec les méthodes "write" ou "writeln".

Les marqueurs créés avec cette méthode deviennent des éléments dans un tableau de marqueurs. Voir l'objet "anchor" pour avoir de l'information sur le tableau des marqueurs.

Syntaxe

nomTexte.anchor(nomAttribut)

nomTexte peut être n'importe quelle chaîne de caractères ou une propriété d'un objet existant. nomTexte représente la chaîne de caractères qui sert de destination hypertexte.
nomAttribut peut être n'importe quelle chaîne de caractères ou une propriété d'un objet existant. nomAttribut représente l'attribut NAME dans la commande <A>.

Exemple

<SCRIPT language="JavaScript">
var description="UNGI !";
document.writeln(description.anchor("ungi"));
</SCRIPT>

big()

Cette méthode permet à une chaîne de caractères d'être affichée en gros, tout comme le marqueur <BIG>. Il faut l'utiliser avec les méthodes "write" ou "writeln" pour formater et afficher la chaîne de caractères dans le document.

Syntaxe

nomTexte.big()

Exemple

<SCRIPT language="JavaScript">
chaine = new String("je m'affiche !");
document.writeln("affichage normal :"+chaine+"<BR>");
document.writeln("affichage en gros BIG :"+chaine.big());
</SCRIPT>

blink()

Cette méthode permet à une chaîne de caractères de clignoter, tout comme le marqueur <BLINK>. Il faut l'utiliser avec les méthodes "write" ou "writeln" pour formater et afficher la chaîne de caractères dans le document.

Syntaxe

nomTexte.blink()

Exemple

<SCRIPT language="JavaScript">
chaine = new String("Attention, le clignotement est spécifique à netscape !");
document.writeln("affichage normal : "+chaine+"<BR>");
document.writeln("affichage en clignontant BLINK :
"+chaine.blink()+"<BR>");
</SCRIPT>

bold()

Cette méthode permet à une chaîne de caractères d'être affichés en gras, tout comme le marqueur <B>. Il faut l'utiliser avec les méthodes "write" ou "writeln" pour formater et afficher la chaîne de caractères dans le document.

Syntaxe

nomTexte.bold()

Exemple

<SCRIPT language="JavaScript">
chaine = new String("je m'affiche !");
document.writeln("affichage normal :"+chaine+"<BR>");
document.writeln("affichage en gras :"+chaine.bold());
</SCRIPT>

charAt(index)

Cette méthode retourne le caractère d'un index spécifié.

Syntaxe

nomTexte.charAt(index)

index peut être n'importe quel entier allant de 0 à la longueur en caractères de nomTexte -1 (nomTexte.length - 1), ou une propriété d'un objet existant.

Les caractères dans une chaîne de caractères sont classés de gauche à droite. L'index du premier caractère est 0 et l'index du dernier caractère est nomTexte.length - 1. Si la valeur de l'index dépasse cet intervalle, le Javascript retourne une chaîne de caractère vide.

Exemple

<FORM name="formulaire">
<INPUT type="text" name=saisie maxlength=40 size=40 value="entrez un texte">
<INPUT type="button" value="changer status" onClick="derCarStatus()">
</FORM>

<SCRIPT language="JavaScript1.1">
function derCarStatus()
{
	chaine = new String();
	chaine = document.formulaire.saisie.value;
	chaine = "le dernier caractère est : "+chaine.charAt(chaine.length - 1);
	window.status= chaine;
}
</SCRIPT>

charCodeAt([index])

Syntaxe

Exemple

concat(string2)

Syntaxe

Exemple

fixed()

Cette méthode permet à une chaîne de caractères d'être affichée dans une police de caractères fixes de type machine à écrire, tout comme le marqueur <TT>. Il faut l'utiliser avec les méthodes "write" ou "writeln" pour formater et afficher la chaîne de caractères dans le document.

Syntaxe

nomTexte.fixed()

Exemple

<SCRIPT language="JavaScript">
chaine = new String("je m'affiche !");
document.writeln("affichage normal :"+chaine+"<BR>");
document.writeln("affichage de type fixe :"+chaine.fixed());
</SCRIPT>

fontcolor(couleur)

Cette méthode permet à une chaîne de caractères d'être affichée dans la couleur spécifiée, tout comme le marqueur <FONT COLOR=uneCouleur>. Il faut l'utiliser avec les méthodes "write" ou "writeln" pour formater et afficher la chaîne de caractères dans le document.

Syntaxe

nomTexte.fontcolor(couleur)

couleur est une chaîne de caractères ou une propriété d'un objet existant, représentant la couleur en nombre hexadécimal.

Exemple

<SCRIPT language="JavaScript">
chaine = new String("chaine verte !");
document.write("la chaine est une "+chaine.fontcolor("00FF00"));
</SCRIPT>

fontsize(taille)

Cette méthode permet à une chaîne de caractères d'être affichée dans la dimension spécifiée, tout comme le marqueur <FONT SIZE=uneDimension>. Il faut l'utiliser avec les méthodes "write" ou "writeln" pour formater et afficher la chaîne de caractères dans le document.

Syntaxe

nomTexte.fontsize(uneDimension)

uneDimension est un entier entre 1 et 7 ou une chaîne de caractères représentant un entier ou une propriété d'un objet existant.

Exemple

<SCRIPT language="JavaScript">
chaine = new String("Ligne de taille variable.");
taille = 0;
for(i=0; i<chaine.length; i++) {
	taille++;
	if(taille==8)
		taille=0;
	//caract = 
	document.write(chaine.charAt(i).fontsize(taille));
}
</SCRIPT>

fromCharCode(num1,num2,...,numn)

Syntaxe

Exemple

indexOf(valeurCherche[,index])

Les caractères dans une chaîne de caractères sont classés de gauche à droite. L'index du premier caractère est zéro et celui du dernier caractère est nomTexte.length-1, c'est-à-dire la longueur du nom de la chaîne de caractères faisant l'appel moins 1.

La méthode "indexof" retourne l'index dans la chaîne de caractères de la première occurrence trouvée.

Si aucune valeur n'est spécifiée pour l'argument fromIndex, la valeur par défaut est zéro. Si l'argument ValeurRecherchée n'est pas retrouvé, le Javascript retournera -1.

Syntaxe

nomTexte.indexOf(ValeurRecherchée, [fromIndex])

ValeurRecherchée est un caractère ou une chaîne de caractères ou une propriété d'un objet existant, représentant la valeur recherchée.
fromIndex est la localisation indiquée dans la chaîne de caractères où la recherche commencera. fromIndex peut être n'importe quel entier allant de 0 à nomTexte.length-1 ou une propriété d'un objet existant.

Exemple

<FORM NAME="formulaire">
texte :
<BR><INPUT TYPE="text" NAME=saisie MAXLENGTH=40 SIZE=40 VALUE="entrez un texte">
<BR>Chaine à chercher :
<BR><INPUT TYPE="text" NAME=chaine MAXLENGTH=40 SIZE=40 VALUE="un">
<BR><INPUT TYPE="button" VALUE="chercher" onClick="recherche()">
<BR>Position de la chaine :<INPUT TYPE="text" NAME=position MAXLENGTH=4 SIZE=4>
</FORM>
<SCRIPT language="JavaScript">
function recherche()
{
	document.formulaire.position.value =
		escape(document.formulaire.saisie.value.indexOf(
			document.formulaire.chaine.value));
}
</SCRIPT>

italics()

Cette méthode permet à une chaîne de caractères d'être affichés en italique, tout comme le marqueur <I>. Il faut l'utiliser avec les méthodes "write" ou "writeln" pour formater et afficher la chaîne de caractères dans le document.

Syntaxe

nomTexte.italics()

Exemple

<SCRIPT language="JavaScript">
chaine = new String("je m'affiche !");
document.writeln("affichage normal :"+chaine+"<BR>");
document.writeln("affichage de type italique :"+chaine.italics());
</SCRIPT>

lastIndexOf(valeurCherche[,index])

Les caractères dans une chaîne de caractères sont classés de gauche à droite. L'index du premier caractère est zéro et celui du dernier caractère est nomTexte.length-1, c'est-à-dire la longueur du nom de la chaîne de caractères faisant l'appel moins 1.

La méthode "lastIndexOf" retourne l'index dans la chaîne de caractères de la dernière occurrence trouvée.

Si aucune valeur n'est spécifiée pour l'argument fromIndex, la valeur par défaut est zéro. Si l'argument ValeurRecherchée n'est pas retrouvé, le Javascript retournera -1.

Syntaxe

nomTexte.lastindexOf(ValeurRecherchée, [fromIndex] )

nomTexte peut être n'importe quelle chaîne de caractères ou une propriété d'un objet existant.
ValeurRecherchée est un caractère ou une chaîne de caractères ou une propriété d'un objet existant, représentant la valeur recherchée.
fromIndex est la localisation indiquée dans la chaîne de caractères où la recherche commencera. fromIndex peut être n'importe quel entier allant de 0 à nomTexte.length-1 ou une propriété d'un objet existant.

Exemple

<FORM NAME="formulaire">
texte :
<BR><INPUT TYPE="text" NAME=saisie MAXLENGTH=40 SIZE=40 VALUE="entrez un texte">
<BR>Chaine à chercher :
<BR><INPUT TYPE="text" NAME=chaine MAXLENGTH=40 SIZE=40 VALUE="e">
<BR><INPUT TYPE="button" VALUE="chercher" onClick="recherche()">
<BR>Position de la chaine :<INPUT TYPE="text" NAME=position MAXLENGTH=4 SIZE=4>
</FORM>
<SCRIPT language="JavaScript">
function recherche()
{
	document.formulaire.position.value =
		escape(document.formulaire.saisie.value.lastIndexOf(
			document.formulaire.chaine.value));
}
</SCRIPT>

link(url)

Cette méthode crée un lien hypertexte à un URL. Il faut l'utiliser avec les méthodes "write" ou "writeln" pour créer et afficher le lien hypertexte dans le document.

Les liens créés avec cette méthode deviennent des élément du tableau de liens. Voir l'objet "link" pour avoir des informations sur le tableau de liens.

Syntaxe

Lien.link(href)

Lien peut être n'importe quelle chaîne de caractères ou une propriété d'un objet existant. Lien représente le texte qui sera affiché dans votre page par le navigateur.
href peut être n'importe quelle chaîne de caractères ou une propriété d'un objet existant. href représente la valeur de l'attribut HREF de la commande <A>.

Exemple

<SCRIPT language="JavaScript">
ungi="un nouveau guide internet !";
URL="http://www.imaginet.fr/ime/";
document.write("Apprenez avec " + ungi.link(URL));
</SCRIPT>

match(expression)

Syntaxe

Exemple

replace(expression,nouvChaine)

Cette méthode charge un URL par-dessus la valeur courante de la liste mémoire du navigateur. C'est-à-dire, après l'utilisation de la méthode "replace", l'usager ne peut naviguer à l'URL précédent en utilisant le bouton "Back" du navigateur.

Syntaxe

location.replace("URL")

URL spécifie l'URL à charger.

Exemple

remplace l'URL actuelle par celle d'UNGI !
<FORM>
<INPUT TYPE="button" VALUE="remplacer URL"
	onClick="window.location.replace('http://www.imaginet.fr/ime/')">
</FORM>

search(expression)

Syntaxe

Exemple

slice(debutIndex[,finIndex])

Syntaxe

Exemple

small()

Cette méthode permet à une chaîne de caractères d'être affichés en petit, tout comme le marqueur <SMALL>. Il faut l'utiliser avec les méthodes "write" ou "writeln" pour formater et afficher la chaîne de caractères dans le document.

Syntaxe

nomTexte.small()

Exemple

<SCRIPT language="JavaScript">
chaine = new String("je m'affiche !");
document.writeln("affichage normal :"+chaine+"<BR>");
document.writeln("affichage en petite police :"+chaine.small());
</SCRIPT>

split([separateur],[limite])

Cette méthode sépare un objet "string" et retourne un tableau de chaîne de caractères.

Syntaxe

nomString.split([séparateur])

nomString est n'importe quelle chaîne de caractères ou une propriété d'un objet existant.
séparateur spécifie le caractère à utiliser pour séparer la chaîne de caractères. Si le séparateur n'est pas mentionné, le tableau retourné possède un élément consistant à la chaîne de caractères au complet.

Exemple

<FORM name=formulaire>
<BR><INPUT type="text" name=saisie value="entrez un texte à séparer"
	maxlength=60 size=60>
<BR><INPUT type="button" value=" convertir en tableau " size=10
	onClick="separe()");
<BR>
<BR><TEXTAREA name="resultat" rows=5 cols=40></TEXTAREA>
</FORM>
<SCRIPT language="JavaScript1.2">
tableau = new Array()
function separe()
{
	chaine = new String();
	tableau = document.formulaire.saisie.value.split(" ");
	for(i=0;i<tableau.length;i++) {
		chaine = chaine + "element["+i+"] = "+ tableau[i]+"\n";
	}
	document.formulaire.resultat.value = chaine;
}
</SCRIPT>

strike()

Cette méthode permet à une chaîne de caractères d'être barrés, tout comme le marqueur <STRIKE>. Il faut l'utiliser avec les méthodes "write" ou "writeln" pour formater et afficher la chaîne de caractères dans le document.

Syntaxe

nomTexte.strike()

Exemple

<SCRIPT language="JavaScript">
chaine = new String("je m'affiche !");
document.writeln("affichage normal :"+chaine+"<BR>");
document.writeln("affichage barré :"+chaine.strike());
</SCRIPT>

sub()

Cette méthode permet à une chaîne de caractères d'être affichés en indice (subscript), tout comme le marqueur <SUB>. Il faut l'utiliser avec les méthodes "write" ou "writeln" pour formater et afficher la chaîne de caractères dans le document.

Syntaxe

nomTexte.sub()

Exemple

<SCRIPT language="JavaScript">
chaine = new String("je m'affiche !");
document.writeln("affichage normal :"+chaine+"<BR>");
document.writeln("affichage en indice inférieur :"+chaine.sub());
</SCRIPT>

substr(debut[,taille])

Syntaxe

Exemple

substring(index1,index2)

Les caractères dans une chaîne de caractères sont classés de gauche à droite. L'index du premier caractère est zéro et celui du dernier caractère est nomTexte.length-1, c'est-à-dire la longueur du nom de la chaîne de caractères faisant l'appel moins 1.

La méthode "substring" retourne une partie d'un objet chaîne de caractères.

Syntaxe

nomTexte.substring(index1, index2)

index1 peut être n'importe quel entier entre 0 et nomTexte.length-1, ou une propriété d'un objet existant.
index2 peut être n'importe quel entier entre 0 et nomTexte.length-1, ou une propriété d'un objet existant.

Si index1 est plus petit que index2, la méthode "substring" retournera la partie qui commence avec l'index1 et qui se termine avec le caractère avant index2. Si index1 est plus grand que index2, la méthode "substring" retournera la partie qui commence avec l'index2 et qui se termine avec le caractère avant index1. Si index1 est plus égal à index2, la méthode "substring" retournera une chaîne de caractères vide.

Exemple

<FORM NAME="formulaire">
<INPUT TYPE="text" NAME="original" MAXLENGTH=40 SIZE=40 VALUE="texte à diviser">
<INPUT TYPE="button" VALUE="diviser" onClick="diviser()">
<BR>résultat :
<BR><INPUT TYPE="text" NAME="resultat" MAXLENGTH=40 SIZE=40 VALUE="">
</FORM>
<SCRIPT language="JavaScript">
function diviser()
{
	moitie = (document.formulaire.original.value.length)/2;
	document.formulaire.resultat.value =
	document.formulaire.original.value.substring(0,moitie);
}

sup()

Cette méthode permet à une chaîne de caractères d'être affichés en exposant (superscript), tout comme le marqueur <SUP>. Il faut l'utiliser avec les méthodes "write" ou "writeln" pour formater et afficher la chaîne de caractères dans le document.

Syntaxe

nomTexte.sup()

Exemple

<SCRIPT language="JavaScript">
	chaine = new String("je m'affiche !");
	document.writeln("affichage normal :"+chaine+"<BR>");
	document.writeln("affichage en indice supérieur :"+chaine.sup());
</SCRIPT>

toLowerCase()

Cette méthode retourne une chaîne de caractères (nomTexte) en caractères minuscules. Elle n'affecte pas la valeur de nomTexte.

Syntaxe

nomTexte.toLowerCase()

Exemple

<SCRIPT language="JavaScript">
chaine = new String("CeCi EsT uNe ChaiNe AveC MaJusCuLes ET miNUSCulEs !");
document.writeln("affichage normal :"+chaine+"<BR>");
document.writeln("affichage en minuscules :"+chaine.toLowerCase());
</SCRIPT>

toUpperCase()

Cette méthode retourne une chaîne de caractères (nomTexte) en caractères majuscules. Elle n'affecte pas la valeur de nomTexte.

Syntaxe

nomTexte.toUpperCase()

Exemple

<SCRIPT language="JavaScript">
chaine = new String("CeCi EsT uNe ChaiNe AveC MaJusCuLes ET miNUSCulEs !");
document.writeln("affichage normal :"+chaine+"<BR>");
document.writeln("affichage en minuscules :"+chaine.toUpperCase());
</SCRIPT>


Christophe Merlet
redfox@redfoxcenter.org
©Tous droits réservés 21 novembre 1998