Help:Tabelas

Nota: Ao editar esta página, você concorda em publicar a sua contribuição no âmbito da licença CC0. Veja as páginas de ajuda do domínio público para mais informações. Edit · Translate

Para ver a estrutura de tabelas do banco de dados da MediaWiki, acesse Manual:Database layout/pt-br

As tabelas podem ser criadas em páginas wiki. Como regra geral, é aconselhável evitar o uso de tabelas, a menos que seja realmente necessário. A marcação de tabelas geralmente dificulta a edição de páginas.

Resumo dos elementos wiki de construção de tabelas

{|	início da tabela, obrigatório
|+	título da tabela, opcional; só pode ser colocado entre o início da tabela e a primeira linha da tabela
|-	linha da tabela, opcional na primeira linha -- a wiki assume a primeira linha mesmo sem este elemento.
!	linha de células que servem de cabeçalhos das colunas, opcional. Os cabeçalhos das colunas podem ser colocados consecutivamente, separados por dois pontos de exclamação (!!), ou colocados um por linha, cada linha começada por um ponto de exclamação (!).
|	linha de células com os dados da tabela, opcional! Células consecutivas de dados de tabela podem ser colocadas numa só linha, separadas por duas barras verticais (||), ou uma por linha, com cada linha começada por uma barra vertical (|).
|}	final da tabela, obrigatório

