Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / CSS

url(): odwołanie do zasobu, a nie obietnica jego wczytania

Zapisuj ścieżki w cudzysłowie, rozumiej ich adres bazowy i oddziel składnię od pobrania użytecznego zasobu.

Wersja: CSS Modules

Składnia

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

url() podaje odwołanie do zasobu między innymi w background-image, źródle fontu lub odwołaniu do filtra SVG. Tekst w cudzysłowie jest wygodny, gdy ścieżka zawiera spacje lub nawiasy. Postać bez cudzysłowu ma ostrzejsze zasady zapisu znaków specjalnych; niepoprzedzona znakiem ucieczki wewnętrzna spacja nie jest przyjmowana jako część tokenu URL. Zwykły tekst zamiast funkcji jest dozwolony tylko w kontekstach, które to jawnie dopuszczają, np. @import.

Odwołania względne w zewnętrznym arkuszu stylów liczone są od położenia tego arkusza. CSS osadzony w dokumencie i style inline używają adresu bazowego dokumentu. Dlatego przeniesienie arkusza do innego katalogu może zepsuć względne ścieżki obrazów bez zmiany adresu HTML. Odwołanie zawierające tylko fragment, np. url("#filter"), ma lokalne reguły wyszukiwania elementów w odpowiednim drzewie; nie jest po prostu zwykłą względną ścieżką pliku.

Poprawna składnia jest czymś innym niż dostępność zasobu, dozwolone zasady żądań i format użyteczny w danej właściwości. Puste url("") oznacza nieprawidłowy zasób, a nie polecenie wczytania bieżącej strony. url(var(--path)) również nie działa ze względu na specjalne rozpoznawanie tokenu URL; typowym rozwiązaniem jest zapisanie całego url("...") we właściwości własnej i użycie var() jako wartości właściwości.

Przykład ustawia bazę dokumentu w /pages/ i mierzy rozwiązanie względnego odwołania inline do /pages/tiles/pattern.svg. Bezwzględny adres /assets/pattern.svg pozostaje bezwzględny. Kontrola spacji w cudzysłowie daje true, bez cudzysłowu false, a puste odwołanie jest zapisywane jako url(""). W zapisanym teście żądania zewnętrzne są zablokowane: sprawdza on składnię i obliczony adres URL, a nie udane pobranie lub wyświetlenie obrazów.

Przykłady

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);

Wynik

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("")

Zarezerwowana domena example.invalid jasno oznacza adresy ilustracyjne. Przykład używa stylów inline; osobna reguła baz zewnętrznych arkuszy jest opisana w tekście i nie jest przedstawiana jako wykonany test sieciowy.

Źródła