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.