• Os elementos de construção de tabelas têm de começar numa linha nova, exceto os sinais duplos (||) e (!!) para opcionalmente adicionar elementos consecutivos numa só linha. No entanto, espaços em branco no início da linha são ignorados.
• Atributos HTML. Cada elemento, exceto o final da tabela, opcionalmente aceita um ou mais atributos HTML. Os atributos têm de estar na mesma linha que o elemento. Separe os atributos entre si com um só espaço.
  • As células e títulos (| ou ||, ! ou !!, e |+) têm conteúdo. Por isso, separe os atributos do conteúdo usando uma só barra vertical (|). O conteúdo da célula pode ser colocado na mesma linha ou nas linhas seguintes.
  • Os elementos da tabela e das linhas ({| e |-) não têm conteúdo. Não coloque a barra vertical (|) após os atributos opcionais. Se colocar, por erro, uma barra vertical depois dos atributos de um elemento de tabela ou de linha, o analisador sintático apaga a barra vertical e o último atributo se este estiver encostado na barra vertical!
• Conteúdo pode (a) seguir seu elemento de célula na mesma linha após quaisquer atributos HTML opcionais ou (b) em linhas abaixo do elemento de célula. Conteúdo que usa elementos wiki que precisam começar em uma nova linha, como listas, cabeçalhos, ou tabelas aninhadas, deve estar em sua própria nova linha.
  • Barra vertical como conteúdo. Para inserir um caractere de barra vertical (|) em uma tabela, use o elemento wiki <nowiki>|</nowiki>.

Informações básicas

A tabela a seguir não possui bordas e um bom espaçamento mas mostra a estrutura mais simples com o elemento tabela.

Você digita	O resultado é
{| |Laranja |Maçã |- |Pão |Torta |- |Manteiga |Sorvete |}	Laranja Maçã Pão Torta Manteiga Sorvete

As células na mesma linha podem ser listadas em uma linha separadas por || (duas barras verticais). Se o texto na célula precisar conter uma quebra de linha, use <br/> no lugar.

Você digita	O resultado é
{| |Laranja||Maçã||mais |- |Pão||Torta||mais |- |Manteiga||Sorvete<br/>gelado||e<br/>mais |}	Laranja Maçã mais Pão Torta mais Manteiga Sorvete gelado e mais

Espaços extras dentro de células em elementos wiki, como nos elementos wiki abaixo, não afetam a geração da tabela.

Você digita	O resultado é
{| | Laranja || Maçã || mais |- | Pão || Torta || mais |- | Manteiga || Sorvete || e mais |}	Laranja Maçã mais Pão Torta mais Manteiga Sorvete e mais

Você também pode inserir textos mais longos ou sintaxe wiki mais complexa dentro de tabelas:

Você digita

O resultado é

{| |Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet. | * Lorem ipsum dolor sit amet * consetetur sadipscing elitr * sed diam nonumy eirmod tempor invidunt |}

Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet. Lorem ipsum dolor sit amet consetetur sadipscing elitr sed diam nonumy eirmod tempor invidunt

Cabeçalhos de tabelas

Cabeçalhos de tabelas podem ser criados usando "!" (ponto de exclamação) ao invés de "|" (barra vertical). Cabeçalhos normalmente aparecem em negrito e alinhados no centro por padrão.

Você digita	O resultado é
{| ! style="text-align:left;"| Item ! Quantidade ! Custo |- |Laranja |10 |7.00 |- |Pão |4 |3.00 |- |Manteiga |1 |5.00 |- !Total | |15.00 |}	Item Quantidade Custo Laranja 10 7.00 Pão 4 3.00 Manteiga 1 5.00 Total 15.00

Nota: Quando usar atributos como no cabeçalho 'Item', uma barra vertical '|' é usada para separação. Não um ponto de exclamação '!'.

Título

Um título de tabela pode ser adicionado no topo de qualquer tabela como mostrado abaixo.

Você digita	O resultado é
{| |+Complementos alimentares |- |Laranja |Maçã |- |Pão |Torta |- |Manteiga |Sorvete |}	Complementos alimentares Laranja Maçã Pão Torta Manteiga Sorvete

class="wikitable"

Estilização básica (cor de fundo cinza claro, bordas, preenchimento e alinhamento à esquerda) pode ser obtida adicionando class="wikitable".

Você digita	O resultado é
{| class="wikitable" |+Complementos alimentares |- |Laranja |Maçã |- |Pão |Torta |- |Manteiga |Sorvete |}	Complementos alimentares Laranja Maçã Pão Torta Manteiga Sorvete

colspan e rowspan HTML

Você pode usar os atributos HTML colspan e rowspan em células para criar um layout avançado.

Você digita	O resultado é
{| class="wikitable" !colspan="6"|Lista de Compras |- |rowspan="2"|Pão & Manteiga |Torta |Bolo |Folhado |colspan="2"|Croissant |- |Queijo |colspan="2"|Sorvete |Manteiga |Iogurte |}	Lista de Compras Pão & Manteiga Torta Bolo Folhado Croissant Queijo Sorvete Manteiga Iogurte

Atributos HTML

Você pode adicionar atributos HTML à tabelas. Para consultar a fonte oficial sobre atributos HTML, veja a página sobre tabelas da Especificação HTML da W3C.

Atributos em tabelas

Inserir atributos após o elemento de início da tabela ({|) aplica estes atributos para a tabela inteira.

Você digita	O resultado é
{| class="wikitable" style="text-align: center; color: green;" |Laranja |Maçã |12,333.00 |- |Pão |Torta |500.00 |- |Manteiga |Sorvete |1.00 |}	Laranja Maçã 12,333.00 Pão Torta 500.00 Manteiga Sorvete 1.00

Atributos em células

Você pode colocar atributos em células individuais. Por exemplo, números podem ficar melhores alinhados à direita.

Você digita	O resultado é
{| class="wikitable" | Laranja | Maçã | style="text-align:right;" | 12,333.00 |- | Pão | Torta | style="text-align:right;" | 500.00 |- | Manteiga | Sorvete | style="text-align:right;" | 1.00 |}	Laranja Maçã 12,333.00 Pão Torta 500.00 Manteiga Sorvete 1.00

Você também pode usar atributos em células quando listar múltiplas células em uma única linha. Note que células são separadas por ||, e dentro de cada célula o(s) atriuto(s) e valor(es) são separados por |.

Você digita	O resultado é
{| class="wikitable" | Laranja || Maçã || style="text-align:right;" | 12,333.00 |- | Pão || Torta || style="text-align:right;" | 500.00 |- | Manteiga || Sorvete || style="text-align:right;" | 1.00 |}	Laranja Maçã 12,333.00 Pão Torta 500.00 Manteiga Sorvete 1.00

Atributos em linhas

Você pode inserir atributos em linhas também.

Você digita	O resultado é
{| class="wikitable" | Laranja | Maçã | style="text-align:right;"| 12,333.00 |- | Pão | Torta | style="text-align:right;"| 500.00 |- style="font-style: italic; color: green;" | Manteiga | Sorvete | style="text-align:right;"| 1.00 |}	Laranja Maçã 12,333.00 Pão Torta 500.00 Manteiga Sorvete 1.00

Borda de tabela simples de um pixel

Um exemplo de uma borda de tabela de um pixel:

Você digita	O resultado é
{| border="1" style="border-collapse:collapse" | Laranja | Maçã |- | Pão | Torta |}	Laranja Maçã Pão Torta

Largura da borda

Se "border-width:" tem apenas um número, este valor se aplica à largura da borda nos quatro lados:

Você digita	O resultado é
{|style="border-style: solid; border-width: 20px" | Olá |}	Olá

Se "border-width:" tem mais do que um número, os quatro número se referem às larguras das bordas superior, direita, inferior, esquerda(LEMBRE dessa ordem):

Você digita	O resultado é
{|style="border-style: solid; border-width: 10px 20px 100px 0" | Olá |}	Olá

Quando houver menos do que quatro números, o valor para a borda esquerda é obtido do valor da borda direita, o valor para a borda inferior é obtido do valor da borda superior, e o valor da borda direita é obtido do valor da borda superior.

Outro método para definir as larguras dos quatro lados de uma célula é usar "border-left", "border-right", "border-top" e "border-bottom":

Você digita	O resultado é
{|style="border-left:solid 10px black;border-right:solid 20px black;border-top:solid 30px black;border-bottom:solid 40px black;" align="center" | Olá |}	Olá

Os atributos HTML (como "width=", "border=", "cellspacing=", "cellpadding=") não precisam de uma unidade de comprimento (a unidade pixel é utilizada por padrão). Eles também são inválidos em HTML 5.

"Cellpadding" is for setting the space between the cell wall and the cell content.

As propriedades de estilo CSS (que sobrescrevem os atributos HTML) exigem uma unidade de comprimento explícita (se o valor não for 0) como "px" para pixel.

Com atributos HTML e estilos CSS

Atributos de estilo CSS podem ser adicionados com ou sem outros atributos HTML.

Você digita	O resultado é
{| class="wikitable" style="color:green; background-color:#ffffcc;" cellpadding="10" |Laranja |Maçã |- |Pão |Torta |- |Manteiga |Sorvete |}	Laranja Maçã Pão Torta Manteiga Sorvete

Padding

You type	You get
{|class=wikitable | style="padding: 10px" | Exemplo de style="padding:10px" |- | style="padding: 50px" | Exemplo de style="padding:50px"<br/><br/>Especifique o preenchimento em '''CADA CÉLULA''' |- | style="padding:100px" | Exemplo de style="padding:100px" |}	Exemplo de style="padding:10px" Exemplo de style="padding:50px" Especifique o preenchimento em CADA CÉLULA Exemplo de style="padding:100px"

Atributos

Atributos podem ser adicionados ao título e cabeçalhos como mostrado abaixo.

Você digita	O resultado é
{| class="wikitable" |+ style="caption-side:bottom; color:#e76700;"|"Complementos alimentares" |- |Laranja |Maçã |- |Pão |Torta |- |Manteiga |Sorvete |}	"Complementos alimentares" Laranja Maçã Pão Torta Manteiga Sorvete

Largura de coluna

Largura de coluna pode ser adicionada como a seguir.

Você digita

{| class="wikitable" style="width: 85%;"
| colspan="2" | <span class="mw-translate-fuzzy">Essa largura de coluna é 85% da largura da tela (e tem uma cor de fundo)</span>
|-
| style="width: 30%"| '''Essa coluna é 30% dos 85% da largura da tela'''
| style="width: 70%"| <span class="mw-translate-fuzzy">'''Essa coluna é 70% dos 85% da largura da tela (e tem uma cor de fundo)'''</span>
|}

O resultado é

Essa largura de coluna é 85% da largura da tela (e tem uma cor de fundo)
Essa coluna é 30% dos 85% da largura da tela	Essa coluna é 70% dos 85% da largura da tela (e tem uma cor de fundo)

Acessibilidade de células de cabeçalho de tabela

Células de cabeçalho de tabela não especificam explicitamente à quais células de dados de tabela elas se aplicam (aquelas à direita, na mesma linha, ou aquelas abaixo na mesma coluna). Quando a tabela é gerada em um ambiente visual 2D, isso é normalmente fácil de inferir.

No entanto quando tabelas são geradas em mídias não-visuais, você pode ajudar o navegador a determinar qual célula de cabeçalho de tabela se aplica à descrição de qualquer célula selecionada (de forma a repetir seu conteúdo em algum ajudante de acessibilidade) usando um atributo scope="row" ou scope="col" em células de cabeçalho de tabela. Na maioria dos casos com tabelas simples, você usará scope="col" em todas as células de cabeçalho na primeira linha, e scope="row" na primeira célula das linhas seguintes:

Você digita	O resultado é
{| class="wikitable" |- ! scope="col"| Item ! scope="col"| Quantidade ! scope="col"| Preço |- ! scope="row"| Pão | 0.3 kg | $0.65 |- ! scope="row"| Manteiga | 0.125 kg | $1.25 |- ! scope="row" colspan="2"| Total | $1.90 |}	Item Quantidade Preço Pão 0.3 kg $0.65 Manteiga 0.125 kg $1.25 Total $1.90

Alinhamento

Alinhamento de tabelas

Alinhamento de tabelas é obtido usando CSS. O alinhamento de tabelas é controlado por margens. Uma margem fixa em um lado irá fazer que a tabela fique alinhada neste lado, se o lado oposto da margem é definido como "auto". Para ter uma tabela alinhada no centro, você deve definir as duas margens como "auto"

Por exemplo, uma tabela alinhada à direita:

Você digita	O resultado é
{| class="wikitable" style="margin-left: auto; margin-right: 0px;" | Laranja | Maçã |- | Pão | Torta |- | Manteiga | Sorvete |}	Laranja Maçã Pão Torta Manteiga Sorvete

E uma tabela alinhada no centro:

Você digita	O resultado é
{| class="wikitable" style="margin: auto;" | Laranja | Maçã |- | Pão | Torta |- | Manteiga | Sorvete |}	Laranja Maçã Pão Torta Manteiga Sorvete

Tabela flutuando ao redor do texto

Se você alinhar a tabela à direita ou esquerda da página, o texto que vem depois da tabela começa no fim da tabela, deixando um espaço vazio ao redor da tabela. Você pode fazer o texto ficar ao redor da tabela fazendo a tabela "flutuar" ao redor do texto ao invés de apenas alinhá-la. Isso pode ser obtido usando o atributo CSS float, que pode especificar onde a tabela flutua para o lado direito ou para o esquerdo. Quando usar "float", margens não controlam alinhamento de tabela e podem ser usadas para especificar a margem entre a tabela e o texto em volta.

Você digita

O resultado é

{| class="wikitable" style="float:right; margin-left: 10px;" | Laranja | Maçã |- | Pão | Torta |- | Manteiga | Sorvete |} Lorem ipsum dolor sit amet, consectetuer adipiscing elit, sed diam nonummy nibh euismod tincidunt ut laoreet dolore magna aliquam erat volutpat. Ut wisi enim ad minim veniam, quis nostrud exerci tation ullamcorper suscipit lobortis nisl ut aliquip ex ea commodo consequat. Duis autem vel eum iriure dolor in hendrerit in vulputate velit esse molestie consequat, vel illum dolore eu feugiat nulla facilisis at vero eros et accumsan et iusto odio dignissim qui blandit praesent luptatum zzril delenit augue duis dolore te feugait nulla facilisi.

Laranja Maçã Pão Torta Manteiga Sorvete Lorem ipsum dolor sit amet, consectetuer adipiscing elit, sed diam nonummy nibh euismod tincidunt ut laoreet dolore magna aliquam erat volutpat. Ut wisi enim ad minim veniam, quis nostrud exerci tation ullamcorper suscipit lobortis nisl ut aliquip ex ea commodo consequat. Duis autem vel eum iriure dolor in hendrerit in vulputate velit esse molestie consequat, vel illum dolore eu feugiat nulla facilisis at vero eros et accumsan et iusto odio dignissim qui blandit praesent luptatum zzril delenit augue duis dolore te feugait nulla facilisi.

Alinhamento do conteúdo de células

O alinhamento de conteúdo de células pode ser controlado com 2 diferentes propriedades CSS: text-align e vertical-align. text-align pode ser especificado na tabela, linha ou células individuais, enquanto vertical-align só pode ser especificado em linhas e células individuais.

Você digita

O resultado é

{| class="wikitable" |- style="vertical-align:top;" | style="height:100px; width:100px; text-align:left;" | A | style="height:100px; width:100px; text-align:center;" | B | style="height:100px; width:100px; text-align:right;" | C |- style="vertical-align:middle;" | style="height:100px; width:100px; text-align:left;" | D | style="height:100px; width:100px; text-align:center;" | E | style="height:100px; width:100px; text-align:right;" | F |- style="vertical-align:bottom;" | style="height:100px; width:100px; text-align:left;" | G | style="height:100px; width:100px; text-align:center;" | H | style="height:100px; width:100px; text-align:right;" | I |}

A B C D E F G H I

Ressalvas

Números negativos

Se você iniciar uma célula em uma nova linha com um número negativo com um sinal de menos (ou um parâmetro que resulta em um número negativo), sua tabela pode ficar quebrada, porque os caracteres |- serão interpretados elementos wiki de linha de tabela, e não célula de tabela. Para evitar isso, insira um espaço antes do valor (| -6) ou use elementos de célula in-line (|| -6).

CSS vs atributos

Bordas de tabelas especificadas através de CSS ao invés do atributo de borda serão exibidas incorretamente em um pequeno subconjunto de navegadores de texto.

Atributos comuns para colunas, grupos de colunas e grupos de linhas

A sintaxe da MediaWiki para tabelas, no momento não oferece suporte para especificação de atributos comuns para colunas (com o elemento HTML <col />), grupos de colunas (elemento HTML <colgroup></colgroup>) e grupos de linhas (elementos HTML <thead></thead>, <tbody></tbody> e <tfoot></tfoot>). Esses elementos HTML padrão não são aceitos nem em sua sintaxe HTML ou XHTML.

Todas as linhas e células (cabeçalho e dados) da tabela são gerados dentro de um único grupo implícito de linhas (elemento HTML <tbody></tbody>) sem quaisquer atributos ou estilos.

Tabelas e o Editor Visual (VE)

Ver também: Help:Editor Visual/Guia do usuário

Veja Phab: T108245: "Fully support basic table editing in the visual editor". Veja a lista de tarefas. Tarefas concluídas são atingido. Pode ser difícil descobrir, a partir da linguagem técnica, o que exatamente foi melhorado ou quais recursos foram adicionados. Por favor, adicione informações explicativas abaixo.

Agora pode mover ou excluir colunas e linhas

Clique em um cabeçalho de coluna ou linha. Em seguida, clique na seta. No menu pop-up, clique em "Mover" ou "Excluir".

Inserir linha ou coluna em branco

No mesmo menu, clique em "Inserir".

Copiar a tabela da página da Web para o Editor Visual

É possível copiar e colar uma tabela de uma página da web diretamente no Editor Visual (VE). Para fazer isso com segurança, use uma caixa de proteção e verifique a tabela quanto à codificação adequada no modo de fonte wikitexto e à exibição adequada no Editor Visual e no modo de visualização.

Ver também

• Ordenando listas de uma tabela
• m:Help:Sorting
• w:Help:Tables
• Ferramenta fácil que ajuda na geração de tabelas