From 8dd167021bd48ef8404e0d0c6f3e63b298bb3dc5 Mon Sep 17 00:00:00 2001 From: SphinxKnight Date: Sun, 9 May 2021 20:24:55 +0200 Subject: Fixes #797 (#802) * Update to par w/ en-US 13360cb - fixes #797 * FIX: Fix h id * UPDT: Fix h id, and update bcd, replace jsxref Co-authored-by: tristantheb --- .../reference/statements/block/index.html | 136 ++++++++------------- .../reference/statements/if...else/index.html | 111 ++++++----------- 2 files changed, 88 insertions(+), 159 deletions(-) diff --git a/files/fr/web/javascript/reference/statements/block/index.html b/files/fr/web/javascript/reference/statements/block/index.html index a367f69678..74780b7415 100644 --- a/files/fr/web/javascript/reference/statements/block/index.html +++ b/files/fr/web/javascript/reference/statements/block/index.html @@ -2,52 +2,53 @@ title: bloc slug: Web/JavaScript/Reference/Statements/block tags: - - Instruction - JavaScript + - Language feature - Reference + - Statement +browser-compat: javascript.statements.block translation_of: Web/JavaScript/Reference/Statements/block original_slug: Web/JavaScript/Reference/Instructions/bloc ---
{{jsSidebar("Statements")}}
-

Une instruction de bloc est utilisée afin de grouper zéro ou plusieurs instructions. Le bloc est délimité par une paire d'accolades. On peut éventuellement « étiqueter » un bloc avec un label.

+

Une instruction de bloc est utilisée afin de grouper zéro ou plusieurs instructions. Le bloc est délimité par une paire d'accolades. On peut éventuellement « étiqueter » un bloc avec un label.

-
{{EmbedInteractiveExample("pages/js/statement-block.html")}}
+
{{EmbedInteractiveExample("pages/js/statement-block.html", "taller")}}
- +

Syntaxe

-

Syntaxe

- -

Instruction de bloc

+

Instruction de bloc

{
-  instruction_1;
-  instruction_2;
+  instruction_1;
+  instruction_2;
   ...
-  instruction_n;
+  instruction_n;
 }
 
-

Instruction de bloc étiquetée

+

Instruction de bloc étiquetée

