Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / CSS

mask-size — dimensionamento das imagens de máscara

A propriedade mask-size define as dimensões das imagens das camadas de máscara, não as do próprio elemento. Aceita comprimentos, percentagens, auto, contain e cover; é possível definir tamanhos diferentes para várias camadas.

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

Sintaxe

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

mask-size redimensiona as imagens fornecidas por mask-image sem alterar as dimensões do elemento no esquema da página. O valor inicial é auto e a propriedade não é herdada. Por si só, não cria uma máscara.

Um comprimento ou uma percentagem especifica a largura, ficando a altura como auto; dois valores especificam, respetivamente, a largura e a altura. Os valores negativos não são válidos. As percentagens referem-se às dimensões correspondentes da área de posicionamento da máscara, determinada por mask-origin, e não às dimensões do ficheiro de imagem.

auto utiliza as dimensões naturais e a proporção da imagem, quando disponíveis. Com auto auto, um gradiente sem dimensões naturais preenche a área de posicionamento. contain preserva a proporção e ajusta toda a imagem a essa área; cover preserva a proporção e cobre toda a área, pelo que uma parte da imagem pode ultrapassá-la. Duas dimensões explícitas podem distorcer a proporção.

Os tamanhos de várias camadas são separados por vírgulas e seguem a ordem de mask-image. Se a lista for demasiado curta, é repetida; os valores excedentes são ignorados. mask-repeat controla separadamente a repetição da imagem. Exceção importante: se a origem for um elemento SVG mask, mask-size não tem efeito nessa camada; a geometria é definida por esse elemento.

Exemplos

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

Resultado

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.

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes