{"id":809,"date":"2026-10-29T18:34:21","date_gmt":"2026-10-29T21:34:21","guid":{"rendered":"https:\/\/yellowkode.com\/blog\/table-com-display-grid-semantica-leitores-de-tela\/"},"modified":"2026-10-29T18:34:21","modified_gmt":"2026-10-29T21:34:21","slug":"table-com-display-grid-semantica-leitores-de-tela","status":"publish","type":"post","link":"https:\/\/yellowkode.com\/blog\/table-com-display-grid-semantica-leitores-de-tela\/","title":{"rendered":"Table com display: grid: o que acontece com a sem\u00e2ntica e com leitores de tela"},"content":{"rendered":"<p>No dia 29 de outubro de 2026, a Preethi publicou no CSS-Tricks um texto chamado <em>The Frankenstein Table<\/em>, propondo o seguinte experimento: pegar uma <code>&lt;table&gt;<\/code> HTML, aplicar <code>display: grid<\/code> nela, achatar o <code>&lt;tbody&gt;<\/code> com <code>display: contents<\/code> e tratar <code>&lt;tr&gt;<\/code> e c\u00e9lulas como blocos. A ideia \u00e9 ter o que ela chama de marca\u00e7\u00e3o pseudo-sem\u00e2ntica (<code>&lt;th&gt;<\/code> continua lendo como cabe\u00e7alho, <code>&lt;td&gt;<\/code> como dado) enquanto o layout vem do CSS Grid.<\/p>\n<p>O artigo original relata que, nos testes dela, VoiceOver e navega\u00e7\u00e3o por teclado continuaram funcionando como em uma tabela de verdade. Esse \u00e9 o ponto que precisa de escrut\u00ednio, porque a hist\u00f3ria dessa combina\u00e7\u00e3o de propriedades e browsers \u00e9 cheia de regress\u00e3o. Vamos destrinchar o mecanismo e depois mostrar onde ele quebra.<\/p>\n<h2>Como o navegador traduz display para a \u00e1rvore de acessibilidade<\/h2>\n<p>Quando voc\u00ea escreve <code>&lt;table&gt;<\/code>, o navegador faz duas coisas em paralelo: constr\u00f3i uma caixa de layout do tipo tabela e insere um n\u00f3 de role <code>table<\/code> na \u00e1rvore de acessibilidade, que \u00e9 o que leitor de tela consulta. Essas duas \u00e1rvores s\u00e3o, em tese, independentes. A especifica\u00e7\u00e3o do CSS Display diz que <code>display<\/code> afeta a \u00e1rvore de caixas, n\u00e3o a sem\u00e2ntica do documento.<\/p>\n<p>Na pr\u00e1tica, v\u00e1rios navegadores historicamente amarraram uma coisa na outra. Steve Faulkner documentou isso de forma crua: quando CSS display:block, display:grid ou display:flex \u00e9 aplicado no elemento table, a tabela n\u00e3o \u00e9 mais representada como tabela na \u00e1rvore de acessibilidade, e os elementos de linha deixam de ser representados em qualquer forma. Ou seja, o <code>&lt;th&gt;<\/code> continua no DOM, continua pseudo-sem\u00e2ntico para quem l\u00ea o c\u00f3digo, mas para o leitor de tela ele vira s\u00f3 um peda\u00e7o de texto solto.<\/p>\n<p>Vale a analogia, com limite declarado: pense num livro que foi encadernado com separadores de cap\u00edtulo marcados por abas coloridas. Se voc\u00ea arranca a capa e troca por outra, as abas continuam ali e voc\u00ea ainda v\u00ea que uma se\u00e7\u00e3o come\u00e7a em cada aba. Agora imagine um leitor que s\u00f3 enxerga pela capa: ele perde todos os marcadores. A \u00e1rvore de acessibilidade \u00e9 esse leitor. A analogia quebra num ponto importante: no caso do navegador, a decis\u00e3o de perder ou n\u00e3o os marcadores depende do fornecedor do browser e muda entre vers\u00f5es, n\u00e3o \u00e9 uma lei f\u00edsica.<\/p>\n<h3>O que mudou nos \u00faltimos anos<\/h3>\n<p>Adrian Roselli vem acompanhando isso h\u00e1 mais de uma d\u00e9cada e o status melhorou. Em outubro de 2023 ele registrou que tabelas com propriedades display est\u00e3o funcionais em Chromium, Gecko e, finalmente, WebKit, com exce\u00e7\u00e3o de display: contents, que ainda pode causar problemas por conta de uma especifica\u00e7\u00e3o ruim. Essa exce\u00e7\u00e3o \u00e9 justamente o truque usado na Frankenstein Table para apagar o <code>&lt;tbody&gt;<\/code> do layout.<\/p>\n<h3>Por que display: contents no tbody \u00e9 o ponto delicado<\/h3>\n<p>O prop\u00f3sito de <code>display: contents<\/code> \u00e9 que a caixa do elemento desapare\u00e7a, mas os filhos sobem e continuam participando do layout do ancestral. Em um grid, isso \u00e9 \u00fatil porque o <code>&lt;tbody&gt;<\/code>, por padr\u00e3o, interrompe a hierarquia de c\u00e9lulas do grid. O problema hist\u00f3rico est\u00e1 documentado: definir display: contents em table, thead, tbody ou tr quebra o papel de acessibilidade da tabela em todos os navegadores antes das corre\u00e7\u00f5es de engine, leitores de tela param de anunciar linhas e colunas mesmo com usu\u00e1rios ainda vendo tudo, e o conselho \u00e9 evitar a propriedade em elementos de tabela.<\/p>\n<p>Mesmo onde o bug j\u00e1 foi corrigido, a propriedade tem fama de regredir. Display: contents pode retirar o papel sem\u00e2ntico de um elemento, impedindo que bot\u00f5es sejam anunciados como bot\u00f5es, tabelas como tabelas, listas como listas, e um rastreador documentou dezesseis regress\u00f5es separadas ao longo do tempo. Ent\u00e3o mesmo que o seu teste manual passe hoje, voc\u00ea est\u00e1 apostando que a pr\u00f3xima vers\u00e3o do WebKit n\u00e3o vai desfazer o conserto.<\/p>\n<h2>O que isso significa na pr\u00e1tica para quem vai montar isso<\/h2>\n<p>Suponha que voc\u00ea queira fazer o mesmo cart\u00e3o do artigo original, com uma tabela que se comporta como grid. O c\u00f3digo que ele prop\u00f5e \u00e9, essencialmente, este:<\/p>\n<pre><code>.card {\n display: grid;\n grid-template-columns: auto auto 1fr;\n gap: 2lh;\n}\n\n.card tbody { display: contents; } \/* achata o tbody *\/\n.card tr,\n.card tr &gt; * { display: block; } \/* evita table-row e table-cell *\/\n<\/code><\/pre>\n<p>Se voc\u00ea for colar isso em produ\u00e7\u00e3o, o teste m\u00ednimo n\u00e3o \u00e9 abrir no navegador e ver que ficou bonito. \u00c9 abrir o inspetor de acessibilidade (Chrome DevTools tem a aba Accessibility, Firefox tem o Accessibility Inspector) e conferir se o n\u00f3 raiz ainda \u00e9 <code>table<\/code>, se as linhas ainda s\u00e3o <code>row<\/code> e se as c\u00e9lulas ainda s\u00e3o <code>cell<\/code> ou <code>columnheader<\/code>.<\/p>\n<p>E se n\u00e3o estiver, a MDN descreve exatamente a sa\u00edda: use apenas table, tr, td etc. para estrutura de tabela de dados, mas voc\u00ea pode adicionar essas roles ARIA para garantir acessibilidade caso a sem\u00e2ntica nativa da tabela seja removida, por exemplo quando a propriedade display do CSS sobrescreve a sem\u00e2ntica nativa como com display: grid; nesse caso, voc\u00ea pode usar as roles ARIA para readicionar a sem\u00e2ntica. Na pr\u00e1tica, isso significa:<\/p>\n<pre><code>&lt;table class=\"card\" role=\"table\"&gt;\n &lt;tbody role=\"rowgroup\"&gt;\n &lt;tr class=\"card-number\" role=\"row\"&gt;\n &lt;th role=\"rowheader\" scope=\"row\"&gt;CARD NUMBER&lt;\/th&gt;\n &lt;td role=\"cell\"&gt;1234 5678 9123 4567&lt;\/td&gt;\n &lt;\/tr&gt;\n &lt;\/tbody&gt;\n&lt;\/table&gt;\n<\/code><\/pre>\n<p>Note que isso duplica informa\u00e7\u00e3o: a sem\u00e2ntica j\u00e1 estava l\u00e1 via HTML e voc\u00ea est\u00e1 reafirmando com ARIA caso o CSS atropele. \u00c9 feio e \u00e9 exatamente o custo de pedir ao <code>&lt;table&gt;<\/code> que fa\u00e7a o trabalho de pseudo-sem\u00e2ntica e ao mesmo tempo ser um container de grid.<\/p>\n<p>Essa hist\u00f3ria de pagar duas vezes pela mesma coisa aparece em muitos lugares em interface. Numa migra\u00e7\u00e3o de e-commerce legado para Next.js, com checkout de alto volume, convivemos com dois sistemas de checkout rodando ao mesmo tempo por um per\u00edodo longo, e o custo maior n\u00e3o foi t\u00e9cnico, foi manter os dois coerentes. ARIA em cima de HTML sem\u00e2ntico tem essa mesma pegada: voc\u00ea precisa manter os dois dizendo a mesma coisa, e se um diverge do outro voc\u00ea tem bug invis\u00edvel no inspetor comum.<\/p>\n<h2>Onde o Frankenstein Table quebra<\/h2>\n<p>Tr\u00eas pontos para considerar antes de usar essa t\u00e9cnica em produ\u00e7\u00e3o.<\/p>\n<p><strong>1. Colspan e rowspan desaparecem.<\/strong> No momento em que voc\u00ea aplica <code>display: block<\/code> no <code>&lt;tr&gt;<\/code> e nas c\u00e9lulas, os atributos <code>colspan<\/code> e <code>rowspan<\/code> deixam de ter efeito visual, porque o algoritmo de layout de tabela n\u00e3o est\u00e1 mais rodando. Zell Liew testou isso em 2024 e o resultado foi direto: com table usando display: grid, o NVDA n\u00e3o fala colspan; com role=&#8221;table&#8221; e role=&#8221;grid&#8221;, o NVDA n\u00e3o fala aria-colspan, e o VoiceOver s\u00f3 fala aria-colspan no Safari. Tabelas com c\u00e9lulas que atravessam colunas ou linhas ficam de fora.<\/p>\n<p><strong>2. VoiceOver tem hist\u00f3rico ruim com display properties em tabelas.<\/strong> O artigo original diz que VoiceOver funcionou. Isso pode ser verdade no cen\u00e1rio espec\u00edfico testado, mas Adrian Roselli em 2022 relatou o contr\u00e1rio: tabelas com propriedades display s\u00e3o dif\u00edceis ou imposs\u00edveis de navegar com VoiceOver, bot\u00f5es com display: contents n\u00e3o t\u00eam nome acess\u00edvel e n\u00e3o ativam no Enter, e as melhorias desde Safari 15 n\u00e3o s\u00e3o suficientes para considerar tabelas accessibility supported no macOS. Melhorou em 2023, pode ter regredido em 2026. Quem for usar precisa testar na vers\u00e3o do Safari que seus usu\u00e1rios usam.<\/p>\n<p><strong>3. A recomenda\u00e7\u00e3o de quem vive de acessibilidade \u00e9 n\u00e3o fazer.<\/strong> O guia de dados acess\u00edveis descreve o padr\u00e3o de card responsivo que motiva o Frankenstein Table e \u00e9 expl\u00edcito sobre o custo: a abordagem popular colapsa cada linha em um card empilhado em telas estreitas, com cada valor prefixado pelo seu r\u00f3tulo via pseudo-elemento ::before alimentado por um atributo data-label, e a armadilha \u00e9 que isso costuma ser feito aplicando display: block (ou grid) na table, tr, th e td, e mudar o display de um elemento de tabela remove o papel de table da \u00e1rvore de acessibilidade. A ferida n\u00e3o \u00e9 cosm\u00e9tica.<\/p>\n<p>Isso tem rela\u00e7\u00e3o direta com a tese que carrego sobre interface: sistema bom declara onde para, e n\u00e3o pune quem usa por aquilo que ele mesmo deixou acontecer. Um leitor de tela que n\u00e3o anuncia a tabela n\u00e3o est\u00e1 mentindo, ele est\u00e1 reportando o que a \u00e1rvore de acessibilidade entregou. A puni\u00e7\u00e3o recai em quem l\u00ea, n\u00e3o em quem escreveu. Num gateway de login e cadastro com MFA de uma rede nacional de varejo, essa l\u00f3gica me ensinou algo brutal: componente que depende de um teste manual espec\u00edfico para funcionar \u00e9 componente que vai falhar quando ningu\u00e9m estiver olhando. Rollout e fallback pesaram ali tanto quanto a feature. Para interface de dados, o paralelo \u00e9: se a sem\u00e2ntica depende de o browser X na vers\u00e3o Y manter o comportamento Z, voc\u00ea tem uma bomba.<\/p>\n<h2>O que n\u00e3o d\u00e1 para afirmar ainda<\/h2>\n<p>A autora do artigo original testou com VoiceOver e teclado e viu funcionar. N\u00e3o d\u00e1 para dizer, com base s\u00f3 no artigo, em qual vers\u00e3o de Safari, em qual sistema operacional, e com qual estrutura exata de c\u00e9lulas. Para o leitor que est\u00e1 pensando em adotar, essa amostra \u00e9 pequena demais para considerar provado.<\/p>\n<p>N\u00e3o testei pessoalmente a combina\u00e7\u00e3o exata (table + display: grid + tbody com display: contents) com NVDA, JAWS e VoiceOver nas vers\u00f5es de 2026. O que o hist\u00f3rico mostra \u00e9 que esse campo tem muita regress\u00e3o, ent\u00e3o qualquer afirma\u00e7\u00e3o do tipo funciona em todos os leitores precisa vir acompanhada de uma matriz de teste atualizada. Se voc\u00ea for usar, documente a matriz que testou e inclua isso no checklist de regress\u00e3o da sua su\u00edte.<\/p>\n<h2>Como testar isso voc\u00ea mesmo<\/h2>\n<p>Para experimentar sem derrubar nada, siga este caminho curto:<\/p>\n<ul>\n<li>Fa\u00e7a uma p\u00e1gina HTML m\u00ednima com uma <code>&lt;table&gt;<\/code> de duas colunas e tr\u00eas linhas, com <code>&lt;th scope=\"row\"&gt;<\/code> na primeira coluna.<\/li>\n<li>Abra o Chrome DevTools, v\u00e1 em Elements, selecione a <code>&lt;table&gt;<\/code>, abra o painel Accessibility ao lado de Styles e anote a \u00e1rvore: deve aparecer <code>table<\/code> &gt; <code>rowgroup<\/code> &gt; <code>row<\/code> &gt; <code>cell<\/code>.<\/li>\n<li>Aplique <code>table { display: grid; grid-template-columns: auto 1fr; }<\/code> e recarregue. Confira a \u00e1rvore de novo.<\/li>\n<li>Adicione <code>tbody { display: contents; } tr, tr &gt; * { display: block; }<\/code>. Confira a \u00e1rvore pela terceira vez.<\/li>\n<li>Repita no Firefox usando o Accessibility Inspector (menu Ferramentas, Browser Tools, Accessibility) e no Safari ativando o inspetor de acessibilidade via Develop menu.<\/li>\n<li>Se tiver acesso, rode um leitor de tela de verdade: VoiceOver (Cmd + F5 no macOS) ou NVDA (gratuito, Windows). Navegue pelas c\u00e9lulas e ou\u00e7a o que \u00e9 anunciado.<\/li>\n<\/ul>\n<p>Se nos tr\u00eas navegadores a \u00e1rvore continuar com <code>table<\/code>, <code>row<\/code> e <code>cell<\/code>, e o leitor de tela anunciar linha e coluna como esperado, voc\u00ea tem uma base para considerar a t\u00e9cnica para o seu caso. Se qualquer um desses passos cair, a sa\u00edda honesta \u00e9 a mesma de sempre: ou abandona o display: grid na tabela, ou aceita o custo de carimbar as roles ARIA manualmente e manter esse carimbo em dia.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Como aplicar display: grid em uma table HTML, o que isso faz com a \u00e1rvore de acessibilidade e por que display: contents no tbody \u00e9 risco real.<\/p>\n","protected":false},"author":2,"featured_media":808,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[1],"tags":[],"class_list":["post-809","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-uncategorized"],"_links":{"self":[{"href":"https:\/\/yellowkode.com\/blog\/wp-json\/wp\/v2\/posts\/809","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/yellowkode.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/yellowkode.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/yellowkode.com\/blog\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/yellowkode.com\/blog\/wp-json\/wp\/v2\/comments?post=809"}],"version-history":[{"count":0,"href":"https:\/\/yellowkode.com\/blog\/wp-json\/wp\/v2\/posts\/809\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/yellowkode.com\/blog\/wp-json\/wp\/v2\/media\/808"}],"wp:attachment":[{"href":"https:\/\/yellowkode.com\/blog\/wp-json\/wp\/v2\/media?parent=809"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/yellowkode.com\/blog\/wp-json\/wp\/v2\/categories?post=809"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/yellowkode.com\/blog\/wp-json\/wp\/v2\/tags?post=809"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}