CKTIS / CSS
url(): riferimento a una risorsa, non promessa di caricamento
Scrivi percorsi tra virgolette, comprendine l’URL di base e separa l’analisi dal recupero di una risorsa utilizzabile.
Versione: CSS Modules
Sintassi
background-image: url("images/pattern.svg");url() fornisce un riferimento a una risorsa in contesti come background-image, una sorgente di font o un riferimento a un filtro SVG. Una stringa tra virgolette è comoda quando il percorso contiene spazi o parentesi. La forma senza virgolette ha regole di escape più rigide; uno spazio interno senza escape non viene accettato nel suo token URL. Una semplice stringa al posto della funzione è consentita solo nei contesti che lo permettono espressamente, come @import.
I riferimenti relativi in un foglio di stile esterno si basano sulla posizione di quel foglio. Il CSS incorporato e gli stili inline usano la base del documento che li contiene. Spostare un foglio in un’altra cartella può quindi interrompere i suoi percorsi relativi delle immagini senza cambiare l’indirizzo HTML. Un riferimento composto solo da un frammento, come url("#filter"), segue regole locali per gli elementi dell’albero pertinente; non è semplicemente un normale percorso relativo di file.
La sintassi accettata è distinta dalla disponibilità della risorsa, dalle politiche che consentono le richieste e da un formato utilizzabile nella proprietà scelta. Un url("") vuoto è una risorsa non valida, non un’istruzione per caricare la pagina corrente. Anche url(var(--path)) fallisce per via dell’analisi speciale dei token URL; un’alternativa comune consiste nel memorizzare l’intero valore url("...") in una proprietà personalizzata e usare var() come valore della proprietà.
L’esempio imposta una base del documento sotto /pages/ e misura un riferimento relativo inline risolto in /pages/tiles/pattern.svg. L’indirizzo assoluto contenente /assets/pattern.svg resta assoluto. La verifica dello spazio tra virgolette restituisce true, quella senza virgolette false e il riferimento vuoto viene serializzato come url(""). Nel test registrato le richieste esterne sono bloccate: si verificano la sintassi e la risoluzione calcolata degli URL, non download riusciti o immagini visualizzate.
Esempi
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);Risultato
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("")L’host riservato example.invalid rende esplicita la natura illustrativa degli indirizzi. L’esempio usa stili inline; la regola separata sulle basi dei fogli esterni è spiegata nel testo e non viene presentata come un test di rete eseguito.