CKTIS / CSS
url(): referência a um recurso, não promessa de carregamento
Escreve caminhos entre aspas, compreende o seu URL base e separa a análise da obtenção de um recurso utilizável.
Versão: CSS Modules
Sintaxe
background-image: url("images/pattern.svg");url() fornece uma referência a um recurso em contextos como background-image, uma origem de tipo de letra ou uma referência a um filtro SVG. Uma cadeia entre aspas é conveniente quando o caminho contém espaços ou parênteses. A forma sem aspas tem regras de escape mais restritas; um espaço interno sem escape não é aceite como parte do seu token URL. Uma cadeia simples em vez da função só é permitida em contextos que o autorizem expressamente, como @import.
As referências relativas numa folha de estilos externa baseiam-se na localização dessa folha. O CSS incorporado e os estilos inline usam a base do documento que os contém. Assim, mover uma folha para outra pasta pode quebrar os caminhos relativos das suas imagens sem alterar o endereço HTML. Uma referência apenas com fragmento, como url("#filter"), segue regras de referência local para elementos da árvore aplicável; não é simplesmente um caminho relativo normal de ficheiro.
A sintaxe aceite é distinta da disponibilidade do recurso, das políticas que permitem pedidos e de um formato utilizável na propriedade escolhida. Um url("") vazio é um recurso inválido, não uma instrução para carregar a página atual. url(var(--path)) também falha devido à análise especial dos tokens URL; uma alternativa comum consiste em guardar o valor completo url("...") numa propriedade personalizada e usar var() como valor da propriedade.
O exemplo define uma base de documento em /pages/ e mede uma referência relativa inline resolvida para /pages/tiles/pattern.svg. O endereço absoluto que contém /assets/pattern.svg continua absoluto. A verificação do espaço entre aspas devolve true, a do espaço sem aspas false, e a referência vazia é serializada como url(""). Os pedidos externos são bloqueados no teste registado: verifica-se a sintaxe e a resolução calculada dos URL, não transferências bem-sucedidas nem imagens apresentadas.
Exemplos
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("")O anfitrião reservado example.invalid torna explícito o caráter ilustrativo dos endereços. O exemplo usa estilos inline; a regra separada para as bases de folhas externas é explicada no texto, não apresentada como um teste de rede executado.