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 :

Element() - Fonction CSS

element()

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

Description rapide
Récupère l'aspect d'un élément sous forme d'une image.
Statut
Standard
Module W3C
Module CSS - Images
Références (W3C)
Statut du document: WD (document de travail)

Description de la fonction element().

La fonction element() est expérimentale. Elle n'est reconnue que par peu de navigateurs, et souvent avec le préfixe constructeur (-moz- pour Firefox par exemple).

La fonction element() récupère l'aspect visuel d'un élément de la page et le retourne sous forme d'une image. Celle-ci pourra être utilisée par toutes les propriétés qui acceptent une image : background-image par exemple.

L'image créée par element() est dynamique, c'est à dire qu'elle reflète en temps réel les modifications apportées à l'élément d'origine. Elle a les mêmes dimensions que l'élément d'origine (marges exclues, mais bordures et marges intérieures incluses). Bien entendu l'image peut être redimensionnée avec des propriétés comme background-size.

Il n'est possible de récupérer que l'image des éléments qui sont affichés. La fonction element() renvoi une image vide si elle est utilisée sur un élément invisible, par exemple un élément dont la propriété display est fixée à none.

Remarque : il n'est pas possible d'appliquer à un élément sa propre image ni celle d'un de ses parents. Cela parait assez logique car le paradoxe qui en résulterait serait l'équivalent d'une boucle sans fin dans un langage algorithmique.

La fonction element() peut être utilisée avec :

  • background-image : Image d'arrière-plan.
  • border-image : Résumé des propriétés des bordures réalisées avec des images.
  • mask-image : Désigne l'image ou le fichier SVG qui sera utilisé comme masque.

Syntaxe de la fonction element().

  • background-image: element(#source); id

    id est l'identifiant de l'élément dont on souhaite utiliser l'image. Notez la présence du caractère #.

Simulateur.

Le simulateur ci-dessous applique en image de fond, l'image d'un autre élément existant sur la page, comme par exemple l'un des éléments ci-dessous. Le deuxième exemple est animé et montre bien que element() génère une image dynamique. Le troisième comporte une zone de saisie et montre également que l'image est dynamique.

Le simulateur permet également, à titre d'exemple, de récupérer l'image d'autres éléments de cette page.

id="exemple1a"
id="exemple1b"
id="exemple1c"

background-image :

background-image :

Compatibilité et prise en charge par les navigateurs.

La fonction element() est expérimentale et, à l'heure actuelle (2024), n'est traitée que par Firefox, et encore avec le préfixe -moz-. Il va falloir patienter encore pour l'utiliser en production.

1
Fonction
element()
Estimation de la prise en charge globale.
3%

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 element().

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

Propriétés :

Définit l'orientation d'une image (doit-elle être tournée ?)
Mode de mise à l'échelle des images.
Définit comment un contenu multimédia (image, vidéo) doit s'adapter aux dimensions de son contenant.
Position d'une image ou d'une vidéo par rapport à son container.

Fonctions :

Définit un dégradé de couleurs conique.
Réalise le mélange de plusieurs images.
image()
Désigne ou définit une image.
Propose au navigateur un choix d'images.
Détermine un dégradé de couleur linéaire.
Détermine un dégradé de couleur radial (depuis le centre vers les bords).
Définit un dégradé de couleurs conique, avec répétition
Détermine un dégradé de couleur linéaire avec répétition.
Détermine un dégradé de couleur radial avec répétition.
stripes()
Définit une image en bande de couleurs.