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

CKTIS / CSS

inset() : une forme de base rectangulaire

Définissez un rectangle en retrait, éventuellement arrondi, pour le découpage ou l’habillage d’un flottant.

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

Syntaxe

clip-path: inset(10px 20px round 4px);

inset() définit une forme de base par des retraits vers l’intérieur d’une boîte de référence. Une à quatre valeurs se répartissent en haut, à droite, en bas et à gauche comme pour margin. La clause facultative round précise les rayons des coins. Les pourcentages dépendent de la dimension correspondante de la boîte. Si des retraits opposés dépassent cette dimension, la spécification les réduit proportionnellement au lieu de créer un rectangle négatif.

L’effet dépend de la propriété qui utilise la forme. Avec clip-path, elle découpe le rendu et limite la détection des points en dehors de la région visible, sans réduire la boîte de mise en page. Avec shape-outside, elle règle l’habillage du contenu en ligne autour d’un flottant. shape-outside n’effectue pas automatiquement le découpage visuel de clip-path.

L’exemple découpe un élément de 100 sur 80 pixels avec inset(10px 20px round 4px). La détection trouve l’élément à un point intérieur, mais pas dans la bande découpée. Sa taille mesurée dans la mise en page reste de 100 sur 80 pixels. Ces mesures distinguent le découpage d’une modification de largeur, de hauteur, de padding ou du flux du document.

Exemples

const element=document.createElement('div');element.id='clip-example';
element.style.cssText='position:fixed;left:0;top:0;width:100px;height:80px;background:blue;clip-path:inset(10px 20px round 4px)';
document.body.append(element);
const hit=(x,y)=>document.elementFromPoint(x,y)===element;
console.log('inside='+hit(50,40)+'; clipped='+hit(5,40)+'; layout='+element.getBoundingClientRect().width+'x'+element.getBoundingClientRect().height+'; clip='+getComputedStyle(element).clipPath);

Résultat

inside=true; clipped=false; layout=100x80; clip=inset(10px 20px round 4px)

Le point intérieur donne true et le point découpé false, tandis que la boîte garde ses dimensions initiales.

Sources