Référence de l’API
Composants

<style> - Cette fonctionnalité est disponible dans le dernier Canary

Canary (fonctionnalité expérimentale)

Les extensions de React à <style> ne sont actuellement disponibles que sur les canaux de livraison Canary et Expérimental de React. Dans les versions stables de React, <style> fonctionne comme le composant HTML natif du navigateur. Apprenez-en davantage sur les canaux de livraison React.

Le composant natif <style> du navigateur vous permet d’ajouter des feuilles de styles définies à la volée dans votre document.

<style>{` p { color: red; } `}</style>

Référence

<style>

Pour ajouter une feuille de styles définie à la volée dans votre document, utilisez le composant natif <style> du navigateur. Vous pouvez utiliser <style> depuis n’importe quel composant et React placera dans certains cas l’élément DOM correspondant dans l’en-tête (head) du document et dédoublonnera les styles identiques.

<style>{` p { color: red; } `}</style>

Voir d’autres exemples plus bas.

Props

<style> prend en charge toutes les props communes aux éléments.

  • children : une chaîne de caractères, obligatoire. Le code source de la feuille de styles définie à la volée.
  • precedence : une chaîne de caractères. Indique à React où placer le nœud DOM <style> par rapport aux autres présents dans le <head> du document, ce qui détermine quelle feuille de styles a priorité sur quelle autre. React déduira que les valeurs de précédence qu’il rencontre en premier sont « plus faibles » et que celles qu’il rencontre plus tard sont « plus fortes ». De nombreux systèmes de gestion de styles fonctionneront très bien avec une unique valeur de précédence, parce que les règles de styles y sont atomiques. Les feuilles de style de même précédence sont regroupées, qu’il s’agisse de balises <link> ou <style>, y compris si elles sont chargées via la fonction preinit.
  • href : une chaîne de caractères. Permet à React de dédoublonner les styles qui auraient le même href.
  • media : une chaîne de caractères. Restreint la feuille de styles à une media query spécifique.
  • nonce : une chaîne de caractères. Un nonce cryptographique autorisant la ressource dans le cadre d’une Politique de Sécurité de Contenu (CSP) stricte.
  • title : une chaîne de caractères. Indique le nom d’une feuille de styles alternative.

Ces props sont déconseillées pour une utilisation avec React :

  • blocking : une chaîne de caractères. Si elle vaut "render", le navigateur attendra pour afficher la page que la feuille de styles ait fini son chargement. React permet un contrôle plus granulaire grâce à Suspense.

Comportement spécifique de rendu

React peut déplacer les composants <style> dans le <head> du document, dédoublonner les feuilles de styles identiques et suspendre pendant le chargement de la feuille de styles.

Pour activer ces comportements, fournissez les props href et precedence. React dédoublonnera les feuilles de styles qui ont le même href. La précédence indique à React où placer le nœud DOM <style> par rapport aux autres dans le <head> du document, ce qui détermine quelle feuille de styles peut surcharger quelle autre.

Pour finir, ce comportement a deux limitations :

  • React ignorera les changements à ces props après le rendu de la feuille de styles. (React produira un avertissement en développement si ce cas survient.)
  • React est susceptible de laisser la feuille de styles dans le DOM même après le démontage du composant qui l’a produit.

Utilisation

Injecter une feuille de styles définie à la volée

Si un composant dépend de certains styles CSS pour pouvoir fonctionner correctement, vous pouvez injecter une feuille de styles définie à la volée au sein de ce composant.

Si vous fournissez les props href et precedence, votre composant suspendra le temps du chargement de la feuille de styles. (Même pour des feuilles définies à la volée, il peut y avoir un temps de chargement en raison de ressources extérieures référencées par les styles, telles que des fontes ou images.) La prop href devrait identifier la feuille de styles de façon unique, car React dédoublonnera les feuilles de styles de même href.

import ShowRenderedHTML from './ShowRenderedHTML.js';
import { useId } from 'react';

function PieChart({data, colors}) {
  const id = useId();
  const stylesheet = colors.map((color, index) =>
    `#${id} .color-${index}: \{ color: "${color}"; \}`
  ).join();
  return (
    <>
      <style href={"PieChart-" + JSON.stringify(colors)} precedence="medium">
        {stylesheet}
      </style>
      <svg id={id}>
        …
      </svg>
    </>
  );
}

export default function App() {
  return (
    <ShowRenderedHTML>
      <PieChart data="..." colors={['red', 'green', 'blue']} />
    </ShowRenderedHTML>
  );
}
Précédent<script>
Suivant<title>