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


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
51
52

---
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'
---
<p>{{SeeCompatTable}} L'<strong>API Propriétés et valeurs CSS</strong> — qui fait partie de l'ensemble d'API <a href="/fr/docs/Web/Houdini">CSS Houdini</a> — sert à définir explicitement des <a href="/fr/docs/Web/CSS/--*">propriétés CSS personnalisées</a>, 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.</p>

<h2 id="interfaces">Interfaces</h2>

<dl>
  <dt>{{domxref('CSS.registerProperty')}}</dt>
  <dd>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 <a href="/fr/docs/Web/JavaScript">JavaScript</a> via {{domxref('CSS.registerProperty')}}.</dd>
  <dt>{{cssxref('@property')}}</dt>
  <dd>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 <a href="/fr/docs/Web/CSS/At-rule">at-rule</a> {{cssxref('@property')}} en <a href="/fr/docs/Web/CSS">CSS</a>.</dd>
</dl>

<h2 id="examples">Exemples</h2>

<p>L'exemple suivant utilise {{domxref('CSS.registerProperty')}} en <a href="/fr/docs/Web/JavaScript">JavaScript</a> pour typer une <a href="/fr/docs/Web/CSS/--*">propriété CSS personnalisée</a>, <code>--ma-couleur</code> en tant que couleur et que valeur par défaut, sans lui permettre d'hériter de sa valeur :</p>

<pre class="brush: js">window.CSS.registerProperty({
  name: '--ma-couleur',
  syntax: '&lt;color&gt;',
  inherits: false,
  initialValue: '#c0ffee',
});
</pre>

<p>Le même enregistrement peut se faire en <a href="/fr/docs/Web/CSS">CSS</a> en utilisant la règle <a href="/fr/docs/Web/CSS/At-rule">at-rule</a> {{cssxref('@property')}} :</p>

<pre class="brush: css">@property --ma-couleur {
  syntax: '&lt;color&gt;';
  inherits: false;
  initial-value: #c0ffee;
}
</pre>

<h2 id="specifications">Spécifications</h2>

<p>{{Specifications("api.CSS.registerProperty")}}</p>

<h2 id="browser_compatibility">Compatibilité des navigateurs</h2>

<p>Voir les interfaces individuelles</p>

<h2 id="see_also">Voir aussi</h2>

<ul>
  <li><a href="/fr/docs/Web/API/CSS_Painting_API">API Peinture CSS</a></li>
  <li><a href="/fr/docs/Web/API/CSS_Typed_OM_API">API Typage de modèle d'objet CSS</a></li>
  <li><a href="/fr/docs/Web/Houdini">CSS Houdini</a></li>
</ul>