<meta name="theme-color">

Limited availability

Cette fonctionnalité n'est pas Compatible car elle ne fonctionne pas dans certains des navigateurs les plus utilisés.

La valeur de theme-color comme attribut name de l'élément HTML <meta>, indique une suggestion de couleur que les agents utilisateur devraient utiliser pour personnaliser l'affichage de la page ou l'interface utilisateur environnante. Si elle est utilisée, l'attribut content devra avoir une valeur CSS de type <color>.

Par exemple, pour indiquer qu'un document doit utiliser cornflowerblue comme couleur de thème, définissez la balise <meta> ainsi :

html

<meta name="theme-color" content="cornflowerblue" />

Pour définir le média auquel la métadonnée de couleur de thème s'applique, ajoutez l'attribut media avec une liste de requêtes média valide (voir l'exemple de requête média pour theme-color).

Notes d'utilisation

Un élément <meta name="theme-color"> possède les attributs supplémentaires suivants :

content

Un élément <meta> avec name=theme-color doit avoir un attribut content qui définit la couleur de thème. La valeur de l'attribut content est la suivante :

valeur <color>: Une valeur de couleur valide, comme un hexadécimal, RGB, nom de couleur, etc.

media Facultatif

Tout type ou requête média valide. Si fourni, les options pour la couleur de thème du document définies dans l'attribut content sont suggérées au navigateur lorsque la requête média correspond.

Exemple

Définir une valeur de couleur

Considérez le code suivant qui utilise <meta> pour définir une couleur de thème :

html

<meta name="theme-color" content="#4285f4" />

L'image qui suit illustre l'effet de l'élément <meta> avec theme-color pour un document affiché dans Chrome sur Android.

Image illustrant l'effet de theme-color

Crédits image : Couleurs des icônes et du navigateur ^(angl.), créée et partagée par Google et utilisée selon la licence Creative Commons 4.0 avec attribution ^(angl.).

Utilisation d'une requête média avec `theme-color`

Il est possible de fournir un type de média ou une requête média avec l'attribut media afin que la couleur soit utilisée pour une condition donnée. Par exemple :

html

<meta
  name="theme-color"
  content="cornflowerblue"
  media="(prefers-color-scheme: light)" />
<meta
  name="theme-color"
  content="dimgray"
  media="(prefers-color-scheme: dark)" />