Skip to content

Add more glossary entries #42

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 2 commits into from
Jul 29, 2023
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion documentation/docs/05-misc/01-faq.md
Original file line number Diff line number Diff line change
Expand Up @@ -30,7 +30,7 @@ Vous pouvez utiliser Prettier avec le <span class="vo">[plugin](/docs/developmen

## Comment documenter mes composants ?

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.
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.

```svelte
<script>
Expand Down
6 changes: 6 additions & 0 deletions documentation/docs/07-glossary/02-web.md
Original file line number Diff line number Diff line change
Expand Up @@ -50,6 +50,12 @@ Le DOM relie les pages web aux scripts, fichiers de styles, ressources externes

> Bientôt...

## Language Server

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).

Plus d'infos sur le [site de la documentation du LSP](https://microsoft.github.io/language-server-protocol/).

## Lazy loading

> Bientôt...
Expand Down
19 changes: 16 additions & 3 deletions documentation/docs/07-glossary/03-javascript.md
Original file line number Diff line number Diff line change
Expand Up @@ -98,7 +98,17 @@ Plus d'infos sur les valeurs _truthy_ sur [le site de MDN](https://developer.moz

## Generic

> Bientôt...
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é :

```typescript
function identity<Type>(arg: Type): Type {
return arg;
}
```

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.

Plus d'infos sur les [generics sur le site TypeScript](https://www.typescriptlang.org/docs/handbook/2/generics.html).

## Inline

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

## Polyfill

> Bientôt...
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.

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

## Shadow DOM

> Bientôt...
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.

Plus d'infos sur le [shadow DOM sur le site MDN](https://developer.mozilla.org/fr/docs/Web/API/Web_components/Using_shadow_DOM).
32 changes: 23 additions & 9 deletions documentation/docs/07-glossary/04-sveltejs.md
Original file line number Diff line number Diff line change
Expand Up @@ -39,28 +39,42 @@ De la même manière, il est possible de _binder_ des propriétés d'un composan

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

## Hook
## Props

> Bientôt...
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 :

## Props
```sv
<script>
export let value;
</script>
```

> Bientôt...
Elles sont passées au composant de la même manière qu'un attribut HTML :

```svelte
<Widget value="salut" />
```

Plus d'infos sur les [props dans la documentation](/docs/basic-markup#attributs-et-props).

> Le concept de props est exactement le même en Svelte qu'en React, Vue ou Solid.

## Slot

> Bientôt...
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`.

Plus d'infos sur [les slots dans la documentation](/docs/special-elements#slot).

## Store

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.

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

## Svelte Language Server
## Tick

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

## Tick
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.

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