Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / CSS

mask-size — nastavení velikosti obrázků masky

Vlastnost mask-size nastavuje rozměry obrázků ve vrstvách masky, nikoli samotného prvku. Přijímá délky, procenta, auto, contain a cover; pro více vrstev lze zadat různé velikosti.

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

Syntaxe

mask-size: <bg-size>#;
<bg-size> = [ <length-percentage [0,∞]> | auto ]{1,2} | cover | contain;

mask-size mění měřítko obrázků zadaných pomocí mask-image, aniž by měnila rozměry prvku v rozvržení stránky. Její počáteční hodnota je auto a vlastnost se nedědí. Sama o sobě masku nevytváří.

Jedna délka nebo procentuální hodnota určuje šířku a výška je ve výchozím stavu auto; dvě hodnoty určují postupně šířku a výšku. Záporné hodnoty nejsou platné. Procenta se vztahují k odpovídajícím rozměrům oblasti umístění masky, kterou určuje mask-origin, nikoli k rozměrům souboru obrázku.

auto používá přirozené rozměry a poměr stran obrázku, pokud jsou k dispozici. Přechod bez přirozených rozměrů při auto auto vyplní oblast umístění. contain zachová poměr stran a celý obrázek vměstná do této oblasti; cover zachová poměr stran a pokryje celou oblast, takže část obrázku může přesahovat. Dvě výslovně zadané rozměrové hodnoty mohou poměr stran zkreslit.

Velikosti více vrstev se oddělují čárkami a řídí se pořadím v mask-image. Příliš krátký seznam se opakuje; přebytečné hodnoty se ignorují. mask-repeat samostatně řídí opakování obrázku. Důležitá výjimka: pokud je zdrojem SVG prvek mask, mask-size na tuto vrstvu nemá vliv; její geometrii určuje tento prvek.

Příklady

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

Výsledek

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.

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje