Une remarque ? Une suggestion ?...

Merci de participer à l'amélioration de ce site. Prenez le temps de rédiger votre remarque le plus précisément possible :

Env() - Fonction CSS

env()

Résumé des caractéristiques de la fonction env()

Description rapide
Récupère la valeur d'une variable d'environnement.
Statut
Problèmes de compatibilité
Pourcentages
Utilisables pour la valeur par défaut.
Références (W3C)
Statut du document: ED (brouillon des éditeurs)

Description de la fonction env().

La fonction env() permet de récupérer la valeur d'une variable d'environnement. Celles-ci sont définies au niveau du navigateur et sont donc communes à tous les éléments et toutes les pages.

Ne confondez pas les variables d'environnement avec les propriétés personnalisées, qui sont définies par le développeur et dont la portée est ajustable (la page, un élément, etc.). La valeur d'une propriété personnalisée est récupérable avec la fonction var().

Utilisation de la fonction env().

La fonction env() peut être utilisée avec toutes les propriétés, et plus généralement partout où une valeur CSS est attendue.

Syntaxe de la fonction env().

  • propriété: env(safe-area-inset-top, 100px); propriété: env(safe-area-inset-right, 100px); propriété: env(safe-area-inset-bottom, 100px); propriété: env(safe-area-inset-left, 100px);

    Ces quatre variables d'environnement sont définies par le navigateur en fonction de la forme de l'affichage. Elles définissent le rectangle le plus grand possible qui soit cependant entièrement visible. Dans le cas d'un affichage de forme carrée, cela correspond à des marges sur deux des côtés.

    La deuxième valeur (100px dans nos exemples) est la valeur par défaut qui sera utilisée si la variable d'environnement indiquée n'existe pas. Pour être plus précis, tout ce qui suit la première virgule est considérée comme la valeur par défaut. Voici quelques exemples de syntaxes, avec la valeur par défaut correspondante :

    margin:env(safe-are-inset-top, 10px 0); La valeur par défaut est 10px 0
     

     

    propriété:env(safe-are-inset-top, 10px,50px); La valeur par défaut est 10px,50px
     
  • propriété: env(titlebar-area-x, 10px); propriété: env(titlebar-area-y, 10px); propriété: env(titlebar-area-width, 500px); propriété: env(titlebar-area-height, 40px);

    Ces quatre valeurs fournissent des informations sur les dimensions et l'emplacement de la barre de titre.

  • propriété: env(viewport-segment-top, 500px); propriété: env(viewport-segment-right, 40px); propriété: env(viewport-segment-bottom, 500px); propriété: env(viewport-segment-left, 40px); propriété: env(viewport-segment-width, 10px); propriété: env(viewport-segment-height, 10px);

    Ces valeurs sont intéressantes lorsque le viewport est divisé en plusieurs parties, comme on peut le faire sur un téléphone portable.

Simulateur.

Le simulateur permet d'observer plusieurs cas de figure :

  • Toutes les options s'affichent en rouge : la fonction env() n'est pas reconnue par votre navigateur.
  • Le choix d'une option fait apparaître une petite marge (50 pixels) sur la gauche de l'élément de test. Cela signifie que la valeur par défaut a été utilisée et que donc, cette variable d'environnement n'existe pas.
  • Le choix d'une option annule la marge gauche ou fixe une marge différente de 50 pixels : la variable d'environnement a été reconnue et sa valeur est utilisée pour définir la marge gauche de l'élément de test.
margin-left :
TEST
Cet élément à une marge gauche de 50 pixels (pour comparaison).

Compatibilité et prise en charge par les navigateurs.

La fonction env() en elle-même est bien prise en charge, mais les variables d'environnement disponibles sont très dépendantes du navigateur utilisé.

Colonne 1
Prise en charge générale de la fonction CSS env().
Colonne 2
Traitement des variables d'environnement safe-area-inset-top, safe-area-inset-right, safe-area-inset-bottom et safe-area-inset-right.
Colonne 3
Traitement des variables d'environnement titlebar-area-x et titlebar-area-y.
Colonne 4
Traitement des variables d'environnement titlebar-area-width et titlebar-area-height.
1
Fonction
env()
2
Zone
sécurisée
3
Position de la
barre de titre
4
Dimensions de
la barre de titre
Estimation de la prise en charge globale.
95%
95%
73%
73%

Navigateurs sur ordinateurs :

Navigateurs sur mobiles :

Navigateurs obsolètes ou marginaux :

Androïd Brower

Baidu Browser

Chrome

Chrome pour Androïd

Edge

Firefox

Firefox pour Androïd

Internet Explorer

KaiOS Browser

Opéra

Opéra Mobile

QQ Browser

Safari

Safari sur IOS

Samsung Internet

UC Browser pour Androïd

Opéra mini

Voir aussi, dans le même module de standardisation que env().

Les spécifications CSS éditées par le W3C sont organisées en modules. env() fait partie du (). Les définitions suivantes sont également décrites dans ce même module.

Sélecteurs :

Pseudo-élément qui désigne l'échantillon de couleur associé à une balise input du type="color".
Pseudo-élément. Désigne les puces dans une liste à puces.
Pseudo-élément. Désigne les numéros dans une liste numérotée.
Pseudo-élément désignant la partie déjà parcourue d'une barre de progression.
Peudo-élément correspondant à la partie de la glissière située à gauche du curseur.
Pseudo-élément correspondant au curseur d'une zone de saisie du type range.
Peudo-élément correspondant à la glissière d'une zone de saisie du type range.
Pseudo-élément désignant le bouton parcourir d'une zone de saisie du type file.
Pseudo-élément désignant les cases à cocher et les boutons radio.
Pseudo-élément désignant le bouton d'effacement d'une zone de saisie.
Pseudo-élément désignant le bouton d'ouverture de la liste.
Pseudo-élément correspondant à la partie déjà parcourue d'une barre de progression.
Pseudo-élément désignant la partie de la glissière à gauche du curseur (zone de saisie du type range).
Pseudo-élément désignant la partie de la glissière à droite du curseur (zone de saisie du type range).
Pseudo-élément correspondant au bouton d'affichage en clair du mot de passe.
Pseudo-élément désignant le curseur (zone de saisie du type range).
Pseudo-élément désignant la graduation d'une zone de saisie du type range.
Pseudo-élément désignant la graduation d'une zone de saisie du type range.
Pseudo-élément correspondant aux info-bulles.
Pseudo-élément désignant la glissière d'une zone de saisie du type range.
Pseudo-élément correspondant à la valeur dans une zone de saisie.
Pseudo-élément désignant l'échelle d'un élément du type meter..
Pseudo-élément correspondant à la glissière d'une barre de progression (élément progress).
Pseudo-élément correspondant à la partie gauche d'une barre de progression.
Pseudo-élément correspondant à la glissière d'une zone de saisie du type range.
Pseudo-élément correspondant au curseur d'une zone de saisie du type range.

Propriétés :

Propriété spécifique aux navigateurs Mozilla.
Propriété spécifique aux navigateurs Mozilla.
Définit si les dimensions de l'élément incluent la marge, la bordure, les marges intérieures, ou seulement le contenu.
Force le remplacement des images non trouvées par un pictogramme.
Définit quelle zone de l'image doit être affichée (utilisable sur les puces personnalisées).
Contrôle le lissage des caractères.
Définit la couleur d'un lien qui a été touché ou cliqué.
Permet la mise en forme de caractères "creux".
Définit le rayon de l'arrondi de l'angle en début de ligne et début de bloc.
box-flex
Définit si un élément contenu dans un box peut s'agrandir pour occuper la place disponible.
Définit l'ordre d'un élément contenu dans un container box.
Définit si le container box affiche ses éléments horizontalement ou verticalement.
box-pack
Définit le positionnement des éléments contenus dans un container box, suivant l'axe principal.
Définit une duplication et un effet de symétrie sur un container box.
cx
Définit la position horizontale du centre d'un cercle ou d'une ellipse en SVG.
cy
Définit la position verticale du centre d'un cercle ou d'une ellipse en SVG.
Couleur de la bordure, coté éclairé.
Couleur des flèches des barres de défilement.
Couleur des barres de défilement.
Couleur de la partie ombrée des barres de défilement.
Couleur du curseur dans une barre de défilement.
Couleur de l'ombre des barres de défilement.
Détermine quels sont les gestes traités par le navigateur sur un écran tactile (glissé du doigt, zoom par pincement...)