WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / CSS

border-image-width — Stärke des Bildrahmens

border-image-width steuert die Stärke der Bildstreifen eines Rahmens, nicht den im Layout für den Rahmen reservierten Platz. Zulässig sind Längen, Prozentwerte, border-width-Multiplikatoren oder auto.

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

Syntax

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

border-image-width legt die Abstände nach innen von den Kanten des Rahmenbildbereichs fest, der standardmäßig der Border-Box entspricht. Die Eigenschaft verändert das Layout nicht; der für den Rahmen reservierte Platz hängt von border-width und border-style ab. border-image-slice schneidet das Quellbild zu, während diese Eigenschaft die Stärke der entstehenden Streifen bestimmt.

Der Anfangswert ist 1; die Eigenschaft wird nicht vererbt. Eine einheitenlose Zahl multipliziert den berechneten border-width der jeweiligen Seite. Eine Länge legt die Stärke direkt fest. Prozentwerte beziehen sich oben und unten auf die Höhe des Bereichs und links und rechts auf dessen Breite. auto verwendet die natürliche Abmessung des entsprechenden Ausschnitts; ist diese nicht verfügbar, wird der berechnete border-width verwendet.

Es können 1–4 Werte angegeben werden: ein Wert für alle Seiten; zwei für oben/unten und links/rechts; drei für oben, links/rechts und unten; vier in der Reihenfolge oben, rechts, unten, links. Negative Werte sind ungültig. Überlappen sich gegenüberliegende Streifen, werden alle Stärken proportional verringert.

Im Beispiel erzeugt 2 1 oben und unten 20px starke Streifen und an den Seiten 10px starke Streifen; die Border-Box bleibt jedoch 220px × 100px groß. Die dickeren Streifen werden nach innen gemalt, ohne zusätzlichen Platz zu reservieren.

Beispiele

<!doctype html>
<meta charset="utf-8">
<title>border-image-width</title>
<style>
  .frame {
    box-sizing: content-box;
    width: 200px;
    height: 80px;
    padding: 0;
    border: 10px solid black;
    border-image-source: linear-gradient(#0066cc, #0066cc);
    border-image-slice: 1;
    border-image-width: 2 1;
    border-image-repeat: stretch;
  }
</style>
<div class="frame"></div>

Ergebnis

Expected: a blue frame with 20px top and bottom image bands and 10px left and right image bands. The border box remains 220px × 100px.

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen