Skip to content

Commit 4ecfd73

Browse files
EnnorielRomain Crestey
authored andcommitted
Add glossary entries (#34)
* Add glossary entries * fix: add links --------- Co-authored-by: Romain Crestey <[email protected]>
1 parent 0f4d8fa commit 4ecfd73

File tree

3 files changed

+65
-5
lines changed

3 files changed

+65
-5
lines changed

documentation/docs/07-glossary/02-web.md

Lines changed: 13 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -26,11 +26,13 @@ Les transformations classiques effectuées lors d'un _bundling_ sont :
2626
2727
## Client-side rendering
2828

29-
>> Bientôt
29+
> Bientôt
3030
3131
## DOM
3232

33-
> Bientôt...
33+
Le _Document Object Model_ (DOM) est la représentation objet d'un document HTML chargé dans le navigateur web. Cette représentation du document permet de le voir comme un groupe structuré de nœuds et d'objets possédant différentes propriétés et méthodes. On parle souvent d'"arbre DOM".
34+
35+
Le DOM relie les pages web aux scripts, fichiers de styles, ressources externes ou langages de programmation. Il peut être manipulé à l'aide du JavaScript.
3436

3537
## Framework
3638

@@ -66,7 +68,15 @@ Les transformations classiques effectuées lors d'un _bundling_ sont :
6668
6769
## Server-side rendering
6870

69-
> Bientôt...
71+
Le rendu côté serveur, ou _server-side rendering_ (SSR) est l'action de générer une page web avec tout ou partie des données métier directement sur le serveur. Il est à mettre en opposition avec le <span class='vo'>[rendu côté client](#client-side-rendering)</span>, ou _client-side rendering_, où les pages viennent charger la logique dans un premier temps et les données métiers avec des requêtes supplémentaires, ce qui implique de construire une grande partie de la page dans le navigateur.
72+
73+
Le SSR a pour avantages :
74+
75+
- une exécution plus rapide car nécessitant moins de requêtes
76+
- le fait de pouvoir générer l'entièreté d'une page à la première requête, ce qui permet d'afficher une page même si JavaScript n'est pas disponible côté client
77+
- bénéficie d'un meilleur référencement SEO, car les balises de référencement sont générées côté serveur et disponibles pour les outils d'indexation
78+
79+
SvelteKit propose le SSR par défaut, qui peut être désactivé au cas par cas.
7080

7181
## Web component
7282

documentation/docs/07-glossary/03-javascript.md

Lines changed: 24 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -98,7 +98,30 @@ Plus d'infos sur les valeurs _truthy_ sur [le site de MDN](https://developer.moz
9898

9999
## Inline
100100

101-
> Bientôt...
101+
L'adjectif _inline_ désigne le fait de définir du style, une condition, une fonction ou un composant sur une seule ligne. Toutes ces fonctionnalités ne sont pas permises nativement en Javascript. Certaines sont apportées par les frameworks de développement, comme Svelte.
102+
103+
Exemples :
104+
105+
```ts
106+
// @noErrors
107+
// fonction inline
108+
const saluer = (nom: string) => console.log(`Salut ${nom} !`)
109+
110+
function saluer(nom: string) {
111+
// condition inline
112+
if (!nom) return;
113+
114+
// traitement
115+
}
116+
```
117+
118+
```svelte
119+
<!-- style inline en HTML ou en Svelte -->
120+
<div style="margin: 8px;"/>
121+
122+
<!-- autre manière d'écrire du style inline en Svelte -->
123+
<div style:margin="8px"/>
124+
```
102125

103126
## Nullish
104127

documentation/docs/07-glossary/04-sveltejs.md

Lines changed: 28 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,34 @@ Ces mots n'ont pas de réelle traduction en français, ou alors celle-ci n'est q
1010
1111
## Binding
1212

13-
> Bientôt...
13+
Le _binding_ est le mécanisme par lequel une valeur d'un input est automatiquement copiée dans une variable :
14+
15+
```svelte
16+
<!-- ici, la valeur est initialisée avec la variable name
17+
mais la variable ne sera pas mise à jour automatiquement avec la saisie de l'utilisateur -->
18+
<input value={name}>
19+
20+
<!-- dans ce cas, la valeur est initialisée avec la variable name
21+
et la variable sera automatiquement mise à jour avec la saisie de l'utilisateur -->
22+
<input bind:value={name}>
23+
24+
<!-- écriture plus concise du binding dans le cas ou la variable porte le même nom que la propriété bindée -->
25+
<input bind:value>
26+
```
27+
28+
De la même manière, il est possible de _binder_ des propriétés d'un composant :
29+
30+
```svelte
31+
<script>
32+
import { Commande } from './Commande.svelte';
33+
34+
let articles;
35+
</script>
36+
37+
<Commande bind:articles={articles}>
38+
```
39+
40+
Il est également possible de _binder_ des propriétés de certains éléments du <span class='vo'>[DOM](/docs/web#dom)</span> (les éléments de type bloc, les images, les vidéo, window via `svelte:window` et document via `svelte:document`).
1441

1542
## Hook
1643

0 commit comments

Comments
 (0)