files/fr/web/api/css_properties_and_values_api/index.md


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50

---
title: CSS Properties and Values API (Propriétés et valeurs)
slug: Web/API/CSS_Properties_and_Values_API
translation_of: Web/API/CSS_Properties_and_Values_API
---
{{SeeCompatTable}} L'**API Propriétés et valeurs CSS** — qui fait partie de l'ensemble d'API [CSS Houdini](/fr/docs/Web/Houdini) — sert à définir explicitement des [propriétés CSS personnalisées](/fr/docs/Web/CSS/--*), ce qui 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.

## Interfaces

- {{domxref('CSS.registerProperty')}}
  - : Définit la manière dont un navigateur devrait analyser une {{cssxref('--*', 'propriété CSS personnalisée')}}. L'accès à cette interface se fait en [JavaScript](/fr/docs/Web/JavaScript) via {{domxref('CSS.registerProperty')}}.
- {{cssxref('@property')}}
  - : Définit la manière dont un navigateur devrait analyser une {{cssxref('--*', 'propriété CSS personnalisée')}}. L'accès à cette interface se fait à l'aide d'une règle [at-rule](/fr/docs/Web/CSS/At-rule) {{cssxref('@property')}} en [CSS](/fr/docs/Web/CSS).

## Exemples

L'exemple suivant utilise {{domxref('CSS.registerProperty')}} en [JavaScript](/fr/docs/Web/JavaScript) pour typer une [propriété CSS personnalisée](/fr/docs/Web/CSS/--*), `--ma-couleur` en tant que couleur et que valeur par défaut, sans lui permettre d'hériter de sa valeur&nbsp;:

```js
window.CSS.registerProperty({
  name: '--ma-couleur',
  syntax: '<color>',
  inherits: false,
  initialValue: '#c0ffee',
});
```

Le même enregistrement peut se faire en [CSS](/fr/docs/Web/CSS) en utilisant la règle [at-rule](/fr/docs/Web/CSS/At-rule) {{cssxref('@property')}}&nbsp;:

```css
@property --ma-couleur {
  syntax: '<color>';
  inherits: false;
  initial-value: #c0ffee;
}
```

## Spécifications

{{Specifications("api.CSS.registerProperty")}}

## Compatibilité des navigateurs

Voir les interfaces individuelles

## Voir aussi

- [API Peinture CSS](/fr/docs/Web/API/CSS_Painting_API)
- [API Typage de modèle d'objet CSS](/fr/docs/Web/API/CSS_Typed_OM_API)
- [CSS Houdini](/fr/docs/Web/Houdini)