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

CKTIS / CSS

shape-outside — contornar uma forma com texto

A propriedade shape-outside define o contorno em torno do qual o texto flui, em vez da habitual área retangular de flutuação de um elemento flutuante.

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

Sintaxe

shape-outside: none | [ <basic-shape> || <shape-box> ] | <image>;

shape-outside altera a área em torno da qual o texto flui, não o aspeto nem o modelo de caixa do elemento. A utilização habitual requer um elemento flutuante, por exemplo com float: left; o texto flui então à sua direita. O rascunho de nível 1 também abrange caixas de letras capitulares.

O valor inicial é none; a propriedade não é herdada. Indique uma forma, como circle(), uma caixa de referência ou uma imagem. Sem uma caixa explícita, a forma utiliza margin-box. O canal alfa de uma imagem determina o seu contorno. Uma imagem indicada por um URL tem de ser carregada com êxito de acordo com as regras de CORS. As imagens geradas por CSS, como os gradientes, também são valores válidos e não exigem qualquer pedido.

shape-margin acrescenta espaço em torno do contorno, mas a área flutuante continua limitada à caixa de margem. No exemplo, border-radius desenha o círculo, enquanto shape-outside determina, de forma independente, como o texto flui em torno dele.

Exemplos

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>shape-outside</title>
<style>
  .demo { display: flow-root; width: 360px; font: 16px/24px monospace; }
  .shape {
    float: left;
    width: 120px;
    height: 120px;
    shape-outside: circle(50%) border-box;
    border-radius: 50%;
    background: teal;
  }
  p { margin: 0; }
</style>
<div class="demo">
  <div class="shape" aria-hidden="true"></div>
  <p>One two three four five six seven eight nine ten. One two three four five six seven eight nine ten. One two three four five six seven eight nine ten. One two three four five six seven eight nine ten.</p>
</div>
</html>

Resultado

A teal circle appears on the left; text wraps around its right-hand curve, then uses the full container width below it.

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