image-rendering

Baseline Widely available *

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis ⁨janvier 2020⁩.

* Certaines parties de cette fonctionnalité peuvent bénéficier de prise en charge variables.

La propriétéCSSimage-rendering fournit une indication au navigateur à propos de l'algorithme qui devrait être utilisé pour redimensionner les images. Elle s'applique à l'élément visé, aux images fournies via les autres propriétés CSS et aux éléments descendants de l'élément ciblé.

Exemple interactif

image-rendering: auto;

image-rendering: smooth;

image-rendering: crisp-edges;

image-rendering: pixelated;

<section>  <img          src="/shared-assets/images/examples/lizard.png" /></section>

#example-element {  height: 480px;  object-fit: cover;}

L'agent utilisateur redimensionnera une image si l'auteur de la page indique des dimensions différentes de la taille naturelle de l'image, ou si la personne visualisant l'image interagit en zoomant par exemple. Si, par exemple, la taille naturelle de l'image est100×100px et que l'auteur indique les dimensions200×200px (ou50×50px), l'image sera agrandie (ou réduite) aux nouvelles dimensions via l'algorithme indiqué. Le redimensionnement peut aussi avoir lieu suite aux interactions utilisateurs (avec un zoom par exemple). Cette propriété n'a aucun effet sur les images qui ne sont pas redimensionnées.

Syntaxe

css

/*Valeurs avec un mot-clé*/image-rendering: auto;image-rendering: crisp-edges;image-rendering: pixelated;/* Valeurs globales */image-rendering: inherit;image-rendering: initial;image-rendering: revert;image-rendering: unset;

Valeurs

auto: L'algorithme utilisé dépend de l'agent utilisateur. Depuis la version 1.9 (Firefox 3.0), Gecko utilise un algorithme de rééchantillonnage bilinéaire.
crisp-edges: L'algorithme utilisé est l'interpolation au plus proche voisin.
high-qualityExpérimental: Cette valeur est proche desmooth mais favorise un redimensionnement avec une qualité élevée. Si les ressources du système sont limitées, ce sont les images ciblées avechigh-quality qui devraient être priorisées par rapport aux autres s'il est nécessaire de dégrader la qualité.
pixelated: L'algorithme utilisé est l'interpolation au plus proche voisin. L'image est agrandie au multiple entier de taille qui est supérieur ou égal à sa taille originale puis réduite à la taille cible, comme poursmooth. Lorsque l'agrandissement demandé est un multiple entier de la taille originale, l'effet obtenu sera le même qu'aveccrisp-edges
smoothExpérimental: L'algorithme utilisé pour le redimensionnement doit maximiser l'apparence de l'image. Les algorithmes qui adoucissent les couleurs (l'interpolation bilinéaire par exemple) sont acceptables. Cette valeur est destinée aux images telles que les photos.

Note :Les valeursoptimizeQuality etoptimizeSpeed qui étaient présentes dans un brouillon de la spécification (et qui provenaient de la spécification équivalente pour SVG) sont synonymes respectifs desmooth etpixelated.

Définition formelle

Valeur initiale	`auto`
Applicabilité	tous les éléments
Héritée	oui
Valeur calculée	comme spécifié
Type d'animation	discrète

Syntaxe formelle

image-rendering =
auto|
smooth|
high-quality|
pixelated|
crisp-edges

Exemples

Paramétrer l'algorithme de redimensionnement des images

En pratique, les valeurspixelated etcrisp-edges peuvent être combinées afin de fournir des alternatives l'une à l'autre. L'APICanvas peut fournirune solution alternative pourpixelated via une manipulation manuelle des données de l'image ou avecimageSmoothingEnabled.

<div>  <img alt="auto" src="blumen.jpg" />  <img alt="pixelated" src="blumen.jpg" />  <img alt="crisp-edges" src="blumen.jpg" /></div>

img {  height: 200px;}

CSS

css

.auto {  image-rendering: auto;}.pixelated {  -ms-interpolation-mode: nearest-neighbor;  image-rendering: pixelated;}.crisp-edges {  image-rendering: -webkit-optimize-contrast;  image-rendering: crisp-edges;}