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

CKTIS / CSS

background-clip — área de pintura do fundo

A propriedade background-clip define o limite de pintura do fundo de um elemento. Permite estender o fundo por baixo da borda, pará-lo na extremidade interior da borda ou restringi-lo à área de conteúdo.

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

Sintaxe

background-clip: border-box | padding-box | content-box;
/* Multiple layers: comma-separated values. */
/* Level 4 draft: <bg-clip>#; <bg-clip> = <visual-box> | [ border-area || text ] */

background-clip define a área de pintura do fundo, não o tamanho do elemento. O valor inicial é border-box; a propriedade não é herdada.

border-box inclui o conteúdo, o padding e a área por baixo da borda. padding-box exclui a borda e content-box exclui também o padding. O fundo é pintado por trás da borda, pelo que uma borda opaca pode ocultá-lo.

background-origin define a área de posicionamento da imagem de fundo; background-clip limita a sua pintura. Com várias camadas, os valores são separados por vírgulas; a cor de fundo usa o recorte da camada inferior. background-clip não tem efeito no elemento raiz.

A proposta de nível 4 acrescenta text, que recorta segundo a geometria do texto, e border-area, que recorta à área pintada pela borda, ignorando a transparência de border-color. A combinação dos dois corresponde à união das áreas. A sintaxe da proposta não comprova o suporte dos navegadores; estas extensões exigem verificação separada.

Exemplos

<!doctype html>
<meta charset="utf-8">
<title>background-clip</title>
<style>
  body { background: white; }
  .sample {
    width: 120px;
    height: 40px;
    margin: 12px;
    padding: 16px;
    border: 8px dashed black;
    background-color: gold;
  }
  .border { background-clip: border-box; }
  .padding { background-clip: padding-box; }
  .content { background-clip: content-box; }
</style>
<div class="sample border">border-box</div>
<div class="sample padding">padding-box</div>
<div class="sample content">content-box</div>

Resultado

Three boxes: border-box shows gold through the dashed border gaps; padding-box has white border gaps and gold padding; content-box has white border gaps and white padding, with gold only in the 120 × 40 CSS px content area.

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