Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / CSS

object-view-box — la région de référence du contenu

object-view-box sélectionne une région rectangulaire du contenu d’un élément remplacé, ce qui permet d’en agrandir et d’en déplacer la vue.

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

Syntaxe

object-view-box: none | <basic-shape-rect>;

object-view-box s’applique aux éléments remplacés. La valeur initiale none signifie qu’aucune boîte de visualisation supplémentaire n’est définie ; la propriété n’est pas héritée. En l’absence de largeur et de hauteur intrinsèques, elle n’a aucun effet.

<basic-shape-rect> définit un rectangle par rapport aux dimensions intrinsèques du contenu. Dans l’exemple, inset(0 50% 0 0) déplace le bord droit vers l’intérieur de la moitié de la largeur, sélectionnant ainsi la moitié gauche de l’image.

Les dimensions de la région remplacent les dimensions intrinsèques pour la mise en page ; object-fit et object-position s’appliquent ensuite à cette région. Il ne s’agit pas simplement d’un masque clip-path : selon l’ajustement, le contenu situé hors de la région peut rester visible.

La spécification est à l’état de brouillon ; le comportement pour une aire nulle n’est pas défini. Vérifiez le rendu dans le navigateur cible avant le déploiement.

Exemples

<!doctype html>
<meta charset="utf-8">
<title>object-view-box</title>
<style>
  img {
    display: block;
    width: 200px;
    height: 100px;
    object-fit: fill;
    object-view-box: inset(0 50% 0 0);
  }
</style>
<img alt="Two-color test image" width="200" height="100"
  src="data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='200' height='100'%3E%3Cpath fill='red' d='M0 0h100v100H0z'/%3E%3Cpath fill='blue' d='M100 0h100v100H100z'/%3E%3C/svg%3E">

Résultat

Supported rendering: a solid red 200 × 100 CSS-pixel rectangle. If the declaration is ignored: red left half and blue right half.

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources