CKTIS / CSS
dppx — unité de résolution
L’unité dppx indique le nombre de points par pixel CSS. Elle appartient au type <resolution>, et non aux unités de longueur ; 1dppx équivaut à 96dpi.
Version : CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Syntaxe
<number>dppxdppx signifie points par px CSS et appartient au type <resolution>. Par exemple, 2dppx exprime une densité scalaire de deux points par pixel CSS, et non un total de deux points sur sa surface. Cela n’implique pas que la densité soit identique sur les deux axes. Pour les appareils à pixels non carrés, la caractéristique de média resolution indique la densité verticale. dppx n’est pas une unité de longueur et ne peut donc pas remplacer px dans la propriété width.
Écrivez le nombre juste avant l’unité, par exemple 1.5dppx. Les valeurs négatives ne sont pas valides. La conversion est 1dppx = 96dpi, et x est un alias de dppx.
Dans @media (min-resolution: 2dppx), les règles s’appliquent à partir du seuil de 2dppx, seuil inclus. La caractéristique resolution tient compte du zoom de la page ; elle ne doit donc pas être considérée uniquement comme une caractéristique matérielle fixe. L’utilisation de dppx n’augmente pas à elle seule la résolution des images.
Si resolution s’applique au média et que le navigateur prend en charge la syntaxe des requêtes utilisées, l’exemple définit --density sur l’élément racine du document : below-threshold en dessous du seuil et at-least-two à partir du seuil inclus. Le script détermine la valeur attendue à l’aide de la requête équivalente (min-resolution: 192dpi) dans le même environnement. La comparaison donne donc true sans exiger de facteur d’échelle de l’appareil ni de niveau de zoom particulier.
Pour les médias non visuels auxquels resolution ne s’applique pas, aucune des deux requêtes de la feuille de style n’est satisfaite et --density reste indéfinie. La requête du script n’est pas satisfaite non plus, si bien que le script attend toujours below-threshold. La valeur lue est toutefois une chaîne vide : la comparaison donne donc false.
Exemples
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Resolution media queries in dppx</title>
<style>
@media (resolution < 2dppx) {
:root { --density: below-threshold; }
}
@media (min-resolution: 2dppx) {
:root { --density: at-least-two; }
}
</style>
</head>
<body>
<p>A resolution query sets the root custom property at the 2dppx threshold.</p>
<script>
// 1dppx equals 96dpi, so 2dppx equals 192dpi.
const expected = matchMedia('(min-resolution: 192dpi)').matches
? 'at-least-two'
: 'below-threshold';
const actual = getComputedStyle(document.documentElement)
.getPropertyValue('--density').trim();
console.log(`2dppx custom property matches the 192dpi threshold: ${actual === expected}`);
</script>
</body>
</html>Résultat
2dppx custom property matches the 192dpi threshold: true
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.