CKTIS / CSS
env() — valeur d’environnement avec repli
`env()` substitue une variable d’environnement globale fournie par l’UA, des indices facultatifs pour une valeur tabulaire et un repli si le nom ou l’indice manque.
Version : CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Syntaxe
env( <custom-ident> <integer [0,∞]>* [ , <declaration-value>? ]? )env() substitue une variable d’environnement globale fournie par l’UA, des indices facultatifs pour une valeur tabulaire et un repli si le nom ou l’indice manque.
L’exemple obtient 17px avec env(cktis-missing, 17px), tandis que env(cktis-missing) sans repli devient invalide au stade calculé et la largeur auto dans un parent de 200 px donne 200px. env(safe-area-inset-left, 99px) renvoie la valeur existante 0px, donc son repli de 99 px n’est pas pris. La requête @supports (env(safe-area-inset-left)) renvoie false dans ce Chromium.
Grammaire: env( <custom-ident> <integer [0,∞]>* [ , <declaration-value>? ]? ).
Le repli comprend tout ce qui suit la première virgule et peut lui-même contenir des virgules. Contrairement à var(), les variables d’environnement sont globales au document et ne viennent pas de la cascade. Une valeur zéro existante existe bien ; sans repli, la déclaration n’est invalidée qu’au stade calculé. La forme env d’une requête supports de CSS Conditional 5 teste la reconnaissance du nom et constitue une surface distincte, encore non prise en charge, de la substitution de valeur.
Exemples
const host=document.createElement('div'); host.style.width='200px';
const fallback=document.createElement('div'); fallback.style.width='env(cktis-missing, 17px)';
const missing=document.createElement('div'); missing.style.width='env(cktis-missing)';
const safe=document.createElement('div'); safe.style.paddingLeft='env(safe-area-inset-left, 99px)';
host.append(fallback,missing,safe); document.body.append(host);
const supportsQuery=CSS.supports('env(safe-area-inset-left)');
console.log('fallback='+getComputedStyle(fallback).width+'; missing-no-fallback='+getComputedStyle(missing).width+'; safe-area-left='+getComputedStyle(safe).paddingLeft+'; supports-env-query='+supportsQuery);Résultat
fallback=17px; missing-no-fallback=200px; safe-area-left=0px; supports-env-query=false
`env()` substitue une variable d’environnement globale fournie par l’UA, des indices facultatifs pour une valeur tabulaire et un repli si le nom ou l’indice manque.