WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / CSS

env() — Umgebungswert mit Ersatzwert

`env()` ersetzt eine globale, vom UA bereitgestellte Umgebungsvariable, optionale Indizes für einen Arraywert und einen Ersatzwert bei fehlendem Namen oder Index.

Version: 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() ersetzt eine globale, vom UA bereitgestellte Umgebungsvariable, optionale Indizes für einen Arraywert und einen Ersatzwert bei fehlendem Namen oder Index.

Das Beispiel erhält 17px aus env(cktis-missing, 17px); env(cktis-missing) ohne Ersatz wird dagegen zur berechneten Zeit ungültig und automatische Breite im 200-px-Elternfeld ergibt 200px. env(safe-area-inset-left, 99px) liefert vorhandene 0px, daher greift der 99-px-Ersatz nicht. Die Abfrage @supports (env(safe-area-inset-left)) ergibt in diesem Chromium false.

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

Der Ersatzwert umfasst alles nach dem ersten Komma und darf selbst Kommas enthalten. Anders als var() sind Umgebungsvariablen dokumentweit und stammen nicht aus der Kaskade. Ein vorhandener Nullwert ist dennoch vorhanden; ohne Ersatz wird die Deklaration erst zur berechneten Zeit ungültig. Die env-Form in einer CSS-Conditional-5-supports-Abfrage testet die Erkennung eines Namens und ist eine getrennte, derzeit nicht unterstützte Oberfläche von der Wertersetzung.

Beispiele

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

Ergebnis

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

`env()` ersetzt eine globale, vom UA bereitgestellte Umgebungsvariable, optionale Indizes für einen Arraywert und einen Ersatzwert bei fehlendem Namen oder Index.

Quellen