Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / CSS

container-name — nazwy kontenerów zapytań

Właściwość container-name nadaje elementowi nazwy używane przez reguły @container do wyboru kontenera. Samo nadanie nazwy nie włącza zapytań o rozmiar: wymaga to odpowiedniego container-type.

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

Składnia

container-name: none | <custom-ident>+;

container-name przypisuje elementowi jedną lub więcej nazw, które filtrują kontenery rozpatrywane przez @container. Zapytanie wybiera najbliższego kwalifikującego się przodka o wskazanej nazwie; nie sprawdza samego stylowanego elementu. Nazwy nie muszą być unikatowe.

Wartość początkowa none oznacza brak nazwy, a nie wyłączenie wszystkich zapytań. Zapis <custom-ident>+ oznacza jedną lub więcej nazw rozdzielonych spacjami, bez przecinków i cudzysłowów, np. panel sidebar. Wielkość liter ma znaczenie. none, and, not i or nie mogą być nazwami; słowa kluczowe wspólne dla CSS również nie są nazwami.

Właściwość dotyczy wszystkich elementów, nie jest dziedziczona i nie jest animowalna. Nie zastępuje container-type. W poziomym trybie pisania container-type: inline-size umożliwia zapytania o fizyczną szerokość (width). W pionowym trybie pisania oś liniowa odpowiada jednak wysokości, więc kontener z inline-size nie kwalifikuje się do zapytania o width. Użyj wówczas container-type: size, aby umożliwić zapytania w obu osiach. Skrót container: panel / inline-size ustawia obie właściwości; pominięcie części po / resetuje container-type do normal.

W przykładzie obowiązuje domyślny poziomy tryb pisania, a kontener ma szerokość 320px, więc nazwane zapytanie z progiem 300px ustawia potomkowi .card wewnętrzny odstęp 16px. Zmiana nazwy kontenera na other powoduje brak dopasowania i pozostawia 4px.

Przykłady

<!doctype html>
<meta charset="utf-8">
<title>container-name</title>
<style>
  .panel {
    width: 320px;
    container-type: inline-size;
    container-name: panel sidebar;
  }
  .card { padding: 4px; }
  @container panel (min-width: 300px) {
    .card { padding: 16px; }
  }
</style>
<div class="panel">
  <div class="card">Card</div>
</div>
<script>
  const card = document.querySelector('.card');
  console.log(getComputedStyle(card).paddingTop);
</script>

Wynik

16px

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła