Skip to content

Commit b0c4d20

Browse files
committed
Conflicts fixed on "Browser environment, specs" page in french language
1 parent 34eec4d commit b0c4d20

File tree

1 file changed

+2
-72
lines changed

1 file changed

+2
-72
lines changed
Lines changed: 2 additions & 72 deletions
Original file line numberDiff line numberDiff line change
@@ -1,18 +1,10 @@
11
# L'environnement du navigateur, spécifications
22

3-
<<<<<<< HEAD
43
Le langage JavaScript a été initialement créé pour les navigateurs web. Dès lors, il a évolué et est devenu un langage aux multiples utilisations et plateformes.
54

6-
Une plate-forme peut être un navigateur, un serveur Web ou un autre *hôte*, voire une machine à café dite "intelligente". Chacun d'eux fournit des fonctionnalités spécifiques à la plate-forme. La spécification JavaScript appelle cela un *environnement hôte*.
5+
Une plate-forme peut être un navigateur, ou un serveur Web ou un autre *hôte*, ou même une machine à café "intelligente" si elle peut exécuter JavaScript. Chacun d'entre eux fournit des fonctionnalités spécifiques à la plate-forme. La spécification JavaScript appelle cela un *environnement hôte*.
76

87
Un environnement hôte fournit ses propres objets et fonctions en plus du noyau du langage. Les navigateurs Web permettent de contrôler les pages Web. Node.js fournit des fonctionnalités côté serveur, etc.
9-
=======
10-
The JavaScript language was initially created for web browsers. Since then, it has evolved into a language with many uses and platforms.
11-
12-
A platform may be a browser, or a web-server or another *host*, or even a "smart" coffee machine if it can run JavaScript. Each of these provides platform-specific functionality. The JavaScript specification calls that a *host environment*.
13-
14-
A host environment provides its own objects and functions in addition to the language core. Web browsers give a means to control web pages. Node.js provides server-side features, and so on.
15-
>>>>>>> bf7d8bb1af3b416d393af1c15b03cb1352da1f9c
168

179
Voici une vue globale de ce que nous avons lorsque JavaScript s'exécute dans un navigateur Web :
1810

@@ -23,11 +15,7 @@ Il existe un objet "racine" appelé `window`. Il a 2 rôles :
2315
1. Premièrement, c'est un objet global pour le code JavaScript, comme décrit dans le chapitre <info:global-object>.
2416
2. Deuxièmement, il représente la "fenêtre du navigateur" et fournit des méthodes pour la contrôler.
2517

26-
<<<<<<< HEAD
2718
Par exemple, nous l'utilisons ici comme un objet global :
28-
=======
29-
For instance, we can use it as a global object:
30-
>>>>>>> bf7d8bb1af3b416d393af1c15b03cb1352da1f9c
3119

3220
```js run global
3321
function sayHi() {
@@ -38,29 +26,17 @@ function sayHi() {
3826
window.sayHi();
3927
```
4028

41-
<<<<<<< HEAD
4229
Et nous l'utilisons ici comme une fenêtre du navigateur pour voir la hauteur de la fenêtre :
43-
=======
44-
And we can use it as a browser window, to show the window height:
45-
>>>>>>> bf7d8bb1af3b416d393af1c15b03cb1352da1f9c
4630

4731
```js run
4832
alert(window.innerHeight); // hauteur de la fenêtre intérieure
4933
```
5034

51-
<<<<<<< HEAD
5235
Il y a d'autres méthodes et propriétés spécifiques à la fenêtre, nous les étudierons plus tard.
5336

5437
## DOM (Document Object Model)
5538

5639
Document Object Model, ou DOM en abrégé, représente tout le contenu de la page sous forme d'objets pouvant être modifiés.
57-
=======
58-
There are more window-specific methods and properties, which we'll cover later.
59-
60-
## DOM (Document Object Model)
61-
62-
The Document Object Model, or DOM for short, represents all page content as objects that can be modified.
63-
>>>>>>> bf7d8bb1af3b416d393af1c15b03cb1352da1f9c
6440

6541
L'objet `document` est le "point d'entrée" principal de la page. Nous pouvons changer ou créer n'importe quoi sur la page en l'utilisant.
6642

