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

CKTIS / CSS

url(): referencia a un recurso, no garantía de carga

Escribe rutas entre comillas, comprende su URL base y separa el análisis de la descarga de un recurso utilizable.

Versión: CSS Modules

Sintaxis

background-image: url("images/pattern.svg");

url() proporciona una referencia a un recurso en contextos como background-image, una fuente tipográfica o una referencia a un filtro SVG. Una cadena entre comillas resulta cómoda cuando la ruta contiene espacios o paréntesis. La forma sin comillas tiene reglas de escape más estrictas; un espacio interno sin escapar no se acepta como parte de su token URL. Solo se permite una cadena simple en lugar de la función en contextos que lo autorizan expresamente, como @import.

Las referencias relativas de una hoja de estilos externa se basan en la ubicación de esa hoja. El CSS incrustado y los estilos en línea usan la base del documento que los contiene. Por tanto, mover una hoja a otro directorio puede romper sus rutas relativas de imágenes sin cambiar la dirección HTML. Una referencia que solo contiene un fragmento, como url("#filter"), sigue reglas de referencia local a elementos del árbol correspondiente; no es simplemente una ruta relativa de archivo normal.

La sintaxis aceptada es distinta de la disponibilidad del recurso, las políticas que permiten las solicitudes y un formato utilizable en la propiedad elegida. Un url("") vacío es un recurso inválido, no una instrucción para cargar la página actual. url(var(--path)) también falla por el análisis especial de tokens URL; una alternativa habitual es guardar el valor completo url("...") en una propiedad personalizada y usar var() como valor de la propiedad.

El ejemplo establece una base de documento bajo /pages/ y mide una referencia relativa en línea que se resuelve como /pages/tiles/pattern.svg. La dirección absoluta que contiene /assets/pattern.svg sigue siendo absoluta. La prueba de espacio entre comillas devuelve true, la de espacio sin comillas false, y la referencia vacía se serializa como url(""). Las solicitudes externas se bloquean en la prueba registrada: se verifica la sintaxis y la resolución calculada de URL, no descargas correctas ni imágenes mostradas.

Ejemplos

const base=document.createElement('base');base.href='https://example.invalid/pages/';document.head.append(base);
const inline=document.createElement('div');inline.style.backgroundImage='url("tiles/pattern.svg")';document.body.append(inline);
const inlineResolved=getComputedStyle(inline).backgroundImage;
const absolute=document.createElement('div');absolute.style.backgroundImage='url("https://example.invalid/assets/pattern.svg")';document.body.append(absolute);
const absoluteResolved=getComputedStyle(absolute).backgroundImage;
inline.style.backgroundImage='url("")';const empty=getComputedStyle(inline).backgroundImage;
console.log('inline='+inlineResolved+'; absolute='+absoluteResolved+'; quoted-space='+CSS.supports('background-image','url("a b.svg")')+'; unquoted-space='+CSS.supports('background-image','url(a b.svg)')+'; empty='+empty);

Resultado

inline=url("https://example.invalid/pages/tiles/pattern.svg"); absolute=url("https://example.invalid/assets/pattern.svg"); quoted-space=true; unquoted-space=false; empty=url("")

El host reservado example.invalid deja claro que las direcciones son ilustrativas. El ejemplo usa estilos en línea; la regla separada sobre bases de hojas externas se explica en el texto y no se presenta como una prueba de red ejecutada.

Fuentes