From 57b94a23c7f85dde3269c382a1a9cae5afdf2941 Mon Sep 17 00:00:00 2001 From: SphinxKnight Date: Tue, 14 Nov 2023 09:35:10 +0100 Subject: [PATCH] `fr` - Glossary - Initial translation for B entries (#16933) * Initial translation for glossary B * FIX: Binding link flaws * FIX flaw and sentence meaning --------- Co-authored-by: tristantheb --- .../glossary/baseline/compatibility/index.md | 33 ++++++++++++ .../fr/glossary/baseline/typography/index.md | 17 +++++++ files/fr/glossary/binding/index.md | 22 ++++++++ files/fr/glossary/bitwise_flags/index.md | 50 +++++++++++++++++++ files/fr/glossary/boolean/aria/index.md | 16 ++++++ files/fr/glossary/boolean/html/index.md | 30 +++++++++++ files/fr/glossary/boolean/javascript/index.md | 17 +++++++ 7 files changed, 185 insertions(+) create mode 100644 files/fr/glossary/baseline/compatibility/index.md create mode 100644 files/fr/glossary/baseline/typography/index.md create mode 100644 files/fr/glossary/binding/index.md create mode 100644 files/fr/glossary/bitwise_flags/index.md create mode 100644 files/fr/glossary/boolean/aria/index.md create mode 100644 files/fr/glossary/boolean/html/index.md create mode 100644 files/fr/glossary/boolean/javascript/index.md diff --git a/files/fr/glossary/baseline/compatibility/index.md b/files/fr/glossary/baseline/compatibility/index.md new file mode 100644 index 00000000000000..9e1912d0108d1c --- /dev/null +++ b/files/fr/glossary/baseline/compatibility/index.md @@ -0,0 +1,33 @@ +--- +title: Baseline (compatibilité) +slug: Glossary/Baseline/Compatibility +l10n: + sourceCommit: 36527a8af0f396e8b84de3cda578d9e0fe1860f4 +--- + +{{GlossarySidebar}} + +**Baseline** identifie les fonctionnalités prises en charge par l'ensemble des navigateurs. Les développeuses et développeurs web peuvent partir du principe que les fonctionnalités Baseline fonctionnent sans problème dans les navigateurs récents. + +Une fonctionnalité Baseline, comme une API, un ensemble de propriétés CSS ou une syntaxce JavaScript, fonctionnera de façon homogène depuis au moins la version antérieure à la version actuelle pour l'ensemble des navigateurs connus (Chrome, Edge, Firefox, et Safari). + +## Badges + +🟢 Sur une page MDN, si vous voyez un bandeau Baseline vert, vous pouvez partir du principe que la fonctionnalité correspondante est implémentée dans la version actuelle et précédente des navigateurs. + +🟡 Si vous voyez un bandeau jaune indiquant que la fonctionnalité ne fait pas encore partie de Baseline, il vous faudra vérifier les données de compatibilité et tester la fonctionnalité. Vous pouvez également attendre qu'elle soit ajoutée à Baseline. + +## Considérations supplémentaires + +Baseline doit être vu comme un guide général, qui ne couvre pas l'ensemble des situations. Si votre site ou application doit fonctionner dans un navigateur pour une version à support à long terme, ou dans un navigateur ou appareil plus ancien (éventuellement non couvert par Baseline), il vous appartiendra de tester et de consulter les données de compatibilité détaillées sur MDN ou [caniuse.com](https://caniuse.com/) avant de déployer une fonctionnalité donnée. + +## Contribuer + +Baseline est un projet participatif, mené par le groupe communautaire W3C WebDX, qui base ses données sur les données de compatibilité des navigateurs fournies par MDN. Si vous avez des questions, souhaitez mettre à jour ou étendre les données de Baseline, n'hésitez pas à vous rendre sur [web-platform-dx/web-features (en anglais)](https://github.com/web-platform-dx/web-features) pour participer. + +## Voir aussi + +- [Tester sur plusieurs navigateurs](/fr/docs/Learn/Tools_and_testing/Cross_browser_testing) +- [Le dépôt GitHub web-platform-dx/web-features](https://github.com/web-platform-dx/web-features) +- [Le groupe communautaire W3C WebDX](https://www.w3.org/community/webdx/) +- [Le dépôt GitHub mdn/browser-compat-data](https://github.com/mdn/browser-compat-data) diff --git a/files/fr/glossary/baseline/typography/index.md b/files/fr/glossary/baseline/typography/index.md new file mode 100644 index 00000000000000..f2bbfb8108bd6c --- /dev/null +++ b/files/fr/glossary/baseline/typography/index.md @@ -0,0 +1,17 @@ +--- +title: Ligne de base (typographie) +slug: Glossary/Baseline/Typography +l10n: + sourceCommit: 36527a8af0f396e8b84de3cda578d9e0fe1860f4 +--- + +{{GlossarySidebar}} + +La **ligne de base** est une notion utilisée en typographie qui représente la ligne imaginaire sur laquelle repose les différents caractères d'un texte. + +{{GlossaryDisambiguation}} + +## Voir aussi + +- [La page Wikipédia sur la ligne de base]() +- [Alignement des boîtes CSS](/fr/docs/Web/CSS/CSS_box_alignment#types_dalignement) diff --git a/files/fr/glossary/binding/index.md b/files/fr/glossary/binding/index.md new file mode 100644 index 00000000000000..17fd0af4cf266c --- /dev/null +++ b/files/fr/glossary/binding/index.md @@ -0,0 +1,22 @@ +--- +title: Name binding (liaison de nom) +slug: Glossary/Binding +l10n: + sourceCommit: 36527a8af0f396e8b84de3cda578d9e0fe1860f4 +--- + +{{GlossarySidebar}} + +En programmation, la **liaison de nom** (name binding en anglais) correspond à l'association d'un [identifiant](/fr/docs/Glossary/Identifier) avec une valeur. C'est le cas pour les [variables](/fr/docs/Glossary/Variable), mais aussi pour les [paramètres](/fr/docs/Glossary/Parameter) des fonctions et celles créées par les blocs [`try…catch`](/fr/docs/Web/JavaScript/Reference/Statements/try...catch). Certaines liaisons de nom sont implicitement créées par le langage, comme [`this`](/fr/docs/Web/JavaScript/Reference/Operators/this) et [`new.target`](/fr/docs/Web/JavaScript/Reference/Operators/new.target) en JavaScript. + +On dit d'une liaison qu'elle est [muable](/fr/docs/Glossary/Mutable) si elle peut être réaffectée et [immuable](/fr/docs/Glossary/Immutable) sinon (cela ne signifie pas que la valeur correspondante est immuable). + +Une liaison est généralement associée à une [portée](/fr/docs/Glossary/Scope). Certains langages de programmation permettent de recréer des liaisons au sein d'une même portée (on parle parfois de redéclaration), et d'autres non. En JavaScript, une liaison pourra être redéclarée selon l'instruction utilisée pour créer la liaison. + +## Voir aussi + +- [`var`](/fr/docs/Web/JavaScript/Reference/Statements/var) +- [`let`](/fr/docs/Web/JavaScript/Reference/Statements/let) +- [`const`](/fr/docs/Web/JavaScript/Reference/Statements/const) +- [`function`](/fr/docs/Web/JavaScript/Reference/Statements/function) +- [`class`](/fr/docs/Web/JavaScript/Reference/Statements/class) diff --git a/files/fr/glossary/bitwise_flags/index.md b/files/fr/glossary/bitwise_flags/index.md new file mode 100644 index 00000000000000..a3ebf358e8a0b2 --- /dev/null +++ b/files/fr/glossary/bitwise_flags/index.md @@ -0,0 +1,50 @@ +--- +title: Marqueurs binaires +slug: Glossary/Bitwise_flags +l10n: + sourceCommit: 36527a8af0f396e8b84de3cda578d9e0fe1860f4 +--- + +{{GlossarySidebar}} + +Les **marqueurs binaires** sont un ensemble de variables, généralement des valeurs numériques, qui permettent d'activer ou désactiver des fonctionnalités d'une méthode ou autre. Ces opérations sont rapides, car elles s'appliquent au niveau binaire. Les marqueurs associés sont généralement des valeurs complémentaires, représentés par des bits différents d'une même valeur (généralement un nombre hexadécimal), afin qu'une même valeur numérique permette de combiner et représenter différents marqueurs. + +Par exemple, quand on crée un objet [`GPUBuffer`](/fr/docs/Web/API/GPUBuffer) avec la méthode [`GPUDevice.createBuffer()`](/fr/docs/Web/API/GPUDevice/createBuffer) de [l'API WebGPU](/fr/docs/Web/API/WebGPU_API), on fournit une propriété `usage` dans le descripteur qui contient un ou plusieurs marqueurs pour activer certaines utilisation du tampon. + +```js +usage: GPUBufferUsage.COPY_SRC | GPUBufferUsage.MAP_WRITE; +``` + +Ces valeurs sont définies dans le même espace de nom et chacune prend une valeur hexadécimale différente : + +| Marqueur | Représentation hexadécimale | Équivalent décimal | +| ------------------------------ | --------------------------- | ------------------ | +| `GPUBufferUsage.MAP_READ` | 0x0001 | 1 | +| `GPUBufferUsage.MAP_WRITE` | 0x0002 | 2 | +| `GPUBufferUsage.COPY_SRC` | 0x0004 | 4 | +| `GPUBufferUsage.COPY_DST` | 0x0008 | 8 | +| `GPUBufferUsage.INDEX` | 0x0010 | 16 | +| `GPUBufferUsage.VERTEX` | 0x0020 | 32 | +| `GPUBufferUsage.UNIFORM` | 0x0040 | 64 | +| `GPUBufferUsage.STORAGE` | 0x0080 | 128 | +| `GPUBufferUsage.INDIRECT` | 0x0100 | 256 | +| `GPUBufferUsage.QUERY_RESOLVE` | 0x0200 | 512 | + +Quand on consulte la propriété [`GPUBuffer.usage`](/fr/docs/Web/API/GPUBuffer/usage) d'un tampon, on obtient un seul nombre qui est la somme des différents marqueurs binaires. Si on récupère `GPUBuffer.usage` à partir de celui créé dans l'exemple précédent, on obtiendra la valeur décimale 6, car : + +- La valeur décimale équivalente de `GPUBufferUsage.COPY_SRC` vaut 4 +- La valeur décimale équivalente de `GPUBufferUsage.MAP_WRITE` vaut 2 +- La somme de 4 et 2 donne 6. + +Comme les valeurs de chaque marqueur se situent sur des bits différents de la valeur composite, chaque combinaison fournira une valeur unique. Le programme peut alors déterminer quels marqueurs sont actifs à partir d'une unique valeur. Il est aussi possible de tester les marqueurs présents sur une valeur composite à l'aide des opérateurs binaires : + +```js +if (buffer.usage & GPUBufferUsage.MAP_WRITE) { + // Buffer possède le marqueur MAP_WRITE usage +} +``` + +## Voir aussi + +- [La beauté des marqueurs binaires (en anglais)](https://www.hendrik-erz.de/post/bitwise-flags-are-beautiful-and-heres-why) +- [La page sur les opérations binaires sur Wikipédia](https://fr.wikipedia.org/wiki/Op%C3%A9ration_bit_%C3%A0_bit) diff --git a/files/fr/glossary/boolean/aria/index.md b/files/fr/glossary/boolean/aria/index.md new file mode 100644 index 00000000000000..bdd463660a3076 --- /dev/null +++ b/files/fr/glossary/boolean/aria/index.md @@ -0,0 +1,16 @@ +--- +title: Attribut booléen (ARIA) +slug: Glossary/Boolean/ARIA +l10n: + sourceCommit: 36527a8af0f396e8b84de3cda578d9e0fe1860f4 +--- + +{{GlossarySidebar}} + +Un **attribut booléen** ARIA est un [attribut à valeur contrainte](/fr/docs/Glossary/Enumerated) qui inclut `true` ou `false` dans la liste des valeurs qu'il peut prendre. + +En ARIA, les attributs booléens sont uniquement des chaînes de caractères `"true"` et `"false"`. + +## Voir aussi + +- [L'entrée du glossaire pour les listes énumérées](/fr/docs/Glossary/Enumerated), qui contient plus de détails et d'exemples, notamment pour les attributs booléens ARIA. diff --git a/files/fr/glossary/boolean/html/index.md b/files/fr/glossary/boolean/html/index.md new file mode 100644 index 00000000000000..c742a4743366a8 --- /dev/null +++ b/files/fr/glossary/boolean/html/index.md @@ -0,0 +1,30 @@ +--- +title: Attribut booléen (HTML) +slug: Glossary/Boolean/HTML +l10n: + sourceCommit: 36527a8af0f396e8b84de3cda578d9e0fe1860f4 +--- + +{{GlossarySidebar}} + +En HTML, un **attribut booléen** est un attribut qui peut valoir `true` ou `false`. + +On notera qu'un attribut booléen vaut `true` s'il est présent et `false` s'il est absent. + +Voici un exemple pour l'attribut booléen HTML `checked` : + +```html + + + + + + + + + +``` + +## Voir aussi + +- [Liste énumérée](/fr/docs/Glossary/Enumerated) diff --git a/files/fr/glossary/boolean/javascript/index.md b/files/fr/glossary/boolean/javascript/index.md new file mode 100644 index 00000000000000..eb6c8379099c2c --- /dev/null +++ b/files/fr/glossary/boolean/javascript/index.md @@ -0,0 +1,17 @@ +--- +title: Booléen (JavaScript) +slug: Glossary/Boolean/JavaScript +l10n: + sourceCommit: 36527a8af0f396e8b84de3cda578d9e0fe1860f4 +--- + +{{GlossarySidebar}} + +En JavaScript, un **booléen** est une [valeur primitive](/fr/docs/Glossary/Primitive) qui peut être `true` ou `false`. + +Un objet [`Boolean`](/fr/docs/Web/JavaScript/Reference/Global_Objects/Boolean) est une [enveloppe (wrapper)](/fr/docs/Glossary/Wrapper) pour les valeurs booléennes primitives. + +## Voir aussi + +- [L'objet global JavaScript `Boolean`](/fr/docs/Web/JavaScript/Reference/Global_Objects/Boolean) +- [Les types et structures de données en JavaScript](/fr/docs/Web/JavaScript/Data_structures)