База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / CSS

url(): препратка към ресурс, не обещание за успешно зареждане

Пиши пътищата в кавички, отчитай базовия URL и различавай разчитането от изтеглянето на ресурс.

Версия: CSS Modules

Синтаксис

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

url() подава препратка към ресурс в контексти като background-image, източник на шрифт или SVG филтър. Низът в кавички е удобен за пътища с интервали или скоби. Формата без кавички има по-строги правила за екраниране; неекраниран вътрешен интервал не се приема като част от URL токена. Обикновен низ може да замени функцията само където е изрично позволен, например в @import.

Относителните препратки във външен CSS файл се основават на местоположението на този файл. Вградените и inline стилове използват базовия URL на документа. Затова преместването на CSS файла в друга папка може да наруши относителните му препратки към изображения, без HTML адресът да се промени. Препратка само с фрагмент, например url("#filter"), има правила за локални препратки към елементи в съответното дърво; не е просто обикновен относителен път до файл.

Приетият синтаксис е отделен от наличността на ресурса, правилата за разрешени заявки и пригодността на формата за избраното свойство. Празното url("") е невалиден ресурс, не инструкция за зареждане на текущата страница. url(var(--path)) също не работи заради специалното разчитане на URL токените. Честа алтернатива е цялото url("...") да се запази в потребителско свойство, а var() да се използва като стойност на свойството.

Примерът задава база на документа под /pages/ и измерва inline относителна препратка, разрешена до /pages/tiles/pattern.svg. Абсолютният адрес /assets/pattern.svg остава абсолютен. Проверката за интервал в кавички връща true, без кавички — false, а празната препратка се сериализира като url(""). Външните заявки са блокирани в записания тест: той проверява синтаксиса и изчисления URL, не успешно изтегляне или показване на изображения.

Примери

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

Резултат

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

Запазеният домейн example.invalid обозначава примерните адреси. Примерът използва inline стилове; правилото за базата на външен CSS файл е обяснено в текста, а не представено като изпълнен мрежов тест.

Източници