Content-visibility - Propriété CSS

content-visibility

Résumé des caractéristiques de la propriété content-visibility

Description rapide
Définit si le contenu de l'élément (y compris les sous-éléments) doit être restitué ou pas.
Statut
Obsolète
Utilisable sur
HTML
Valeurs prédéfinies
visible | auto | hidden
Pourcentages
Ne s'appliquent pas.
Valeur initiale
visible
Héritée par défaut
Non.
Not animable : la propriété content-visibility ne peut pas être animée.
Module W3C
Module CSS - Confinement
 🡇  
 🡅  
Statut du document: WD (document de travail)

Statut du document: WD (document de travail)

Schéma de la syntaxe de content-visibility.

content-visibility - Syntax DiagramSyntax diagram of the content-visibility CSS property. See stylescss.free.fr for details. visible visible hidden hidden auto autocontent-visibility:;content-visibility:;
Schéma syntaxique de la propriété content-visibility.
Cliquez sur les liens du schéma pour plus de précisons sur les valeurs.

Description de la propriété content-visibility.

Le retrait de cette propriété et en discussion dans le module de spécification module CSS - Confinement - niveau 3.

La propriété content-visibility indique au navigateur si la mise en page d'un élément doit être calculée dès le chargement initial alors que cet élément n'est pas encore visible dans la fenêtre d'affichage. L'objectif étant bien sûr d'optimiser les calculs dans le cas de pages très lourdes.

Si des éléments tels que des images, des vidéos, etc. sont des enfants de cet élément, les navigateurs peuvent même décider de ne même pas les charger.

Valeurs pour content-visibility.

  • content-visibility: visible;

    La propriété est sans effet. : la mise en page du contenu de l'élément est calculée même si ce dernier n'est pas visible.

  • content-visibility: hidden;

    La mise en page du contenu de l'élément n'est pas réalisé tant que l'élément n'est pas visible. Ce contenu ne participe pas aux recherches.

  • content-visibility: auto;

    La mise en page du contenu de l'élément n'est pas réalisée mais le contenu participe aux recherches,

  • content-visibility: initial; (visible) content-visibility: inherit; content-visibility: revert; content-visibility: revertLayer; content-visibility: unset;

    Consultez les pages suivantes pour plus de détails : initial, inherit, revert, revert-layer, unset.

Événement Javascript.

Lorsqu'un élément a sa propriété content-visibility fixée à auto, il déclenche un événement au moment où il devient visible. Il déclenche également l'événement lorsqu'il devient invisible, ou lorsque sa propriété content-visibility passe à auto. Cet événement s'appelle contentvisibilityautostatechange (Content Visibility Auto State Change).

const el = document.getElementById("..."); el.addEventListener("contentvisibilityautostatechange", stateChange); function stateChange(event) { alert(event.skipped); }

Exemple interactif avec la propriété content-visibility.

Le simulateur vous permet surtout de tester l'événement contentvisibilityautostatechange, déclenché par l'élément qui contient le logo de Firefox  . Cliquez tout d'abord sur auto et faites défiler le contenu vers le bas.

Lorsque la deuxième image apparaît l'élément est déclenché et la fonction doit afficher false, c'est à dire que l'image n'est plus cachée. Elle affiche true dans le cas contraire, ou lorsque vous choisissez auto.

content-visibility :
Exemple pour content-visibility
Exemple pour content-visibility

Compatibilité des navigateurs avec content-visibility.

Les navigateurs reconnaissent bien la propriété content-visibility et l'événement en rapport.

Colonne 1
Traitement correct de la propriété content-visibility qui évite le rendu des éléments qui ne sont pas dans le viewport.
Colonne 2
Support par les navigateurs de l'événement contentvisibilityautostatechangeevent (changement d'état d'un élément dont la propriété content-visibility est à auto).
1
Propriété
content-visibility
2
Événement
contentvisibilityautostatechangeevent
Estimation de la prise en charge globale.
90%
90%

Navigateurs sur ordinateurs :

Navigateurs sur mobiles :

Navigateurs obsolètes ou marginaux :

Internet Explorer

UC Browser pour Androïd

Opéra Mobile

QQ Browser

Baidu Browser

Samsung Internet

Firefox

Safari

Safari sur IOS

Chrome

Opéra

Edge

Chrome pour Androïd

Firefox pour Androïd

Androïd Brower

KaiOS Browser

Opéra mini

Histoire de la propriété content-visibility.

Voir aussi, au sujet du confinement (containment).

La spécification CSS relative aux techniques de confinement est dénommée Module CSS - Confinement. La propriété content-visibility est décrite dans ce module de la norme, ainsi que les termes suivants :

Propriétés :

contain
Propriété d'optimisation, pour faciliter et accélérer le travail de mise en page des pages complexes.
container
Définit les caractéristiques d'un conteneur utilisable dans une container query (contexte d'éléments confinés).
container-name
Attribue un identifiant à un élément pour en faire un conteneur utilisable dans une container query (contexte d'éléments confinés).
container-type
Définit le type d'un conteneur utilisable dans une container query (contexte d'éléments confinés).
Content-visibility
Définit si le contenu de l'élément (y compris les sous-éléments) doit être restitué ou pas.

Directives :

@container
Permet d'écrire des règles CSS conditionnelles en fonction des caratéristiques du conteneur.