border-image-repeat

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since February 2017.

Resumen

La propiedad CSS border-image-repeat define cómo se manejará la parte media de una imagen de borde para que coincida con el tamaño del borde. Tiene sintaxis de un valor, el cual describe el comportamiento de todos los lados, y otra sintaxis de dos valores, que establece diferentes valores para el comportamiento horizontal y vertical.

Valor inicial	`stretch`
Applies to	all elements, except internal table elements when `border-collapse` is `collapse`. It also applies to `::first-letter`.
Heredable	no
Valor calculado	como se especifica
Animation type (en-US)	discrete

Sintaxis

css

/* border-image-repeat: type */
border-image-repeat: stretch;

/* border-image-repeat: horizontal vertical */
border-image-repeat: round stretch;

/* Global values */
border-image-repeat: inherit;
border-image-repeat: initial;
border-image-repeat: unset;

Valores

type: Puede ser stretch, repeat, o round, que denotan cómo será tratada la imagen vertical y horizontalmente.
horizontal: Puede ser stretch, repeat, o round, denotando cómo será tratada la imagen horizontalmente.
vertical: Puede ser stretch, repeat, o round, denotando cómo será tratada la imagen verticalmente.
stretch: Palabra clave que indica que la imagen deberá ser estirada para cubrir el espacio entre dos bordes.
repeat: Palabra clave que indica que la imagen debe ser repetida hasta que cubra el espacio entre dos bordes.
round: Palabra clave que indica que la imagen debe ser repetida hasta que cubra el espacio entre dos bordes. Si la imagen no se ajusta después de repetirse un número íntegro de veces, la imagen es escalada para ajustarse.
space: La imagen es repetida hasta cubrir el área del elemento. Si no se cubre el área completa con un número de imágenes, el espacio extra es distribuido al rededor de éstas.

Sintaxis formal

border-image-repeat = 
  [ stretch | repeat | round | space ]{1,2}

Ejemplo

Contenido CSS

css

#borderImageRepetition {
  width: 260px;
  height: 80px;
  margin-bottom: 10px;
  border: 30px solid;
  border-image: url("border.png") 27;
  border-image-repeat: stretch; /* Puede ser modificado en el ejemplo en vivo */
}

<div id="borderImageRepetition"></div>
<select id="repetition">
  <option value="stretch">stretch</option>
  <option value="repeat">repeat</option>
  <option value="round">round</option>
  <option value="space">space</option>
  <option value="stretch repeat">stretch repeat</option>
  <option value="space round">space round</option>
</select>

var repetition = document.getElementById("repetition");
repetition.addEventListener("change", function (evt) {
  document.getElementById("borderImageRepetition").style.borderImageRepeat =
    evt.target.value;
});

Especificaciones

Specification
CSS Backgrounds and Borders Module Level 3 # the-border-image-repeat

Compatibilidad con navegadores

BCD tables only load in the browser

Véase también

css-tricks border-image