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

CKTIS / CSS

clip — découpage rectangulaire historique

La propriété CSS `clip` limite la partie visible d’un élément à un rectangle sans modifier ses dimensions. Elle est obsolète : préférez `clip-path` dans le nouveau code et apprenez surtout à connaître `clip` pour maintenir d’anciennes feuilles de style.

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

Syntaxe

clip: auto;
clip: rect(<top>, <right>, <bottom>, <left>);
/* Each coordinate is a <length> or auto. */

clip découpe le rendu d’un élément, notamment son arrière-plan, ses bordures et ses descendants, sans réduire sa boîte de mise en page. En HTML, elle s’applique aux éléments positionnés de façon absolue, c’est-à-dire avec position: absolute ou position: fixed, et non avec relative ou static. Elle n’est pas héritée et sa valeur initiale est auto.

Dans rect(top, right, bottom, left), top et bottom sont des coordonnées mesurées depuis le bord supérieur de la boîte de bordure, tandis que right et left sont mesurées depuis son bord gauche. Il ne s’agit pas de quatre décalages depuis les côtés correspondants. Utilisez des virgules. Chaque coordonnée accepte une longueur ou auto ; les longueurs négatives sont autorisées, mais pas les pourcentages.

clip: auto n’introduit aucun découpage par l’intermédiaire de cette propriété. En revanche, rect(auto, auto, auto, auto) découpe selon la boîte de bordure : chaque auto dans rect() désigne le bord correspondant de cette boîte. Le découpage par des ancêtres peut toujours limiter la visibilité.

clip est obsolète ; choisissez clip-path pour le nouveau code. Ne transférez pas directement les nombres vers inset(), qui mesure des décalages depuis les côtés correspondants. En SVG, des règles supplémentaires déterminent les cas où clip s’applique ; elles couvrent les éléments qui établissent un nouveau viewport ainsi que les éléments pattern et mask.

Exemples

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>clip demo</title>
<style>
  body { margin: 0; background: white; }
  .box {
    position: absolute;
    top: 20px;
    left: 20px;
    width: 160px;
    height: 100px;
    background: #0066cc;
    clip: rect(10px, 130px, 80px, 30px);
  }
</style>
<div class="box"></div>
</html>

Résultat

Expected rendering: a blue rectangle 100 CSS px wide and 70 CSS px high, with its top-left corner 50 CSS px from the viewport's left edge and 30 CSS px from its top edge, on a white background.

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