Skip to content

Commit e44156d

Browse files
authored
Merge pull request #40 from Ooggle/master
Translate of "Browser environment, specs" in french
2 parents 3bddfba + 1b1f7e2 commit e44156d

File tree

1 file changed

+48
-48
lines changed

1 file changed

+48
-48
lines changed
Lines changed: 48 additions & 48 deletions
Original file line numberDiff line numberDiff line change
@@ -1,111 +1,111 @@
1-
# Browser environment, specs
1+
# L'environnement du navigateur, spécifications
22

3-
The JavaScript language was initially created for web browsers. Since then, it has evolved and become a language with many uses and platforms.
3+
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.
44

5-
A platform may be a browser, or a web-server, or a washing machine, or another *host*. Each of them provides platform-specific functionality. The JavaScript specification calls that a *host environment*.
5+
Une plateforme peut être un navigateur, un serveur web, ou une machine à laver, ou un autre *hôte*. Chacuns d'entre eux proposent des fonctionnalités spécifiques à leur plateforme. La spécification JavaScript appelle cela un *environnement hôte*.
66

7-
A host environment provides platform-specific objects and functions additional to the language core. Web browsers give a means to control web pages. Node.js provides server-side features, and so on.
7+
Un environnement hôte propose des objets et fonctions spécifiques à la plateforme en plus du noyau du langage. Les navigateurs web donnent la possibilité de contrôler les pages web. Node.js fournit des fonctionnalités côté serveur, etc.
88

9-
Here's a bird's-eye view of what we have when JavaScript runs in a web-browser:
9+
Voici une vue globale de ce que nous avons lorsque JavaScript s'exécute dans un navigateur Web :
1010

1111
![](windowObjects.png)
1212

13-
There's a "root" object called `window`. It has two roles:
13+
Il existe un objet "racine" appelé `window`. Il a 2 rôles :
1414

15-
1. First, it is a global object for JavaScript code, as described in the chapter <info:global-object>.
16-
2. Second, it represents the "browser window" and provides methods to control it.
15+
1. Premièrement, c'est un objet global pour le code JavaScript, comme décrit dans le chapitre <info:global-object>.
16+
2. Deuxièmement, il représente la "fenêtre du navigateur" et fournit des méthodes pour la contrôler.
1717

18-
For instance, here we use it as a global object:
18+
Par exemple, nous l'utilisons ici comme un objet global :
1919

2020
```js run
2121
function sayHi() {
2222
alert("Hello");
2323
}
2424

25-
// global functions are accessible as properties of window
25+
// les fonctions globales sont accessibles comment étant des propriétés de la fenêtre
2626
window.sayHi();
2727
```
2828

29-
And here we use it as a browser window, to see the window height:
29+
Et nous l'utilisons ici comme une fenêtre du navigateur pour voir la hauteur de la fenêtre :
3030

3131
```js run
32-
alert(window.innerHeight); // inner window height
32+
alert(window.innerHeight); // hauteur de la fenêtre intérieure
3333
```
3434

35-
There are more window-specific methods and properties, we'll cover them later.
35+
Il y a d'autres méthodes et propriétés spécifiques à la fenêtre, nous les étudierons plus tard.
3636

3737
## DOM (Document Object Model)
3838

39-
The `document` object gives access to the page content. We can change or create anything on the page using it.
39+
l'objet `document` donne accès au contenu de la page. On peut changer ou créer n'importe quoi sur la page en l'utilisant.
4040

41-
For instance:
41+
Par exemple :
4242
```js run
43-
// change the background color to red
43+
// change la couleur de fond en rouge
4444
document.body.style.background = "red";
4545

46-
// change it back after 1 second
46+
// réinitialisation après 1 seconde
4747
setTimeout(() => document.body.style.background = "", 1000);
4848
```
4949

50-
Here we used `document.body.style`, but there's much, much more. Properties and methods are described in the specification:
50+
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 :
5151

52-
- **DOM Living Standard** at <https://dom.spec.whatwg.org>
52+
- **DOM Living Standard** à <https://dom.spec.whatwg.org>
5353

