Predefinição:Tabela alinhada
 | Esta predefinição usa Lua: |
Esta predefinição gera uma tabela HTML simples a partir de uma sequência de células. Ela foi criada principalmente para situações em que escrever uma tabela diretamente com a sintaxe de tabelas em código wiki é difícil ou pouco prático, especialmente dentro de outras predefinições.
Em uma tabela comum, o código wiki utiliza caracteres como |, ! e |- para separar células e linhas. Dentro da chamada de uma predefinição, porém, a barra vertical (|) também separa seus parâmetros. Essa sobreposição pode tornar a construção de tabelas trabalhosa e exigir o uso repetido da palavra mágica {{!}}. A {{Tabela alinhada}} evita esse problema: cada parâmetro sem nome corresponde a uma célula, enquanto parâmetros adicionais controlam o número de colunas, o alinhamento, as classes e os estilos da tabela.
A predefinição também pode ser conveniente quando muitas células precisam receber a mesma formatação. Em vez de repetir o mesmo código CSS em cada linha ou célula, é possível definir propriedades comuns para toda a tabela, para uma coluna, para uma linha ou para células específicas.
Ela não deve, contudo, ser usada como substituta geral das tabelas escritas diretamente em código wiki. Para uma tabela comum no corpo de um artigo, prefira a sintaxe normal descrita em Ajuda:Guia de edição/Tabelas, que é mais reconhecível para outros editores e não depende desta predefinição.
Os nomes de parâmetros em português apresentados nesta documentação são os recomendados para usos novos. Os nomes anteriormente disponíveis em inglês continuam funcionando por compatibilidade com as páginas existentes.
Uso
Por padrão, a tabela possui duas colunas. Cada parâmetro sem nome corresponde a uma célula, preenchida da esquerda para a direita e de cima para baixo.
{{Tabela alinhada
| colunas = 3
| classe = wikitable
| A | 1 | a
| B | 2 | b
}}
produz:
| A | 1 | a |
| B | 2 | b |
Parâmetros
Tabela
| Parâmetro | Função | Padrão |
|---|---|---|
|título= |
Legenda da tabela, criada com o elemento HTML <caption>. |
— |
|estilo do título= |
CSS adicional aplicado à legenda definida por |título=. |
— |
|colunas= |
Número de colunas da tabela. Deve ser um número inteiro positivo. | 2 |
|largura total= |
Se receber qualquer valor não vazio, faz a tabela ocupar toda a largura disponível e remove o espaçamento e a borda definidos pelo módulo. | — |
|classe= |
Uma ou mais classes CSS aplicadas ao elemento <table>. |
— |
|estilo= |
CSS adicional aplicado ao elemento <table>. |
— |
|cabeçalho superior= |
Insere, antes das demais linhas, uma célula de cabeçalho que abrange todas as colunas. | — |
|estilo do cabeçalho superior= |
CSS aplicado à célula criada por |cabeçalho superior=. |
— |
Nos parâmetros que funcionam como opções, como |largura total=, qualquer valor não vazio os ativa. Por clareza, recomenda-se usar sim.
Colunas
| Parâmetro | Função |
|---|---|
|largura das colunas= |
Define a mesma largura para todas as colunas. |
|estilo das colunas= |
Acrescenta o mesmo CSS às células de todas as colunas. |
|largura da coluna N= |
Define a largura das células da coluna N. |
|classe da coluna N= |
Adiciona classes CSS às células da coluna N. |
|alinhamento da coluna N= |
Define o alinhamento do texto na coluna N, por exemplo left, center ou right. |
|estilo da coluna N= |
Acrescenta CSS às células da coluna N. |
|sem quebra na coluna N= |
Se receber qualquer valor não vazio, impede a quebra automática de linha nas células da coluna N. |
|cabeçalho da coluna N= |
Se receber qualquer valor não vazio, transforma as células da coluna N em cabeçalhos de linha (<th scope="row">). |
|esquerda-direita= |
Se receber qualquer valor não vazio, alinha a primeira coluna à esquerda e a segunda à direita. |
|direita-esquerda= |
Se receber qualquer valor não vazio, alinha a primeira coluna à direita e a segunda à esquerda. |
Os valores de propriedades CSS não são traduzidos. Assim, por exemplo, deve-se usar |alinhamento da coluna 2=center, e não centro.
Linhas
| Parâmetro | Função | Observação |
|---|---|---|
|estilo das linhas= |
CSS aplicado a cada elemento <tr>. |
Se omitido, o módulo aplica vertical-align:top;. |
|classe das linhas= |
Classes CSS aplicadas a cada elemento <tr>. |
— |
|estilo da linha N= |
CSS aplicado às células da linha N. | Não é aplicado ao elemento <tr>. |
|classe da linha N= |
Classes CSS aplicadas às células da linha N. | Não é aplicado ao elemento <tr>. |
|cabeçalho da linha N= |
Se receber qualquer valor não vazio, transforma as células da linha N em cabeçalhos de coluna (<th scope="col">). |
— |
|estilo das linhas pares= |
CSS aplicado às células das linhas pares. | — |
|estilo das linhas ímpares= |
CSS aplicado às células das linhas ímpares. | — |
|classe das linhas pares= |
Classes CSS aplicadas às células das linhas pares. | — |
|classe das linhas ímpares= |
Classes CSS aplicadas às células das linhas ímpares. | — |
A diferença entre as formas no plural e no singular é importante: |estilo das linhas= e |classe das linhas= atuam diretamente nos elementos <tr>; já |estilo da linha N= e |classe da linha N= atuam individualmente nas células daquela linha. Esse comportamento é mantido por compatibilidade com a implementação original.
Células
| Parâmetro | Função |
|---|---|
|classe da célula L.C= |
Define as classes CSS de uma célula específica, identificada pelos números da linha (L<v/ar>) e da coluna (C). Substitui as classes que seriam herdadas da linha e da coluna. |
|estilo da célula L.C= |
Define o CSS de uma célula específica, identificada pelos números da linha (L) e da coluna (C). Substitui os estilos mais gerais que seriam aplicados à célula. |
Por exemplo, |classe da célula 2.1=nowrap atua somente na célula da segunda linha e primeira coluna.
Os parâmetros sem nome contêm o conteúdo das células. Espaços em branco no final de cada valor são removidos pelo módulo; espaços no início são preservados.
Compatibilidade
Os antigos parâmetros em inglês permanecem aceitos para não quebrar usos existentes. Entre eles estão |cols=, |fullwidth=, |class=, |style=, |title=, |colwidth=, |colstyle=, |rowstyle=, |rowclass=, |leftright= e |rightleft=, além das famílias numeradas, como |col1align=, |row1header= e |style2.1=.
Alguns desses parâmetros possuem ainda variantes históricas, como |col1align=, |colalign1= e |align1=. Elas são mantidas apenas por compatibilidade; em código novo, prefira os nomes em português apresentados acima.
Exemplos
Alinhamento por coluna
{{Tabela alinhada
| colunas = 4
| classe = wikitable
| alinhamento da coluna 1 = center
| alinhamento da coluna 2 = center
| alinhamento da coluna 3 = right
| alinhamento da coluna 4 = right
| Alfa | aaaaa | 123 | 12345
| Beta | b | 1234 | 2
}}
| Alfa | aaaaa | 123 | 12345 |
| Beta | b | 1234 | 2 |
Cabeçalhos e legenda
{{Tabela alinhada
| título = Exemplo
| colunas = 3
| classe = wikitable sortable
| cabeçalho da linha 1 = sim
| Letra | Número | Minúscula
| A | 1 | a
| B | 2 | b
}}
| Letra | Número | Minúscula |
|---|---|---|
| A | 1 | a |
| B | 2 | b |
Cabeçalho superior e largura total
{{Tabela alinhada
| colunas = 2
| largura total = sim
| classe = wikitable
| cabeçalho superior = Dados
| cabeçalho da coluna 1 = sim
| Nome | Valor
| Alfa | 10
| Beta | 20
}}
| Dados | |
|---|---|
| Nome | Valor |
| Alfa | 10 |
| Beta | 20 |