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

CKTIS / CSS

border-image-width — grosor del borde de imagen

border-image-width controla el grosor de las bandas de la imagen del borde, no el espacio que el diseño reserva para los bordes. Acepta longitudes, porcentajes, multiplicadores de border-width o auto.

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

Sintaxis

border-image-width: [ <length-percentage [0,∞]> | <number [0,∞]> | auto ]{1,4};

border-image-width define las distancias hacia el interior desde los bordes del área de la imagen del borde, que por defecto coincide con la border box. No modifica el diseño; el espacio reservado para el borde depende de border-width y border-style. border-image-slice recorta la imagen de origen, mientras que esta propiedad establece el grosor de las bandas resultantes.

El valor inicial es 1; la propiedad no se hereda. Un número sin unidad multiplica el border-width calculado del lado correspondiente. Una longitud establece el grosor directamente. Los porcentajes usan la altura del área para arriba y abajo, y su anchura para izquierda y derecha. auto usa la dimensión natural del corte correspondiente o, si no está disponible, el border-width calculado.

Se pueden indicar de 1 a 4 valores: uno para todos los lados; dos para arriba/abajo e izquierda/derecha; tres para arriba, izquierda/derecha y abajo; cuatro en el orden arriba, derecha, abajo, izquierda. Los valores negativos no son válidos. Si se solapan bandas opuestas, todos los grosores se reducen proporcionalmente.

En el ejemplo, 2 1 produce bandas de 20px arriba y abajo, y de 10px en los lados, pero la border box sigue midiendo 220px × 100px. Las bandas más gruesas se pintan hacia dentro sin reservar espacio adicional.

Ejemplos

<!doctype html>
<meta charset="utf-8">
<title>border-image-width</title>
<style>
  .frame {
    box-sizing: content-box;
    width: 200px;
    height: 80px;
    padding: 0;
    border: 10px solid black;
    border-image-source: linear-gradient(#0066cc, #0066cc);
    border-image-slice: 1;
    border-image-width: 2 1;
    border-image-repeat: stretch;
  }
</style>
<div class="frame"></div>

Resultado

Expected: a blue frame with 20px top and bottom image bands and 10px left and right image bands. The border box remains 220px × 100px.

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