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.