54-
```smart header="DOM is not only for browsers"
55-
The DOM specification explains the structure of a document and provides objects to manipulate it. There are non-browser instruments that use it too.
54+
```smart header="le DOM n'est pas seulement pour les navigateurs"
55+
La spécification DOM décrit la structure d'un document et fournit des objets pour la manipuler. Il y a des instruments autres que des navigateurs qui l'utilisent aussi.
5656
57-
For instance, server-side tools that download HTML pages and process them use the DOM. They may support only a part of the specification though.
57+
Par exemple, Les outils côté serveur qui télécharge des pages HTML et les traitent utilisent le DOM. Bien qu'ils peuvent ne supporter qu'une partie de la spécification.
5858
```
5959

60-
```smart header="CSSOM for styling"
61-
CSS rules and stylesheets are not structured like HTML. There's a separate specification [CSSOM](https://www.w3.org/TR/cssom-1/) that explains how they are represented as objects, and how to read and write them.
60+
```smart header="le CSSOM pour gérer le style"
61+
Les règles CSS et les feuilles de style ne sont pas structurées comme le HTML. Il y a une spécification séparée [CSSOM](https://www.w3.org/TR/cssom-1/) qui explique comment ils sont représentés comme étant des objets, et comment lire et écrire dessus.
6262
63-
CSSOM is used together with DOM when we modify style rules for the document. In practice though, CSSOM is rarely required, because usually CSS rules are static. We rarely need to add/remove CSS rules from JavaScript, so we won't cover it right now.
63+
Le CSSOM est utilisé en parallèle avec le DOM lorsque l'on modifie des règles de style pour le document. Cependant, il est rarement requis en pratique car les règles CSS sont généralement statiques. Nous avons rarement besoin d'ajouter/supprimer des règles depuis JavaScript, nous n'allons donc pas nous concentrer là-dessus pour l'instant.
6464
```
6565

6666
## BOM (Browser object model)
6767

68-
Browser Object Model (BOM) are additional objects provided by the browser (host environment) to work with everything except the document.
68+
Le modèle d'objet du navigateur (BOM en anglais) contient des objets supplémentaire fourni par le navigateur (l'environnement hôte) pour travailler avec tout à l'exception du document.
6969

70-
For instance:
70+
Par exemple :
7171

72-
- 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 differ between Windows/Linux/Mac etc).
73-
- The [location](mdn:api/Window/location) object allows us to read the current URL and can redirect the browser to a new one.
72+
- 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).
73+
- L'objet [location](mdn:api/Window/location) nous permet de lire l'URL courante et peut rediriger le navigateur vers une nouvelle adresse.
7474

75-
Here's how we can use the `location` object:
75+
Voici comment l'on peut utiliser l'objet `location` :
7676

7777
```js run
78-
alert(location.href); // shows current URL
78+
alert(location.href); // affiche l'URL courante
7979
if (confirm("Go to wikipedia?")) {
80-
location.href = "https://wikipedia.org"; // redirect the browser to another URL
80+
location.href = "https://wikipedia.org"; // redirige le navigateur vers une autre adresse
8181
}
8282
```
8383

84-
Functions `alert/confirm/prompt` are also a part of BOM: they are directly not related to the document, but represent pure browser methods of communicating with the user.
84+
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.
8585

86-
BOM is the part of the general [HTML specification](https://html.spec.whatwg.org).
86+
le BOM fait partie de la [spécification HTML](https://html.spec.whatwg.org) générale.
8787

88-
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>.
88+
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>.
8989

90-
## Summary
90+
## Résumé
9191

92-
Talking about standards, we have:
92+
Quand on parle de normes, nous avons :
9393

94-
DOM specification
95-
: Describes the document structure, manipulations and events, see <https://dom.spec.whatwg.org>.
94+
La spécification DOM
95+
: Décrit la structure du document, ses manipulations et événements, voir <https://dom.spec.whatwg.org>.
9696

97-
CSSOM specification
98-
: Describes stylesheets and style rules, manipulations with them and their binding to documents, see <https://www.w3.org/TR/cssom-1/>.
97+
La spécification CSSOM
98+
: 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/>.
9999

100-
HTML specification
101-
: Describes the HTML language (e.g. tags) and also the BOM (browser object model) -- various browser functions: `setTimeout`, `alert`, `location` and so on, see <https://html.spec.whatwg.org>. It takes the DOM specification and extends it with many additional properties and methods.
100+
Spécification HTML
101+
: 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.
102102

103-
Additionally, some classes are described separately at <https://spec.whatwg.org/>.
103+
De plus, certaines classes sont décrites séparément sur <https://spec.whatwg.org/>.
104104

105-
Please note these links, as there's so much stuff to learn it's impossible to cover and remember everything.
105+
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.
106106

107-
When you'd like to read about a property or a method, the Mozilla manual at <https://developer.mozilla.org/en-US/search> 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.
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 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.
108108

109-
To find something, it's often convenient to use an internet search "WHATWG [term]" or "MDN [term]", e.g <https://google.com?q=whatwg+localstorage>, <https://google.com?q=mdn+localstorage>.
109+
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>.
110110

111-
Now we'll get down to learning DOM, because the document plays the central role in the UI.
111+
Nous allons maintenant nous pencher sur le DOM, car le document joue un rôle essentiel dans l'interface utilisateur (UI).

0 commit comments

Comments
 (0)