KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / CSS

env() — omgevingswaarde met terugval

`env()` vervangt een globale door de UA geleverde omgevingsvariabele, optionele indexen voor een arraywaarde en een terugval als naam of index ontbreekt.

Versie: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required

Syntax

env( <custom-ident> <integer [0,∞]>* [ , <declaration-value>? ]? )

env() vervangt een globale door de UA geleverde omgevingsvariabele, optionele indexen voor een arraywaarde en een terugval als naam of index ontbreekt.

Het voorbeeld verkrijgt 17px uit env(cktis-missing, 17px); env(cktis-missing) zonder terugval wordt daarentegen ongeldig bij de berekende waarde en automatische breedte in een ouder van 200 px geeft 200px. env(safe-area-inset-left, 99px) levert bestaande 0px, dus de terugval van 99 px wordt niet gebruikt. De query @supports (env(safe-area-inset-left)) geeft in dit Chromium false.

Grammatica: env( <custom-ident> <integer [0,∞]>* [ , <declaration-value>? ]? ).

De terugval omvat alles na de eerste komma en mag zelf komma’s bevatten. Anders dan var() zijn omgevingsvariabelen documentbreed en komen ze niet uit de cascade. Een bestaande nulwaarde bestaat wel degelijk; zonder terugval wordt de declaratie pas bij de berekende waarde ongeldig. De env-vorm in een CSS Conditional 5-supports-query test herkenning van een naam en is een afzonderlijk, nog niet ondersteund oppervlak naast waardevervanging.

Voorbeelden

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);

Resultaat

fallback=17px; missing-no-fallback=200px; safe-area-left=0px; supports-env-query=false

`env()` vervangt een globale door de UA geleverde omgevingsvariabele, optionele indexen voor een arraywaarde en een terugval als naam of index ontbreekt.

Bronnen