Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła