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

CKTIS / CSS

border-image-outset — étendre la zone de l’image de bordure

La propriété border-image-outset étend la zone de l’image de bordure au-delà de la boîte de bordure, sans agrandir la boîte de mise en page de l’élément. Elle accepte des longueurs ou des multiplicateurs sans unité des largeurs de bordure correspondantes.

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

Syntaxe

border-image-outset: [ <length [0,∞]> | <number [0,∞]> ]{1,4};

border-image-outset indique jusqu’où la zone de l’image de bordure dépasse de la boîte de bordure. Elle ne remplace pas border-image-source. Sa valeur initiale est 0 et elle n’est pas héritée. Contrairement à border-image-width, qui dimensionne les bandes de l’image vers l’intérieur à partir des bords de cette zone, elle contrôle son extension vers l’extérieur.

Indiquez une à quatre valeurs non négatives. Une valeur s’applique à tous les côtés ; deux correspondent à haut/bas et droite/gauche ; trois à haut, droite/gauche et bas ; quatre à haut, droite, bas et gauche. Une longueur définit directement le dépassement. Un nombre sans unité multiplie le border-width calculé du côté correspondant, et non border-image-width. Les pourcentages et les valeurs négatives ne sont pas valides.

L’image qui dépasse ne réserve aucun espace dans la mise en page, ne déclenche pas de défilement et ne capte pas les événements de souris en dehors de la boîte de bordure. Un ancêtre ou la fenêtre d’affichage peut la rogner. Une utilisation ultérieure du raccourci border-image réinitialise les composants omis, y compris le dépassement, à leurs valeurs initiales.

Exemples

<!doctype html>
<meta charset="utf-8">
<title>border-image-outset</title>
<style>
  .box {
    margin: 40px;
    width: 160px;
    height: 80px;
    border: 8px solid transparent;
    border-image-source: linear-gradient(#006699, #006699);
    border-image-slice: 1;
    border-image-width: 1;
    border-image-outset: 2 12px;
    outline: 1px dashed #cc0000;
    background: #eeeeee;
  }
</style>
<div class="box"></div>

Résultat

Expected: a blue image border extends 16px beyond the border box at the top and bottom, and 12px at the left and right. The border box remains 176px × 96px.

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