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

CKTIS / CSS

border-image-slice — découper une image de bordure

border-image-slice définit les lignes de découpe qui répartissent une image de bordure entre les coins, les côtés et le centre. Le mot-clé facultatif fill conserve la partie centrale.

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

Syntaxe

border-image-slice: [ <number [0,∞]> | <percentage [0,∞]> ]{1,4} && fill?;

border-image-slice divise l’image de border-image-source en neuf zones : quatre coins, quatre côtés et un centre. Cette propriété définit les découpes dans l’image source, et non l’épaisseur de la bordure dessinée ; c’est border-image-width qui la contrôle. La valeur initiale est 100% ; la propriété n’est pas héritée.

Indiquez une à quatre valeurs : une seule s’applique à tous les côtés ; deux s’appliquent au haut/bas et à la droite/gauche ; trois au haut, à la droite/gauche et au bas ; quatre au haut, à la droite, au bas et à la gauche. Les nombres sans unité représentent des pixels d’une image matricielle ou des coordonnées d’une image vectorielle. Les pourcentages se rapportent à la hauteur de l’image pour le haut/bas et à sa largeur pour la droite/gauche. Les unités comme px et les valeurs négatives ne sont pas autorisées.

Sans fill, le centre est supprimé ; avec fill, il est conservé. Les valeurs qui dépassent les dimensions de l’image sont interprétées comme 100%. Lorsque des découpes opposées se rejoignent ou se chevauchent, les côtés correspondants et le centre deviennent vides.

L’exemple utilise un dégradé local, sans téléchargement de fichiers : le résultat attendu est un intérieur blanc et une bordure bleue. En remplaçant la valeur par 25% fill, l’intérieur devrait également devenir bleu. Une vérification dans le navigateur cible reste nécessaire.

Exemples

<!doctype html>
<meta charset="utf-8">
<title>border-image-slice</title>
<style>
  .frame {
    width: 200px;
    height: 100px;
    border: 12px solid black;
    background: white;
    border-image-source: linear-gradient(#0066cc, #0066cc);
    border-image-slice: 25%;
    border-image-width: 1;
    border-image-repeat: stretch;
  }
</style>
<div class="frame"></div>

Résultat

A 200 × 100 CSS-pixel white interior surrounded by a solid blue (#0066cc), 12 CSS-pixel border.

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