Help:Tabelas

From MediaWiki.org
Jump to navigation Jump to search
This page is a translated version of the page Help:Tables and the translation is 100% complete.

Other languages:
العربية • ‎català • ‎dansk • ‎Deutsch • ‎Zazaki • ‎English • ‎Esperanto • ‎español • ‎فارسی • ‎suomi • ‎français • ‎Հայերեն • ‎Bahasa Indonesia • ‎italiano • ‎日本語 • ‎한국어 • ‎polski • ‎português • ‎português do Brasil • ‎română • ‎русский • ‎slovenčina • ‎тоҷикӣ • ‎Türkçe • ‎Tiếng Việt • ‎中文
PD 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.
PD
Para ver a estrutura de tabelas do banco de dados da MediaWiki, acesse Manual:Database layout/pt-brManual:Database layout

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.[1]

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, 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.
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

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

{| style="color: black; background-color: #ffffcc; width: 85%;"
| colspan="2" | Essa largura de coluna é 85% da largura da tela (e tem uma cor de fundo)
|-
| style="width: 30%; background-color: white;"|
'''Essa coluna é 30% dos 85% da largura da tela'''
| style="width: 70%; background-color: orange;"|
'''Essa coluna é 70% dos 85% da largura da tela (e tem uma cor de fundo)'''
|}

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.

Ver também

Notas

  1. Tabelas podem ser criadas usando tanto elementos de tabelas HTML diretamente ou formatação wikicode para definir a tabela. Os elementos de formatação HTML são amplamente descritos em vários sites na internet e não serão discutidos aqui. A vantagem dos elementos de formatação wiki, é que a tabela é construída usando caracteres normais que, em comparação com os correspondentes elementos HTML, tendem a facilitar a compreensão da estrutura da tabela ao editar a página.