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

CKTIS / CSS

visibility — ocultar sem retirar espaço ao layout

A propriedade visibility controla se as caixas de um elemento estão visíveis. hidden oculta-as, preservando o espaço no layout, e um descendente com visible pode continuar visível. O comportamento de collapse depende do contexto de layout.

Versão: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate; usage example matched expected output in isolated Chromium 157.0.8103.51

Sintaxe

visibility: visible | hidden | collapse | force-hidden;

visibility aplica-se a todos os elementos, é herdada e tem inicialmente o valor visible. visible apresenta as caixas normalmente; hidden oculta-as, mas continuam a ocupar espaço no layout. Em contrapartida, display: none impede a geração de caixas para o elemento e os seus descendentes.

Um descendente pode substituir o hidden herdado por visibility: visible. As caixas invisíveis não participam em interações com o ponteiro nem na navegação. Evite ocultar contentores semânticos e deixar os respetivos elementos filhos visíveis, como uma linha de tabela com células visíveis: a especificação alerta para problemas com ferramentas de acessibilidade.

collapse pode reduzir o espaço ocupado de acordo com as regras do layout, sobretudo em linhas e colunas de tabelas e em elementos flex. Nos restantes casos, comporta-se como hidden. Não o considere um substituto universal de display: none.

O rascunho CSS Display Level 4 acrescenta force-hidden: oculta também os descendentes, independentemente do respetivo valor de visibility. Trata-se de um valor em rascunho; a sua presença na sintaxe da especificação não comprova o suporte no Chromium 152. O exemplo utiliza apenas hidden e visible. Produziu o resultado esperado numa execução isolada no Chromium 157.0.8103.51.

Exemplos

<!doctype html>
<meta charset="utf-8">
<title>visibility</title>
<style>
  #box { visibility: hidden; height: 40px; }
  #child { visibility: visible; }
</style>
<div id="box">Hidden text <span id="child">Visible child</span></div>
<div id="next">Next block</div>
<pre id="result"></pre>
<script>
  const box = document.getElementById('box');
  const child = document.getElementById('child');
  const next = document.getElementById('next');
  const rect = box.getBoundingClientRect();
  document.getElementById('result').textContent = [
    getComputedStyle(box).visibility,
    getComputedStyle(child).visibility,
    rect.height,
    next.getBoundingClientRect().top - rect.top
  ].join('\n');
</script>

Resultado

hidden
visible
40
40

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