@@ -73,30 +49,16 @@ document.body.style.background = "red";
7349
setTimeout(() => document.body.style.background = "", 1000);
7450
```
7551

76-
<<<<<<< HEAD
77-
Ici on a utilisé `document.body.style`, mais il y a bien plus encore. Les propriétés et les méthodes sont décrites dans la spécification : [DOM Living Standard](https://dom.spec.whatwg.org).
78-
=======
79-
Here, we used `document.body.style`, but there's much, much more. Properties and methods are described in the specification: [DOM Living Standard](https://dom.spec.whatwg.org).
80-
>>>>>>> bf7d8bb1af3b416d393af1c15b03cb1352da1f9c
81-
8252
```smart header="DOM n'est pas seulement pour les navigateurs"
8353
La spécification DOM explique la structure d'un document et fournit des objets pour le manipuler. Il existe également des instruments autres que les navigateurs qui utilisent DOM.
8454
85-
<<<<<<< HEAD
8655
Par exemple, les scripts côté serveur qui téléchargent des pages HTML et les traitent peuvent également utiliser le DOM. Ils peuvent cependant ne supporter qu'une partie de la spécification.
87-
=======
88-
For instance, server-side scripts that download HTML pages and process them can also use the DOM. They may support only a part of the specification though.
89-
>>>>>>> bf7d8bb1af3b416d393af1c15b03cb1352da1f9c
9056
```
9157

9258
```smart header="CSSOM pour le style"
9359
Il existe également une spécification distincte, [Modèle d'objet CSS (CSSOM)](https://www.w3.org/TR/cssom-1/) pour les règles CSS et les feuilles de style, qui explique comment elles sont représentées en tant qu'objets et comment les lire et les écrire.
9460
95-
<<<<<<< HEAD
9661
CSSOM est utilisé avec DOM lorsque nous modifions les règles de style du document. En pratique cependant, CSSOM est rarement nécessaire, car nous avons rarement besoin de modifier les règles CSS à partir de JavaScript (généralement, nous ajoutons / supprimons simplement des classes CSS, pas de modifier leurs règles CSS), mais c'est également possible.
97-
=======
98-
The CSSOM is used together with the DOM when we modify style rules for the document. In practice though, the CSSOM is rarely required, because we rarely need to modify CSS rules from JavaScript (usually we just add/remove CSS classes, not modify their CSS rules), but that's also possible.
99-
>>>>>>> bf7d8bb1af3b416d393af1c15b03cb1352da1f9c
10062
```
10163

10264
## BOM (Browser Object Model)
@@ -105,13 +67,8 @@ Le modèle d'objet du navigateur (BOM en anglais) contient des objets supplémen
10567

10668
Par exemple :
10769

108-
<<<<<<< HEAD
10970
- L'objet [navigator](mdn:api/Window/navigator) fournit des informations contextuelles à propos du navigateur et du système d'exploitation. Il y a beaucoup de propriétés mais les deux plus connues sont : `navigator.userAgent` -- qui donne des informations sur le navigateur actuel, et `navigator.platform` sur la plateforme (peut permettre de faire la différence entre Windows/Linux/Mac etc).
11071
- L'objet [location](mdn:api/Window/location) nous permet de lire l'URL courante et peut rediriger le navigateur vers une nouvelle adresse.
111-
=======
112-
- The [navigator](mdn:api/Window/navigator) object provides background information about the browser and the operating system. There are many properties, but the two most widely known are: `navigator.userAgent` -- about the current browser, and `navigator.platform` -- about the platform (can help to differentiate between Windows/Linux/Mac etc).
113-
- The [location](mdn:api/Window/location) object allows us to read the current URL and can redirect the browser to a new one.
114-
>>>>>>> bf7d8bb1af3b416d393af1c15b03cb1352da1f9c
11572

11673
Voici comment l'on peut utiliser l'objet `location` :
11774

@@ -122,60 +79,33 @@ if (confirm("Go to Wikipedia?")) {
12279
}
12380
```
12481

125-
<<<<<<< HEAD
12682
Les fonctions `alert/confirm/prompt` font aussi partie du BOM : elles ne sont pas directement liées au document, mais représentent des méthodes du navigateur de communication pure avec l'utilisateur.
12783

12884
```smart header="Specifications"
12985
le BOM fait partie de la [spécification HTML](https://html.spec.whatwg.org) générale.
13086
13187
Oui, vous avez bien entendu. La spécification HTML disponible à l'adresse <https://html.spec.whatwg.org> ne parle pas seulement du "langage HTML" (balises, attributs), mais couvre également un tas d'objets, de méthodes et d'extensions DOM spécifiques au navigateur. C'est l'"HTML de manière générale". En outre, certaines parties ont des spécifications supplémentaires listées ici : <https://spec.whatwg.org>.
132-
=======
133-
The functions `alert/confirm/prompt` are also a part of the BOM: they are not directly related to the document, but represent pure browser methods for communicating with the user.
134-
135-
```smart header="Specifications"
136-
The BOM is a part of the general [HTML specification](https://html.spec.whatwg.org).
137-
138-
Yes, you heard that right. The HTML spec at <https://html.spec.whatwg.org> is not only about the "HTML language" (tags, attributes), but also covers a bunch of objects, methods, and browser-specific DOM extensions. That's "HTML in broad terms". Also, some parts have additional specs listed at <https://spec.whatwg.org>.
139-
>>>>>>> bf7d8bb1af3b416d393af1c15b03cb1352da1f9c
14088
```
14189

14290
## Résumé
14391

14492
Quand on parle de normes, nous avons :
14593

146-
<<<<<<< HEAD
14794
La spécification DOM
14895
: Décrit la structure du document, ses manipulations et événements, voir <https://dom.spec.whatwg.org>.
14996

15097
La spécification CSSOM
15198
: Décrit les feuilles de style et les régles de style, les manipulations de style les impliquant et leur liaisons aux documents, voir <https://www.w3.org/TR/cssom-1/>.
152-
=======
153-
DOM specification
154-
: Describes the document structure, manipulations, and events, see <https://dom.spec.whatwg.org>.
155-
156-
CSSOM specification
157-
: Describes stylesheets and style rules, manipulations with them, and their binding to documents, see <https://www.w3.org/TR/cssom-1/>.
158-
>>>>>>> bf7d8bb1af3b416d393af1c15b03cb1352da1f9c
15999

160100
Spécification HTML
161101
: Décrit le langage HTML (c'est à dire les balises) mais également le BOM (modèle d'objet du navigateur) -- diverses fonctions du navigateur : `setTimeout`, `alert`, `location` etc, voir <https://html.spec.whatwg.org>. Il récupère la spécification DOM et l'étend avec de nombreuses propriétés et méthodes additionnelles.
162102

163103
De plus, certaines classes sont décrites séparément sur <https://spec.whatwg.org/>.
164104

165-
<<<<<<< HEAD
166105
Souvenez vous de ces liens, il y a tellement de choses à apprendre qu'il est impossible de tout couvrir et de se souvenir de tout.
167106

168-
Lorsque vous souhaitez en apprendre plus sur une propriété ou une méthode, le manuel de Mozilla disponible sur <https://developer.mozilla.org/en-US/search> est également une bonne ressource, mais la définition correspondance peut-être meilleure dans le sens qu'elle est plus complexe et longue à lire, mais rendra vos connaissances fondamentales saines et complètes.
169-
=======
170-
Please note these links, as there's so much to learn that it's impossible to cover everything and remember it all.
171-
172-
When you'd like to read about a property or a method, the Mozilla manual at <https://developer.mozilla.org/en-US/> is also a nice resource, but the corresponding spec may be better: it's more complex and longer to read, but will make your fundamental knowledge sound and complete.
173-
>>>>>>> bf7d8bb1af3b416d393af1c15b03cb1352da1f9c
107+
Lorsque vous souhaitez en apprendre plus sur une propriété ou une méthode, le manuel de Mozilla disponible sur <https://developer.mozilla.org/en-US/search> est également une bonne ressource, mais la specification correspondante peut-être meilleure dans le sens qu'elle est plus complexe et longue à lire, mais rendra vos connaissances fondamentales saines et complètes.
174108

175109
Pour trouver quelque chose, il est souvent pratique de faire une simple recherche de "WHATWG [terme]" ou "MDN [terme]", par exemple <https://google.com?q=whatwg+localstorage>, <https://google.com?q=mdn+localstorage>.
176110

177-
<<<<<<< HEAD
178111
Nous allons maintenant nous pencher sur le DOM, car le document joue un rôle essentiel dans l'interface utilisateur (UI).
179-
=======
180-
Now, we'll get down to learning the DOM, because the document plays the central role in the UI.
181-
>>>>>>> bf7d8bb1af3b416d393af1c15b03cb1352da1f9c

0 commit comments

Comments
 (0)