CKTIS / CSS
mask-size — određivanje veličine slika maske
Svojstvo mask-size određuje dimenzije slika u slojevima maske, a ne samog elementa. Prihvaća duljine, postotke, auto, contain i cover; za više slojeva mogu se zadati zasebne veličine.
Verzija: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Sintaksa
mask-size: <bg-size>#;
<bg-size> = [ <length-percentage [0,∞]> | auto ]{1,2} | cover | contain;mask-size mijenja veličinu slika zadanih pomoću mask-image bez promjene dimenzija elementa u rasporedu stranice. Početna vrijednost je auto, a svojstvo se ne nasljeđuje. Samo po sebi ne stvara masku.
Jedna duljina ili postotna vrijednost određuje širinu, a visina je prema zadanim postavkama auto; dvije vrijednosti određuju širinu pa visinu. Negativne vrijednosti nisu valjane. Postotci se odnose na odgovarajuće dimenzije područja pozicioniranja maske, koje određuje mask-origin, a ne na dimenzije datoteke slike.
auto upotrebljava prirodne dimenzije i omjer širine i visine slike kada su dostupni. Gradijent bez prirodnih dimenzija pri auto auto ispunjava područje pozicioniranja. contain čuva omjer širine i visine te smješta cijelu sliku unutar tog područja; cover čuva omjer i prekriva cijelo područje, pa dio slike može izlaziti izvan njega. Dvije izričito zadane dimenzije mogu izobličiti omjer.
Veličine za više slojeva odvajaju se zarezima i prate redoslijed u mask-image. Prekratak popis ponavlja se, a suvišne vrijednosti zanemaruju se. mask-repeat zasebno upravlja ponavljanjem slike. Važna iznimka: ako je izvor SVG element mask, mask-size ne utječe na taj sloj; njegovu geometriju određuje taj element.
Primjeri
<!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>Rezultat
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.
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.