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

CKTIS / CSS

outline — o contorno de um elemento

A propriedade abreviada `outline` define a espessura, o estilo e a cor do contorno sem alterar a disposição da página. É útil, entre outras coisas, para realçar o foco do teclado.

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

Sintaxe

outline: <'outline-width'> || <'outline-style'> || <'outline-color'>;

outline define em conjunto outline-width, outline-style e outline-color. Os componentes podem surgir em qualquer ordem; || significa que é necessário pelo menos um. Os componentes omitidos assumem os valores iniciais. A propriedade não é herdada.

Ao contrário de border, o contorno não ocupa espaço na disposição da página e pode sobrepor-se a elementos vizinhos. Pode não ser retangular e não há propriedades distintas para cada lado. A propriedade independente outline-offset define o afastamento entre o contorno e a borda; a abreviatura outline não repõe o seu valor inicial.

Indica um estilo, como solid: o valor inicial outline-style: none não produz um contorno visível. Com auto, o aspeto fica ao critério do navegador, pelo que este valor não é adequado para testes que exijam resultados idênticos píxel a píxel. Não removas o contorno do foco com outline: none sem forneceres outro indicador visível de foco.

O exemplo mostra um botão Continue branco com uma borda preta. Quando o botão recebe o foco através do teclado, surge um contorno azul contínuo, com 3px de espessura e afastado 4px da borda.

Exemplos

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>Outline example</title>
<style>
  body { margin: 32px; background: white; }
  button {
    padding: 8px 16px;
    border: 1px solid black;
    background: white;
    color: black;
  }
  button:focus-visible {
    outline: 3px solid #005fcc;
    outline-offset: 4px;
  }
</style>
<button type="button">Continue</button>
</html>

Resultado

A white Continue button with a black border. When the button receives keyboard focus, a solid blue 3px outline appears, separated from the border by a 4px gap.

Prime a tecla Tab até o botão Continue receber o foco e o contorno azul ficar visível.

Fontes