Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła