CKTIS / CSS
@position-try — nazwana opcja położenia awaryjnego
Reguła @position-try definiuje położenie awaryjne dla zakotwiczonego pudełka, wybierane wtedy, gdy preferowany wariant powoduje przepełnienie.
Wersja: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Składnia
@position-try <dashed-ident> {
<declaration-list>
}@position-try <dashed-ident> { <declaration-list> } nadaje nazwę niestandardowej opcji położenia. Nazwę wskazuje właściwość position-try-fallbacks; styl bazowy jest sprawdzany jako pierwszy, a kolejne opcje są próbowane w zadanej kolejności, gdy pudełko przepełnia swój obszar zawierający zmodyfikowany przez insety. Reguły o tej samej nazwie kaskadują podobnie do reguł klatek kluczowych.
Blok przyjmuje wyłącznie właściwości insetów, marginesów, rozmiaru, samowyrównania, kotwicy oraz position-area. Flaga !important unieważnia daną deklarację, ale nie całą regułę. Deklaracje działają w specjalnym źródle kaskady między zwykłym źródłem autora a animacjami, dlatego mogą zastąpić bazowe położenie bez zmiany kolorów lub treści komponentu.
Typowe zastosowanie to dymek, menu albo etykieta, która ma przejść na drugą stronę kotwicy przy krawędzi ekranu. Przykład preferuje block-start, definiuje opcję --below z block-end, a następnie mierzy oba pudełka. Brak miejsca nad kotwicą wymusza wariant dolny; odczyt CSSPositionTryRule potwierdza również, że silnik zachował regułę w CSSOM.
Przykłady
const style = document.createElement('style');
style.textContent = `.anchor { position: fixed; inset: 0 auto auto 100px; inline-size: 60px; block-size: 20px; anchor-name: --trigger; }
.popup { position: fixed; position-anchor: --trigger; position-area: block-start; position-try-fallbacks: --below; inline-size: 80px; block-size: 30px; }
@position-try --below { position-area: block-end; }`;
document.head.append(style);
const anchor = document.createElement('div');
anchor.className = 'anchor';
const popup = document.createElement('div');
popup.className = 'popup';
document.body.append(anchor, popup);
await new Promise(requestAnimationFrame);
const anchorRect = anchor.getBoundingClientRect();
const popupRect = popup.getBoundingClientRect();
const rule = [...style.sheet.cssRules].find(item => item.cssText.startsWith('@position-try'));
console.log('rule=' + rule.constructor.name + '; fallback=' + (popupRect.top >= anchorRect.bottom ? 'below' : 'above') + '; anchor-bottom=' + anchorRect.bottom + '; popup-top=' + popupRect.top);Wynik
rule=CSSPositionTryRule; fallback=below; anchor-bottom=20; popup-top=20
Reguła @position-try definiuje położenie awaryjne dla zakotwiczonego pudełka, wybierane wtedy, gdy preferowany wariant powoduje przepełnienie.