CKTIS / CSS
env() — wartość środowiska z fallbackiem
`env()` podstawia globalną zmienną środowiskową udostępnioną przez UA, opcjonalne indeksy dla wartości tablicowej oraz fallback, gdy nazwa lub indeks nie istnieje.
Wersja: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Składnia
env( <custom-ident> <integer [0,∞]>* [ , <declaration-value>? ]? )env() podstawia globalną zmienną środowiskową udostępnioną przez UA, opcjonalne indeksy dla wartości tablicowej oraz fallback, gdy nazwa lub indeks nie istnieje.
Przykład uzyskuje 17px z env(cktis-missing, 17px), natomiast env(cktis-missing) bez fallbacku staje się nieważne w czasie obliczania i szerokość auto w polu 200 px daje 200px. env(safe-area-inset-left, 99px) zwraca istniejące 0px, więc fallback 99 px nie jest użyty. Zapytanie @supports (env(safe-area-inset-left)) zwraca w tym Chromium false.
Składnia: env( <custom-ident> <integer [0,∞]>* [ , <declaration-value>? ]? ).
Fallback obejmuje wszystko po pierwszym przecinku i sam może zawierać przecinki. W przeciwieństwie do var(), zmienne środowiskowe są globalne dla dokumentu i nie pochodzą z kaskady. Istniejąca wartość zero nadal istnieje; brak fallbacku unieważnia deklarację dopiero w czasie wartości obliczonej. Postać env w zapytaniu supports z CSS Conditional 5 testuje rozpoznanie nazwy i jest odrębną, jeszcze nieobsługiwaną powierzchnią od podstawienia wartości.
Przykłady
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);Wynik
fallback=17px; missing-no-fallback=200px; safe-area-left=0px; supports-env-query=false
`env()` podstawia globalną zmienną środowiskową udostępnioną przez UA, opcjonalne indeksy dla wartości tablicowej oraz fallback, gdy nazwa lub indeks nie istnieje.