Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / CSS

border-image-source — origen de la imagen del borde

La propiedad border-image-source selecciona una imagen que sustituye al borde CSS normal. Acepta none o <image>, incluidos los degradados. Define el origen; las demás propiedades border-image-* controlan el recorte y la colocación.

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

Sintaxis

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

border-image-source acepta none o <image>, por ejemplo url("frame.png") o linear-gradient(...). Su valor inicial es none; no se hereda y su tipo de animación es discreto. Si la imagen está disponible, sustituye al borde normal. Con none, o si no se puede mostrar la imagen, se utiliza el borde normal.

El origen no define el recorte: de eso se encarga border-image-slice. border-image-width, border-image-outset y border-image-repeat controlan la anchura, la extensión y la repetición de los fragmentos. El centro de la imagen se descarta de forma predeterminada; la palabra clave fill en border-image-slice lo conserva.

Los bordes con imagen no cambian el diseño: el espacio reservado sigue dependiendo de border-width y border-style. Establece border antes que las propiedades border-image-*, porque esa propiedad abreviada las restablece. La propiedad no se aplica a los elementos internos de una tabla cuando border-collapse: collapse.

El ejemplo utiliza un degradado sin archivos externos. El resultado esperado es un área de contenido blanca de 160 × 80 px con un borde de 12 px, azul a la izquierda y rojo a la derecha. Si cambias border-image-source a none, debería aparecer un borde negro sin que cambien las dimensiones.

Ejemplos

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

Resultado

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

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes