From ac307b551c7422851e7111c0530a21a0b1a1a9d1 Mon Sep 17 00:00:00 2001 From: Jb Audras Date: Thu, 29 Jul 2021 19:08:58 +0200 Subject: French translation of the `@property` rule reference (#1762) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * original translation * Remove 'aux développeurs' * Link typofix Co-authored-by: SphinxKnight --- files/fr/web/css/@property/index.html | 80 +++++++++++++++++++++++++++++++++++ 1 file changed, 80 insertions(+) create mode 100644 files/fr/web/css/@property/index.html (limited to 'files/fr') diff --git a/files/fr/web/css/@property/index.html b/files/fr/web/css/@property/index.html new file mode 100644 index 0000000000..cdcb5770ff --- /dev/null +++ b/files/fr/web/css/@property/index.html @@ -0,0 +1,80 @@ +--- +title: '@property' +slug: Web/CSS/@property +browser-compat: css.at-rules.property +translation_of: 'Web/CSS/@property' +--- +
{{CSSRef}}{{SeeCompatTable}}
+ +

La règle {{cssxref("at-rule")}} CSS @property fait partie du panel d'API CSS Houdini, qui permet de définir explicitement leurs propriétés CSS personnalisées (voir {{cssxref('--*', 'CSS custom properties')}}). Cela permet la vérification des types de propriétés, de leur donner des valeurs par défaut et de déterminer si une propriété peut hériter ses valeurs ou non.

+ +

La règle @property permet l'enregistrement d'une propriété personnalisée directement dans une feuille de styles sans avoir à utiliser la moindre ligne de JavaScript. Une règle @property valide enregistre une nouvelle propriété personnalisée comme si {{domxref('CSS.registerProperty')}} avait été appelé avec les mêmes paramètres.

+ +

Syntaxe

+ +
@property --property-name {
+  syntax: '<color>';
+  inherits: false;
+  initial-value: #c0ffee;
+}
+ +

Descripteurs

+ +
+
{{cssxref("@property/syntax","syntax")}}
+
Décrit la syntaxe autorisée de la propriété.
+
{{cssxref("@property/inherits","inherits")}}
+
Détermine si l'enregistrement de la propriété personnalisée spécifiée avec @property hérite ou non par défaut.
+
{{cssxref("@property/initial-value","initial-value")}}
+
Détermine la valeur initiale de la propriété.
+
+ +

Une règle @property valide enregistre une propriété personnalisée avec comme nom de propriété la sérialisation de du préfixe de la règle.

+ +

Une règle @property nécessite le respecte d'une syntaxe (voir {{cssxref("@property/syntax","syntax")}}) et une description d'héritage (voir {{cssxref("@property/inherits","inherits")}}). Si l'un des deux manque, l'ensemble de la règle est invalide et celle-ci doit être ignorée. Le descripteur {{cssxref("@property/initial-value","initial-value")}} est optionnel, uniquement si la syntaxe est une définition de syntaxe universelle. Sinon, le descripteur est requis (s'il manque, l'ensemble de la règle est invalide et celle-ci doit être ignorée).

+ +

Les descripteurs inconnus ne sont pas valides et sont ignorés, mais n'invalident pas l'ensemble de la règle @property.

+ +

Exemples

+ +

Ajout d'une vérification de type à la {{cssxref('--*', 'propriété personnalisée')}} --my-color en tant que couleur et que valeur par défaut, sans lui permettre d'hériter de sa valeur :

+ +

Utilisation de la règle CSS at-rule {{cssxref('@property')}} :

+ +
@property --my-color {
+  syntax: '<color>';
+  inherits: false;
+  initial-value: #c0ffee;
+}
+
+ +

Équivalent avec la fonction JavaScript {{domxref('CSS.registerProperty')}} :

+ +
window.CSS.registerProperty({
+  name: '--my-color',
+  syntax: '<color>',
+  inherits: false,
+  initialValue: '#c0ffee',
+});
+
+ +

Syntaxe formelle

+ +

{{csssyntax}}

+ +

Spécifications

+ +

{{Specifications}}

+ +

Compatibilité des navigateurs

+ +

{{Compat}}

+ +

Voir aussi

+ + -- cgit v1.2.3-54-g00ecf