Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / CSS

env() — valor de ambiente com alternativa

`env()` substitui uma variável de ambiente global fornecida pelo UA, índices opcionais para um valor matricial e uma alternativa quando o nome ou índice não existe.

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

Sintaxe

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

env() substitui uma variável de ambiente global fornecida pelo UA, índices opcionais para um valor matricial e uma alternativa quando o nome ou índice não existe.

O exemplo obtém 17px de env(cktis-missing, 17px); já env(cktis-missing) sem alternativa fica inválida no valor calculado e a largura auto num contentor de 200 px dá 200px. env(safe-area-inset-left, 99px) devolve o valor existente 0px, portanto a alternativa de 99 px não é usada. A consulta @supports (env(safe-area-inset-left)) devolve false neste Chromium.

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

A alternativa abrange tudo após a primeira vírgula e pode conter vírgulas. Ao contrário de var(), as variáveis de ambiente são globais ao documento e não vêm da cascata. Um zero existente continua a existir; sem alternativa, a declaração só é invalidada no valor calculado. A forma env numa consulta supports do CSS Conditional 5 testa o reconhecimento do nome e é uma superfície distinta, ainda não suportada, da substituição do valor.

Exemplos

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

Resultado

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

`env()` substitui uma variável de ambiente global fornecida pelo UA, índices opcionais para um valor matricial e uma alternativa quando o nome ou índice não existe.

Fontes