@ -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 <spanclass="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 <spanclass="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.
@ -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 <spanclass="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/).
@ -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
@ -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 <spanclass='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).
@ -39,17 +39,31 @@ 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 <spanclass='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
<Widgetvalue="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
@ -57,10 +71,10 @@ Un _store_ est un concept au sein de Svelte qui permet de stocker une valeur, et
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).