Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / CSS

@import — wczytanie zewnętrznego arkusza

Reguła @import wczytuje arkusz CSS pod wskazanym adresem i może ograniczyć jego zastosowanie warstwą, warunkiem obsługi lub zapytaniem medialnym.

Wersja: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required

Składnia

@import [ <string> | <url> ]
        [ layer | layer(<layer-name>) ]?
        [ supports( [ <supports-condition> | <declaration> ] ) ]?
        <media-query-list>? ;

@import <url-or-string> [layer | layer(<name>)]? [supports(<condition>)]? <media-query-list>?; jest regułą instrukcyjną zakończoną średnikiem. Importowane reguły zachowują się tak, jakby znajdowały się w miejscu importu. Kwalifikator layer umieszcza je w anonimowej albo nazwanej warstwie, supports() zapobiega pobraniu przy niespełnionym warunku, a lista mediów ogranicza zastosowanie.

@import musi poprzedzać zwykłe reguły stylu i większość innych reguł; wcześniej mogą wystąpić deklaracja kodowania i dozwolone instrukcje kolejności warstw. Reguła umieszczona w bloku albo po niedozwolonej regule jest ignorowana. Adres względny rozwiązuje się względem arkusza zawierającego import, nie dokumentu HTML.

Każdy import może wydłużyć ścieżkę pobierania i opóźnić uzyskanie stylów, dlatego w produkcji często korzystniejsze są <link> lub bundling. Błąd pobrania nie usuwa pozostałej części arkusza. Przykład ładuje arkusz Blob, który importuje drugi arkusz data:; po zdarzeniu load odczytuje osobno wartość z importu i lokalnej reguły.

Przykłady

const css = '@import url("data:text/css,.probe%7B--from-import%3Aloaded%7D"); .probe { --local: ready; }';
const url = URL.createObjectURL(new Blob([css], {type: 'text/css'}));
const link = document.createElement('link');
link.rel = 'stylesheet';
link.href = url;
document.head.append(link);
await new Promise((resolve, reject) => { link.onload = resolve; link.onerror = reject; });
const probe = document.createElement('div');
probe.className = 'probe';
document.body.append(probe);
const computed = getComputedStyle(probe);
console.log('import=' + computed.getPropertyValue('--from-import').trim() + '; local=' + computed.getPropertyValue('--local').trim());
URL.revokeObjectURL(url);

Wynik

import=loaded; local=ready

Reguła @import wczytuje arkusz CSS pod wskazanym adresem i może ograniczyć jego zastosowanie warstwą, warunkiem obsługi lub zapytaniem medialnym.

Źródła