CKTIS / CSS
border-image-source — obraz obramowania
Właściwość border-image-source wybiera obraz używany zamiast zwykłego obramowania CSS. Przyjmuje none lub <image>, w tym gradient. Określa źródło, natomiast cięciem i rozmieszczeniem obrazu sterują inne właściwości border-image-*.
Wersja: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Składnia
border-image-source: none | <image>;border-image-source przyjmuje none albo <image>, np. url("frame.png") lub linear-gradient(...). Wartością początkową jest none; właściwość nie jest dziedziczona, a jej animacja jest dyskretna. Jeśli obraz jest dostępny, zastępuje zwykłe obramowanie. Przy none lub niemożności wyświetlenia obrazu używane jest zwykłe obramowanie.
Źródło nie określa sposobu cięcia: odpowiada za to border-image-slice. Właściwości border-image-width, border-image-outset i border-image-repeat sterują szerokością, wysunięciem i powtarzaniem fragmentów. Środek obrazu jest domyślnie odrzucany; zachowuje go słowo fill w border-image-slice.
Obramowanie obrazkowe nie zmienia układu: miejsce nadal zależy od border-width i border-style. Ustaw border przed właściwościami border-image-*, ponieważ ten skrót je resetuje. Właściwość nie dotyczy wewnętrznych elementów tabeli przy border-collapse: collapse.
Przykład używa gradientu bez plików zewnętrznych. Oczekiwany efekt to biały obszar treści 160 × 80 px z obramowaniem 12 px, niebieskim po lewej i czerwonym po prawej. Zmiana border-image-source na none powinna pokazać czarne obramowanie bez zmiany wymiarów.
Przykłady
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>border-image-source</title>
<style>
.frame {
width: 160px;
height: 80px;
border: 12px solid black;
border-image-source: linear-gradient(to right, #0000ff, #ff0000);
border-image-slice: 1;
background: white;
}
</style>
<div class="frame"></div>
</html>Wynik
A white 160 × 80 px content area surrounded by a 12 px gradient border, blue on the left and red on the right.
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.