Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / CSS

border-image-source — origine dell’immagine del bordo

La proprietà border-image-source seleziona un’immagine che sostituisce il normale bordo CSS. Accetta none o <image>, compresi i gradienti. Definisce la sorgente; le altre proprietà border-image-* controllano il ritaglio e il posizionamento.

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

Sintassi

border-image-source: none | <image>;

border-image-source accetta none o <image>, ad esempio url("frame.png") o linear-gradient(...). Il valore iniziale è none; la proprietà non è ereditata e il suo tipo di animazione è discreto. Se disponibile, un’immagine sostituisce il bordo normale. Con none, o se l’immagine non può essere visualizzata, viene usato il bordo normale.

La sorgente non definisce il ritaglio: se ne occupa border-image-slice. border-image-width, border-image-outset e border-image-repeat controllano rispettivamente la larghezza, l’estensione e la ripetizione dei frammenti. Il centro dell’immagine viene scartato per impostazione predefinita; la parola chiave fill in border-image-slice lo conserva.

I bordi con immagine non modificano il layout: lo spazio riservato dipende ancora da border-width e border-style. Imposta border prima delle proprietà border-image-*, perché questa proprietà abbreviata le azzera. La proprietà non si applica agli elementi interni delle tabelle quando border-collapse: collapse.

L’esempio usa un gradiente senza file esterni. Il risultato atteso è un’area di contenuto bianca di 160 × 80 px con un bordo di 12 px, blu a sinistra e rosso a destra. Se imposti border-image-source su none, dovrebbe comparire un bordo nero senza variazioni delle dimensioni.

Esempi

<!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>

Risultato

A white 160 × 80 px content area surrounded by a 12 px gradient border, blue on the left and red on the right.

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti