F > for..in

for..in

Disponibilité

Flash Player 5.

Usage

for(itérantDeVariable in objet){
	instruction(s); 
}

Paramètres

itérantDeVariable Le nom d'une variable agissant comme itérant, référençant chaque propriété d'un objet ou chaque élément d'un tableau.

objet Le nom d'un objet devant être répété.

instruction(s) Une instruction à exécuter pour chaque itération.

Renvoie

Rien.

Description

Action ; effectue une boucle sur les propriétés d'un objet ou sur les éléments d'un tableau et exécute instruction pour chaque propriété d'un objet.

Certaines propriétés ne peuvent pas être énumérées par les actions for ou for..in. Par exemple, les méthodes intégrées de l'objet Array (Array.sort et Array.reverse) ne sont pas comprises dans l'énumération d'un objet Array, et les propriétés de clip telles que _x et _y ne sont pas énumérées.

La construction for..in itère sur les propriétés des objets dans la chaîne prototype de l'objet itéré. Si le prototype de l'enfant est parent, l'itération sur les propriétés de l'enfant avec for..in itérera également sur les propriétés de parent.

L'action for..in énumère tous les objets de la chaîne prototype d'un objet. Les propriétés de l'objet sont énumérées en premier, puis les propriétés de son prototype immédiat, puis les propriétés du prototype du prototype, et ainsi de suite. L'action for..in n'énumère pas deux fois le même nom de propriété. Si l'objet child a le prototype parent et que tous deux contiennent la propriété prop, l'action for..in appelée pour child énumère prop de child mais ignore celle de parent.

Exemple

L'exemple suivant utilise for..in pour itérer sur les propriétés d'un objet :

monObjet = { nom:'Tara', age:27, ville:'San Francisco' };
for (nom dans monObjet) {
	trace ("monObjet." + nom + " = " + monObjet[nom]);
}

Le résultat de cet exemple est le suivant :

monObjet.nom = Tara
monObjet.age = 27
monObjet.ville = San Francisco

L'exemple suivant utilise l'opérateur typeof avec for..in pour itérer sur un enfant particulier :

for (nom dans monClip) {
	if (typeof (monClip[nom]) = "clip") {
		trace ("J'ai un clip appelé " + nom);
	}
}

L'exemple suivant énumère les enfants d'un clip et envoie chacun dans l'image 2 de leurs scénarios respectifs. Le clip GroupeDeBoutonsRadio est un parent de plusieurs enfants, _BoutonRadioRouge_, _BoutonRadioVert_ et _BoutonRadioBleu.

for (nom de variable dans GroupeDeBoutonsRadio) {
	GroupeDeBoutonsRadio[nom].gotoAndStop(2);
}