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

CKTIS / CSS

caption-side — posição da legenda da tabela

A propriedade CSS caption-side seleciona o lado da tabela em que a legenda aparece. Num modo de escrita horizontal, os valores base top e bottom colocam-na, respetivamente, acima ou abaixo da grelha.

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

Sintaxe

caption-side: top | bottom;

caption-side posiciona uma caixa de legenda em relação à grelha da tabela. Aplica-se a caixas table-caption, normalmente criadas por um elemento caption. Num modo de escrita horizontal, top coloca a legenda acima da grelha e bottom abaixo. O valor inicial é top.

A propriedade é herdada: uma declaração em table pode transmitir o seu valor à legenda, a menos que esta tenha uma declaração própria que prevaleça na cascata. inherit obtém explicitamente o valor do elemento antecessor. O posicionamento da legenda inteira e o alinhamento do respetivo texto são aspetos distintos — para este último, utiliza-se text-align.

Os nomes top e bottom não significam topo e fundo físicos em todos os modos de escrita: correspondem a block-start e block-end de acordo com o modo de escrita do bloco que contém a legenda. A extensão que acrescenta inline-start e inline-end é condicional; não se deve pressupor que seja portátil. A sintaxe base desta entrada limita-se a top e bottom.

O exemplo define explicitamente writing-mode: horizontal-tb. A legenda continua a ser o primeiro elemento na marcação da tabela, mas caption-side: bottom apresenta-a por baixo das linhas. Alterar o valor para top deverá movê-la para cima da grelha sem alterar o conteúdo da tabela. O exemplo requer verificação local.

Exemplos

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>caption-side example</title>
<style>
  table { writing-mode: horizontal-tb; border-collapse: collapse; }
  caption { caption-side: bottom; text-align: left; }
  th, td { border: 1px solid black; padding: 4px; }
</style>
<table>
  <caption>Scores</caption>
  <tr><th scope="col">Name</th><th scope="col">Points</th></tr>
  <tr><td>Ada</td><td>12</td></tr>
</table>
</html>

Resultado

Name | Points
Ada  | 12
Scores

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