CKTIS / CSS
mask-size — de grootte van maskeringsafbeeldingen instellen
De eigenschap mask-size stelt de afmetingen in van afbeeldingen in maskerlagen, niet van het element zelf. De eigenschap accepteert lengtes, percentages, auto, contain en cover; voor meerdere lagen kunnen afzonderlijke groottes worden opgegeven.
Versie: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Syntax
mask-size: <bg-size>#;
<bg-size> = [ <length-percentage [0,∞]> | auto ]{1,2} | cover | contain;mask-size schaalt afbeeldingen die via mask-image worden aangeleverd, zonder de afmetingen van het element in de lay-out te veranderen. De beginwaarde is auto en de eigenschap wordt niet overgeërfd. Op zichzelf maakt de eigenschap geen masker.
Eén lengte of percentage bepaalt de breedte; de hoogte is dan standaard auto. Twee waarden bepalen achtereenvolgens de breedte en de hoogte. Negatieve waarden zijn ongeldig. Percentages verwijzen naar de overeenkomstige afmetingen van het maskerpositioneringsgebied, dat wordt bepaald door mask-origin, en niet naar de afmetingen van het afbeeldingsbestand.
auto gebruikt de natuurlijke afmetingen en beeldverhouding van de afbeelding, indien beschikbaar. Een verloop zonder natuurlijke afmetingen vult met auto auto het positioneringsgebied. contain behoudt de beeldverhouding en past de volledige afbeelding binnen dat gebied; cover behoudt de beeldverhouding en bedekt het hele gebied, waardoor een deel van de afbeelding erbuiten kan vallen. Twee expliciete afmetingen kunnen de beeldverhouding vervormen.
Afzonderlijke groottes voor meerdere lagen worden met komma’s gescheiden en volgen de volgorde van mask-image. Een te korte lijst wordt herhaald; overtollige waarden worden genegeerd. mask-repeat bepaalt afzonderlijk hoe de afbeelding wordt herhaald. Belangrijke uitzondering: als de bron een SVG-mask-element is, heeft mask-size geen effect op die laag; dat element bepaalt de geometrie.
Voorbeelden
<!doctype html>
<meta charset="utf-8">
<title>mask-size</title>
<style>
body { margin: 20px; background: white; }
.sample {
width: 240px;
height: 120px;
background: #0066cc;
mask-image: linear-gradient(black, black);
mask-mode: alpha;
mask-origin: border-box;
mask-size: 50% 100%;
mask-position: center;
mask-repeat: no-repeat;
}
</style>
<div class="sample"></div>Resultaat
A 120 × 120 CSS-pixel blue square is visible, centered horizontally within a 240 × 120 CSS-pixel element; the remaining area shows the white page background.
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.