Skip to content

Commit 8516a7c

Browse files
Ennorielbleucitron
andcommitted
Add more glossary entries (#42)
* Add more glossary entries * Apply suggestions from code review --------- Co-authored-by: Romain l'Ourson <[email protected]>
1 parent caab514 commit 8516a7c

File tree

4 files changed

+46
-13
lines changed

4 files changed

+46
-13
lines changed

documentation/docs/05-misc/01-faq.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -30,7 +30,7 @@ Vous pouvez utiliser Prettier avec le <span class="vo">[plugin](/docs/developmen
3030

3131
## Comment documenter mes composants ?
3232

33-
Dans les éditeurs qui utilisent le <span class="vo">[Svelte Language Server](/docs/sveltejs#svelte-language-server)</span> vous pouvez documenter les composants, fonctions et exports à l'aide de commentaires spécialement formatés.
33+
Dans les éditeurs qui utilisent le <span class="vo">[Language Server](/docs/web#language-server)</span> Svelte ([svelte-language-server](https://www.npmjs.com/package/svelte-language-server)), vous pouvez documenter les composants, fonctions et exports à l'aide de commentaires spécialement formatés.
3434

3535
```svelte
3636
<script>

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

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -50,6 +50,12 @@ Le DOM relie les pages web aux scripts, fichiers de styles, ressources externes
5050

5151
> Bientôt...
5252
53+
## Language Server
54+
55+
Un _language server_ est un algorithme exécuté par un <span class="vo">[IDE](/docs/development#ide)</span>. Il permet d’exécuter les aides au développement (autocomplétion, accès rapide, liste des utilisations, etc.) adaptées à un langage de programmation. L'interface entre l'IDE et le _language server_ est défini par un protocole, le _Language Server Protocol_ (LSP).
56+
57+
Plus d'infos sur le [site de la documentation du LSP](https://microsoft.github.io/language-server-protocol/).
58+
5359
## Lazy loading
5460

5561
> Bientôt...

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

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

9999
## Generic
100100

101-
> Bientôt...
101+
Un _generic_ est une notion en TypeScript qui permet de définir une variable au sein d'un type. Il a pour fonctionnalité première de permettre de propager un type au sein d'une méthode lorsque le type est variable. L'exemple le plus simple est la fonction identité :
102+
103+
```typescript
104+
function identity<Type>(arg: Type): Type {
105+
return arg;
106+
}
107+
```
108+
109+
Dans ce cas précis, le paramètre `arg` pourra être de n'importe quel type, représenté par le _generic_ `Type`. Le retour de la méthode aura le même type que le paramètre.
110+
111+
Plus d'infos sur les [generics sur le site TypeScript](https://www.typescriptlang.org/docs/handbook/2/generics.html).
102112

103113
## Inline
104114

@@ -137,9 +147,12 @@ Pour en savoir plus sur la différence entre `null` et `undefined`, vous pouvez
137147

138148
## Polyfill
139149

140-
> Bientôt...
150+
Un _polyfill_ est un bout de code (généralement en JavaScript sur le web) utilisé pour fournir des fonctionnalités récentes sur d'anciens navigateurs qui ne les supportent pas nativement.
141151

152+
Plus d'infos sur les [polyfills sur le site MDN](https://developer.mozilla.org/fr/docs/Glossary/Polyfill).
142153

143154
## Shadow DOM
144155

145-
> Bientôt...
156+
Un _shadow DOM_ (ou DOM fantôme) est un <span class='vo'>[DOM](/docs/web#dom)</span> dans le DOM. Il est monté via la méthode `element.attachShadow()` et a pour particularité d'être encapsulé, c'est-à-dire que sa structure de balisage est isolée, que son style est isolé et que son comportement est caché et séparé du reste de code de la page.
157+
158+
Plus d'infos sur le [shadow DOM sur le site MDN](https://developer.mozilla.org/fr/docs/Web/API/Web_components/Using_shadow_DOM).

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

Lines changed: 23 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -39,28 +39,42 @@ De la même manière, il est possible de _binder_ des propriétés d'un composan
3939

4040
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`).
4141

42-
## Hook
42+
## Props
4343

44-
> Bientôt...
44+
Les _props_ ou propriétés sont les valeurs passées aux composants. Les props sont définies avec le mot clé `export` au sein du `script` des composants :
4545

46-
## Props
46+
```sv
47+
<script>
48+
export let value;
49+
</script>
50+
```
4751

48-
> Bientôt...
52+
Elles sont passées au composant de la même manière qu'un attribut HTML :
53+
54+
```svelte
55+
<Widget value="salut" />
56+
```
57+
58+
Plus d'infos sur les [props dans la documentation](/docs/basic-markup#attributs-et-props).
59+
60+
> Le concept de props est exactement le même en Svelte qu'en React, Vue ou Solid.
4961
5062
## Slot
5163

52-
> Bientôt...
64+
Un _slot_ correspond au contenu enfant d'un composant. Il est possible d'y accéder dans le markup via `<slot>` ou dans le bloc `script` via la variable globale `$$slots`.
65+
66+
Plus d'infos sur [les slots dans la documentation](/docs/special-elements#slot).
5367

5468
## Store
5569

5670
Un _store_ est un concept au sein de Svelte qui permet de stocker une valeur, et de notifier n'importe quel module au sein de l'application de ses changements de valeur.
5771

5872
Plus d'infos sur [les stores Svelte dans la documentation](/docs/svelte-store).
5973

60-
## Svelte Language Server
74+
## Tick
6175

62-
> Bientôt...
76+
De manière générale, un _tick_ peut faire référence à une période de temps unitaire.
6377

64-
## Tick
78+
Dans le cadre de Svelte, la méthode _tick_ définit est une promesse qui se résout une fois que tous les changements d'état en attente ont été appliqués, ou dans la micro-tâche suivante s'il n'y en a pas.
6579

66-
> Bientôt...
80+
Plus d'infos sur [les ticks Svelte dans la documentation](/docs/svelte#tick).

0 commit comments

Comments
 (0)