KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / CSS

container-name — querycontainers een naam geven

De eigenschap container-name geeft een element namen, zodat @container-regels een container kunnen selecteren. Alleen een naam toekennen schakelt groottequeries niet in; daarvoor is een geschikte container-type nodig.

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

Syntax

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

container-name geeft een element een of meer namen waarmee de containers die @container in aanmerking neemt, worden gefilterd. Een query selecteert de dichtstbijzijnde geschikte voorouder met de opgegeven naam; het element waarop de stijlen worden toegepast, wordt niet zelf bevraagd. Namen hoeven niet uniek te zijn.

De beginwaarde none betekent dat er geen naam is, niet dat alle queries zijn uitgeschakeld. De notatie <custom-ident>+ betekent een of meer door spaties gescheiden namen, zonder komma’s of aanhalingstekens, zoals panel sidebar. Hoofdletters en kleine letters maken verschil. none, and, not en or kunnen geen namen zijn; CSS-brede sleutelwoorden zijn evenmin namen.

De eigenschap geldt voor alle elementen, wordt niet overgeërfd en is niet animerbaar. Ze vervangt container-type niet. In een horizontale schrijfmodus maakt container-type: inline-size queries op de fysieke breedte (width) mogelijk. In een verticale schrijfmodus komt de inline-as echter overeen met de hoogte, waardoor een container met inline-size niet in aanmerking komt voor een query op width. Gebruik dan container-type: size om queries op beide assen mogelijk te maken. De verkorte schrijfwijze container: panel / inline-size stelt beide eigenschappen in; als het deel na / ontbreekt, wordt container-type teruggezet op normal.

Het voorbeeld gebruikt de standaard horizontale schrijfmodus en de container is 320px breed. De benoemde query met een drempel van 300px geeft de .card-afstammeling daarom een padding van 16px. Verander je de containernaam in other, dan komt de query niet meer overeen en blijft de padding 4px.

Voorbeelden

<!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>

Resultaat

16px

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen