Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / CSS

border-image — un bordo basato su un’immagine

border-image è una proprietà abbreviata CSS che crea un bordo a partire da un’immagine o da una sfumatura. Definisce origine, ritaglio, larghezza, estensione e ripetizione, senza riservare spazio aggiuntivo nel layout.

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

Sintassi

border-image: <'border-image-source'> || <'border-image-slice'> [ / <'border-image-width'> | / <'border-image-width'>? / <'border-image-outset'> ]? || <'border-image-repeat'>;

border-image imposta cinque proprietà: border-image-source, border-image-slice, border-image-width, border-image-outset e border-image-repeat. I componenti omessi vengono riportati, rispettivamente, a none, 100%, 1, 0 e stretch. La proprietà non è ereditata.

L’immagine viene divisa in nove parti: angoli, bordi e centro. border-image-slice definisce i tagli usando numeri senza unità o percentuali; il centro viene scartato a meno che non si specifichi fill. Non confondere il ritaglio dell’immagine con la larghezza del bordo dipinto: un numero in border-image-width moltiplica il valore corrispondente di border-width.

Le barre separano larghezza ed estensione dal ritaglio: 1 / 1 / 0. La notazione 1 / / 4px omette la larghezza. I modi dei bordi sono stretch, repeat, round e space; due valori si applicano, nell’ordine, agli assi orizzontale e verticale.

L’immagine non modifica il layout: lo spazio dipende ancora da border-width e border-style. Imposta un bordo normale come alternativa nel caso in cui l’immagine non possa essere visualizzata. Inserisci border prima di border-image, perché un border successivo reimposta questa proprietà abbreviata. L’esempio usa una sfumatura senza file esterni.

Esempi

<!doctype html>
<meta charset="utf-8">
<title>border-image</title>
<style>
  .frame {
    width: 160px;
    height: 80px;
    border: 12px solid gray;
    border-image: linear-gradient(to right, #0066cc, #cc3300) 1 / 1 / 0 stretch;
    background: white;
  }
</style>
<div class="frame"></div>

Risultato

A 184px × 104px rectangular box with a white 160px × 80px interior and a 12px gradient border, blue at the left and red-orange at 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