image-resolution
Expérimental: Cette fonction est expérimentale
Puisque cette fonction est toujours en développement dans certains navigateurs, veuillez consulter le tableau de compatibilité pour les préfixes à utiliser selon les navigateurs.
Il convient de noter qu'une fonctionnalité expérimentale peut voir sa syntaxe ou son comportement modifié dans le futur en fonction des évolutions de la spécification.
La propriété CSS image-resolution
spécifie la résolution intrinsèque de toutes les images matricielles utilisée dans l'élément. Cela affecte les images de contenu comme les éléments remplacés et le contenu généré, ainsi que les images décoratives générées à l'aide de la propriété background-image
.
La résolution de l'image est définie par le nombre de pixels par unité de longueur de l'image, par exemple exprimé en pixels par pouce. Par défaut, CSS part du principe que la résolution d'une image est d'un pixel image par unité de pixel CSS. Cependant, la propriété image-resolution
permet de définir une résolution différente.
Syntaxe
image-resolution: from-image;
image-resolution: 300dpi;
image-resolution: from-image 300dpi;
image-resolution: 300dpi snap;
/* Valeurs globales */
image-resolution: inherit;
image-resolution: initial;
image-resolution: revert;
image-resolution: unset;
Valeurs
<resolution>
-
Spécifie explicitement la résolution intrinsèque.
from-image
-
Utilise la résolution intrinsèque comme spécifié par le format de l'image. Si l'image ne spécifie pas elle-même sa propre résolution, alors la résolution explicitement spécifiée sera utilisée, si elle a été fournie. Sinon, la résolution par défaut sera de
1dppx
(1 pixel image par unité de pixel CSS). snap
-
Si le mot-clé
snap
est fourni, la résolution calculée sera la résolution spécifiée arrondie à la valeur la plus proche correspondant à un pixel image défini sous la forme d'un nombre entier de pixels de l'appareil. Si la résolution est récupérée à partir de l'image, alors la résolution intrinsèque utilisée est la résolution native de l'image, arrondie de la même façon.
Note : Les formats vectoriels tels que SVG n'ont pas de résolution intrinsèque, cette propriété n'a aucun effet sur les images vectorielles.
Définition formelle
Valeur initiale | 1dppx |
---|---|
Applicabilité | tous les éléments |
Héritée | oui |
Valeur calculée | telle que spécifiée, sauf avec <resolution> éventuellement modifiée lors du calcul par la valeur 'snap' |
Type d'animation | discrète |
Syntaxe formelle
Exemples
Mettre en place la haute résolution pour l'impression
Lorsque l'on imprime un document, il est possible de demander une meilleure résolution pour les images :
@media print {
.mon-image {
image-resolution: 300dpi;
}
}
Utiliser la propriété image-resolution avec des solutions de repli
L'exemple ci-dessous utilise la résolution définie par l'image. Si l'image ne spécifie aucune résolution, alors la valeur de 300dpi
est utilisée à la place de la valeur par défaut de 1dppx
.
.mon-image {
image-resolution: from-image 300dpi;
}
Spécifications
Specification |
---|
CSS Images Module Level 4 # the-image-resolution |
Compatibilité des navigateurs
Voir aussi
- Autres propriétés CSS liées aux images :
object-fit
,object-position
,image-orientation
,image-rendering
. - Bug sur Chromium : 1086473.