CKTIS / CSS
url(): bronverwijzing, geen garantie op laden
Schrijf paden tussen aanhalingstekens, begrijp hun basis-URL en scheid het ontleden van het ophalen van een bruikbare bron.
Versie: CSS Modules
Syntax
background-image: url("images/pattern.svg");url() geeft een bronverwijzing in contexten zoals background-image, een lettertypebron of een verwijzing naar een SVG-filter. Een tekenreeks tussen aanhalingstekens is handig als een pad spaties of haakjes bevat. De vorm zonder aanhalingstekens heeft strengere escape-regels; een interne spatie zonder escape wordt niet als onderdeel van het URL-token geaccepteerd. Een gewone tekenreeks in plaats van de functie mag alleen in contexten die dat uitdrukkelijk toestaan, zoals @import.
Relatieve verwijzingen in een extern stijlblad zijn gebaseerd op de locatie van dat stijlblad. Ingebedde CSS en inline-stijlen gebruiken de basis van het bevattende document. Een stijlblad naar een andere map verplaatsen kan dus zijn relatieve afbeeldingspaden breken zonder het HTML-adres te wijzigen. Een verwijzing met alleen een fragment, zoals url("#filter"), volgt lokale verwijzingsregels voor elementen in de toepasselijke boom; het is niet zomaar een gewoon relatief bestandspad.
Geaccepteerde syntax staat los van de beschikbaarheid van de bron, het beleid dat verzoeken toestaat en een formaat dat voor de gekozen eigenschap bruikbaar is. Een lege url("") is een ongeldige bron, geen instructie om de huidige pagina te laden. Ook url(var(--path)) mislukt door de bijzondere ontleding van URL-tokens; een gebruikelijk alternatief is de volledige waarde url("...") op te slaan in een aangepaste eigenschap en var() te gebruiken als eigenschapswaarde.
Het voorbeeld stelt een documentbasis onder /pages/ in en meet een relatieve inline-verwijzing die wordt opgelost naar /pages/tiles/pattern.svg. Het absolute adres met /assets/pattern.svg blijft absoluut. De controle met een spatie tussen aanhalingstekens geeft true, die zonder aanhalingstekens false, en de lege verwijzing wordt geserialiseerd als url(""). Externe verzoeken zijn in de vastgelegde test geblokkeerd: de test controleert syntax en berekende URL-resolutie, geen geslaagde downloads of getoonde afbeeldingen.
Voorbeelden
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);Resultaat
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("")De gereserveerde host example.invalid maakt duidelijk dat de adressen voorbeelden zijn. Het voorbeeld gebruikt inline-stijlen; de aparte regel voor de basis van externe stijlbladen wordt in de tekst uitgelegd en niet als uitgevoerde netwerktest gepresenteerd.