// ou, avec une étiquette :
-label {
-  instruction_1;
-  instruction_2;
-  instruction_n;
+label: {
+  instruction_1;
+  instruction_2;
+  ...
+  instruction_n;
 }
 
-
instruction_1, instruction_2, instruction_n
-
Les instructions qu'on souhaite regrouper au sein du bloc.
-
label {{optional_inline}}
-
Une étiquette qui permet une identification visuelle de la cible d'une instruction break.
+
instruction_1, instruction_2, instruction_n
+
Les instructions qu'on souhaite regrouper au sein du bloc.
+
label {{optional_inline}}
+
Une étiquette qui permet une identification visuelle de la cible d'une instruction break.
-

Description

+

Description

-

Cette instruction est le plus souvent utilisée avec les instructions de contrôle (ex. {{jsxref("Instructions/if...else")}}, {{jsxref("Instructions/for")}}, {{jsxref("Instructions/while")}}). On verra ainsi :

+

Cette instruction est le plus souvent utilisée avec les instructions de contrôle (ex. if…else, for, while). On verra ainsi :

while (x < 10) {
   x++;
@@ -56,94 +57,61 @@ label {
 
 

On peut voir dans cet exemple que cette instruction se termine sans point-virgule.

-

L'instruction de bloc est souvent appelée instruction composée (compound statement) dans d'autres langages. En effet, elle permet d'utiliser plusieurs instructions là où JavaScript n'attend qu'une instruction. C'est une pratique courante que de combiner plusieurs instructions grâce aux blocs. À l'opposé, on peut utiliser une {{jsxref("Instructions/vide","instruction vide","",1)}} pour ne rien faire là où JavaScript attend une instruction.

+

L'instruction de bloc est souvent appelée instruction composée (compound statement) dans d'autres langages. En effet, elle permet d'utiliser plusieurs instructions là où JavaScript n'attend qu'une instruction. C'est une pratique courante que de combiner plusieurs instructions grâce aux blocs. À l'opposé, on peut utiliser une instruction vide pour ne rien faire là où JavaScript attend une instruction.

-

Gestion des portées

+

Exemples

-

Avec var

+

Règles de portée pour var ou les déclarations de fonction en mode non-strict

-

Important : Le bloc n'introduit aucune portée pour les variables déclarées avec var ou pour les déclarations de fonction. Les variables introduites dans un bloc font partie de la portée de la fonction ou du script, elles persisteront donc en dehors du bloc. Autrement dit, aucune portée n'est introduite par les blocs. Bien qu'il soit tout à fait possible d'utiliser des blocs hors de tout contexte, il est fortement déconseillé de coder de cette façon. En effet, les blocs ne se comportent pas comme d'autres langages tels que C ou Java et il pourrait être surprenant de lire un tel code. Par exemple :

+

Les variables déclarées avec var ou créées avec une déclaration de fonction en mode non-strict n'ont pas une portée limitée au bloc. Les variables introduites dans un bloc auront la portée de la fonction ou du script englobant ce bloc. Les variables pourront alors être utilisées en dehors du bloc. Autrement dit, une instruction de bloc n'introduit pas une portée :

var x = 1;
 {
   var x = 2;
 }
-console.log(x); // affiche 2
+console.log(x); // affiche 2 dans la console
 
-

Cela affiche 2 dans la console car l'instruction var x au sein du bloc partage la même portée que l'instruction var x précédente en dehors du bloc. Un code C ou Java équivalent aurait produit 1.

+

On voit 2 dans la console, car l'instruction var x contenue dans le bloc appartient à la même portée que l'instruction var x située avant le bloc.

+ +

En mode non-strict, les déclarations de fonction à l'intérieur des blocs peuvent se comporter étrangement, il est déconseillé de les utiliser.

-

Avec let et const

+

Règles de portée pour let, const ou les déclarations de fonction en mode strict

-

En revanche, les identifiants déclarés avec let et const appartiennent à la portée du bloc : 

+

En revanche, les identifiants déclarés avec let et const possèdent une portée limitée au bloc :

let x = 1;
 {
   let x = 2;
 }
-console.log(x); // affiche 1
-
+console.log(x); // affiche 1 dans la console
-

On voit ici que l'instruction x = 2 est limitée à la portée du bloc dans laquelle elle est présente.

+

L'instruction x = 2 est limitée à la portée du bloc dans laquelle elle est présente.

-

On a le même résultat avec const.

+

Il en va de même pour const:

const c = 1;
 {
   const c = 2;
 }
-console.log(c); // affiche 1, il n'y a pas de SyntaxError
-
+console.log(c); // affiche 1, ne déclenche pas de SyntaxError + +

L'instruction const c = 2 ne déclenche pas SyntaxError: Identifier 'c' has already been declared, car cet identifiant est bien unique pour ce bloc.

+ +

En mode strict, à partir de ES2015, les fonctions à l'intérieur des blocs ont une portée qui correspond à ce bloc. Avant ES2015, les fonctions de bloc étaient interdites.

+ +

Spécifications

+ +

{{Specifications}}

+ +

Compatibilité des navigateurs

+ +

{{Compat}}

-

On notera que l'instruction const c = 2 ne lève pas d'exception SyntaxError car on a une seule déclaration de c pour ce bloc.

- -

Spécifications

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
SpécificationÉtatCommentaires
{{SpecName('ESDraft', '#sec-block', 'instruction de bloc')}}{{Spec2('ESDraft')}}
{{SpecName('ES6', '#sec-block', 'instruction de bloc')}}{{Spec2('ES6')}}
{{SpecName('ES5.1', '#sec-12.1', 'instruction de bloc')}}{{Spec2('ES5.1')}}
{{SpecName('ES3', '#sec-12.1', 'instruction de bloc')}}{{Spec2('ES3')}}
{{SpecName('ES1', '#sec-12.1', 'instruction de bloc')}}{{Spec2('ES1')}}Définition initiale. Implémentée avec JavaScript 1.0.
- -

Compatibilité des navigateurs

- - - -

{{Compat("javascript.statements.block")}}

- -

Voir aussi

+

Voir aussi

    -
  • {{jsxref("Instructions/while", "while")}}
  • -
  • {{jsxref("Instructions/if...else", "if...else")}}
  • -
  • {{jsxref("Instructions/let", "let")}}
  • +
  • while
  • +
  • if...else
  • +
  • let
diff --git a/files/fr/web/javascript/reference/statements/if...else/index.html b/files/fr/web/javascript/reference/statements/if...else/index.html index 9cb7b1e91c..6dc22f9c1d 100644 --- a/files/fr/web/javascript/reference/statements/if...else/index.html +++ b/files/fr/web/javascript/reference/statements/if...else/index.html @@ -5,6 +5,7 @@ tags: - JavaScript - Reference - Statement +browser-compat: javascript.statements.if_else translation_of: Web/JavaScript/Reference/Statements/if...else original_slug: Web/JavaScript/Reference/Instructions/if...else --- @@ -19,31 +20,31 @@ original_slug: Web/JavaScript/Reference/Instructions/if...else

Syntaxe

if (condition)
-   instruction1
-[else
-   instruction2]
-
+ statement1 +} else { + statement2 +}
-
condition
-
Une expression qui est évaluée à true ou false.
+
condition
+
Une expression qui est évaluée à true ou false.
-
instruction1
-
L'instruction qui est exécutée si la condition est vérifiée (i.e. est évaluée à true). Cette instruction peut être n'importe quelle instruction valide, y compris une imbrication d'autres instructions if. Pour exécuter plusieurs instructions, on pourra utiliser un {{jsxref("Instructions/bloc","bloc d'instructions","",1)}} ({ ... }) qui permet de les regrouper. Pour n'exécuter aucune instruction, on pourra utiliser {{jsxref("Instructions/Vide","l'instruction vide","",1)}}.
+
statement1
+
L'instruction qui est exécutée si la condition est vérifiée (i.e. est évaluée à true). Cette instruction peut être n'importe quelle instruction valide, y compris une imbrication d'autres instructions if. Pour exécuter plusieurs instructions, on pourra utiliser un bloc d'instructions ({ ... }) qui permet de les regrouper. Pour n'exécuter aucune instruction, on pourra utiliser l'instruction vide.
-
instruction2
-
Si la clause else existe, l'instruction qui est exécutée si la condition est évaluée à false. Comme pour la première, cette instruction peut être n'importe quelle instruction valide : une autre instruction if imbriquée, un bloc d'instruction, une instruction vide, etc.
+
statement2
+
Si la clause else existe, l'instruction qui est exécutée si la condition est évaluée à false. Comme pour la première, cette instruction peut être n'importe quelle instruction valide : une autre instruction if imbriquée, un bloc d'instruction, une instruction vide, etc.
-

Description

+

Description

Plusieurs instructions if...else peuvent être imbriquées afin de créer une structure else if (on notera qu'il n'y a pas de mot-clé elseif en JavaScript).

-
if (condition1)
+
if (condition1)
   instruction1
 else if (condition2)
   instruction2
@@ -56,7 +57,7 @@ else
 
 

Si on indente correctement le code, on retrouve la structure exactement équivalente :

-
if (condition1)
+
if (condition1)
   instruction1
 else
   if (condition2)
@@ -66,34 +67,33 @@ else
 ...
 
-

Afin d'exécuter plusieurs instructions, on utilisera un {{jsxref("Instructions/bloc","bloc d'instructions","",1)}} ({ ... }) pour regrouper les instructions souhaitées. Utiliser les blocs d'instructions est une bonne façon d'organiser son code, surtout lorsque celui-ci comporte des instructions conditionnelles imbriquées.

+

Afin d'exécuter plusieurs instructions, on utilisera un {{jsxref("Statements/block","bloc d'instructions","",1)}} ({ ... }) pour regrouper les instructions souhaitées. Utiliser les blocs d'instructions est une bonne façon d'organiser son code, surtout lorsque celui-ci comporte des instructions conditionnelles imbriquées.

-
if (condition) {
+
if (condition) {
   instructions1
 } else {
   instructions2
 }
 
-

Attention à ne pas confondre les valeurs booléennes « primitives » true et false avec les valeurs true et false d'un objet {{jsxref("Boolean")}}. Toute valeur qui n'est pas false, {{jsxref("undefined")}}, {{jsxref("null")}}, 0, -0, {{jsxref("NaN")}} ou la chaîne vide (""), et tout objet, y compris un objet Boolean dont la valeur est false, seront évalués à true lors d'une instruction conditionnelle if. Ainsi :

+

Attention à ne pas confondre les valeurs booléennes « primitives » true et false avec les valeurs true et false d'un objet Boolean. Toute valeur qui n'est pas false, undefined, null, 0, -0, NaN ou la chaîne vide (""), et tout objet, y compris un objet Boolean dont la valeur est false, seront évalués à true lors d'une instruction conditionnelle if. Ainsi :

var b = new Boolean(false);
 if (b) // la condition sera évaluée à true
 
-

Exemples

+

Exemples

-

Utiliser if...else

+

Utiliser if...else

if (cipher_char == from_char) {
   result = result + to_char;
   x++;
 } else {
   result = result + clear_char;
-}
-
+}
-

Utiliser else if

+

Utiliser else if

Bien qu'il n'y ait pas de mot-clé elseif dans le langage JavaScript, il est possible d'imbriquer des instructions if...else à la suite les une des autres en plaçant un espace entre else et le début de l'instruction if imbriquée :

@@ -103,17 +103,15 @@ if (b) // la condition sera évaluée à true // faire autre chose } else { // faire encore autre chose -} -
+}
-

Affectation de variable dans l'expression conditionnelle

+

Affectation de variable dans l'expression conditionnelle

Il est conseillé de ne pas utiliser d'affectation au sein des expressions conditionnelles. En effet, l'affectation peut être confondue avec un test d'égalité lorsqu'on analyse le code. Il ne faut donc pas utiliser le code suivant (bien qu'il fonctionne) :

if (x = y) {
   /* exécuter les instructions */
-}
-
+}

S'il est nécessaire d'effectuer une telle affectation, une pratique courante consiste à ajouter des parenthèses de cette manière afin d'alerter le lecteur du code (exemple à utiliser) :

@@ -121,55 +119,18 @@ if (b) // la condition sera évaluée à true /* exécuter les instructions */ } -

Spécifications

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
SpécificationÉtatCommentaires
{{SpecName('ESDraft', '#sec-if-statement', 'instruction if')}}{{Spec2('ESDraft')}} 
{{SpecName('ES6', '#sec-if-statement', 'instruction if')}}{{Spec2('ES6')}} 
{{SpecName('ES5.1', '#sec-12.5', 'instruction if')}}{{Spec2('ES5.1')}} 
{{SpecName('ES3', '#sec-12.5', 'instruction if')}}{{Spec2('ES3')}} 
{{SpecName('ES1', '#sec-12.5', 'instruction if')}}{{Spec2('ES1')}}Définition initiale
- -

Compatibilité des navigateurs

- - - -

{{Compat("javascript.statements.if_else")}}

- -

Voir aussi

+

Spécifications

+ +{{Specifications}} + +

Compatibilité des navigateurs

+ +

{{Compat}}

+ +

Voir aussi

    -
  • {{jsxref("Instructions/bloc", "bloc")}}
  • -
  • {{jsxref("Instructions/switch", "switch")}}
  • -
  • {{jsxref("Opérateurs/L_opérateur_conditionnel", "L'opérateur conditionnel","",1)}}
  • +
  • block
  • +
  • switch
  • +
  • L'opérateur conditionnel
-- cgit v1.2.3-54-g00ecf