Como Solucionar Problemas de Formatação JSON de Coluna que Não Renderiza

Você aplicou formatação JSON a uma coluna de lista ou biblioteca do SharePoint, mas a coluna exibe texto simples ou nenhuma formatação. Esse problema geralmente ocorre porque o código JSON contém um erro de sintaxe, o tipo de coluna não suporta a regra de formatação ou o cache do navegador está bloqueando a renderização. Este artigo explica as causas comuns de falhas na formatação JSON e fornece métodos passo a passo para diagnosticar e corrigir o problema.

A formatação JSON de coluna no SharePoint usa um esquema específico que deve ser válido e corresponder ao tipo de coluna de destino. Quando o código tem uma vírgula faltando, nome de propriedade incorreto ou operador não suportado, o SharePoint falha silenciosamente ao aplicar a formatação. Você aprenderá como validar seu JSON, verificar a compatibilidade da coluna e limpar bloqueadores de renderização para que sua formatação seja exibida corretamente.

Seguindo as instruções abaixo, você pode identificar a linha exata que está causando a falha e aplicar uma correção confiável. O guia também cobre problemas relacionados, como formatação que não atualiza após edições e formatação que desaparece após migração do site.

Por que a Formatação JSON de Coluna Falha ao Renderizar

O SharePoint usa um esquema JSON que define como os valores das colunas aparecem nas exibições de lista. Quando você cola o código JSON no painel de formatação, o SharePoint o analisa e aplica as regras. Se o código tiver algum erro de sintaxe — como uma vírgula faltando, colchete extra ou nome de propriedade com erro de digitação — o analisador para e reverte para a exibição de texto simples padrão. O navegador não mostra uma mensagem de erro por padrão, o que torna o problema difícil de identificar.

Uma segunda causa comum é a incompatibilidade do tipo de coluna. O esquema de formatação JSON inclui operadores condicionais como ==, contains e startsWith. Esses operadores exigem um tipo de dados específico. Por exemplo, você não pode usar startsWith em uma coluna Número porque números não suportam métodos de string. Da mesma forma, o token @currentField deve corresponder ao tipo de coluna que você está formatando.

O cache do navegador também pode fazer com que a formatação antiga seja exibida mesmo depois de você salvar um JSON correto. O SharePoint armazena a formatação no cache do navegador para desempenho. Se o cache não for limpo, a versão antiga continua aparecendo. Isso é comum após editar o JSON várias vezes em rápida sucessão.

Tipos de Coluna Suportados para Formatação JSON

Os seguintes tipos de coluna suportam formatação JSON:

• Linha de texto única
• Número
• Escolha (seleção única apenas)
• Pessoa ou Grupo (seleção única)
• Data e Hora
• Sim/Não
• Hiperlink ou Imagem

Tipos de coluna que NÃO suportam formatação JSON incluem: Várias linhas de texto, Pesquisa, Metadados Gerenciados, Moeda (use Número) e colunas Calculadas. Se você aplicar formatação a uma coluna não suportada, o SharePoint ignora o código completamente.

Passos para Diagnosticar e Corrigir a Formatação JSON de Coluna que Não Renderiza

Siga estes passos em ordem. Cada passo elimina uma causa possível.

1. Valide a sintaxe JSON usando uma ferramenta externa
   Abra um validador JSON como jsonlint.com. Copie todo o código JSON do painel de formatação da sua coluna e cole no validador. Clique no botão Validar. Se o validador mostrar um erro, anote o número da linha e a mensagem. Erros comuns incluem: vírgula faltando entre propriedades, vírgula extra no final, colchetes desiguais e nomes de propriedade sem aspas. Corrija o erro em seu editor de código e revalide até que o JSON seja válido.
2. Verifique o tipo de coluna nas configurações da lista
   Vá para a lista que contém a coluna. Selecione o ícone de engrenagem e escolha Configurações da lista. Localize o nome da coluna na seção Colunas. Clique no nome da coluna e verifique o campo Tipo. Se o tipo não estiver na lista suportada acima, a formatação JSON nunca será renderizada. Altere o tipo de coluna para um suportado ou crie uma nova coluna com um tipo compatível e mova sua formatação para lá.
3. Revise o esquema JSON para incompatibilidades de operador
   Em seu código JSON, procure operadores como ==, !=, contains, startsWith, length e indexOf. Certifique-se de que o operador corresponda ao tipo de coluna. Para uma coluna Número, use == ou != com valores numéricos. Para uma coluna de texto, você pode usar contains ou startsWith. Se você usar startsWith em um número, substitua por == com um valor numérico.
4. Limpe o cache do navegador e recarregue a lista
   Pressione Ctrl+F5 (Windows) ou Cmd+Shift+R (Mac) para forçar um recarregamento completo da página. Isso ignora o cache do navegador e busca a formatação mais recente do servidor. Se a formatação agora aparecer, o problema estava relacionado ao cache. Para evitar problemas futuros de cache, abra a lista em uma janela InPrivate ou Anônima enquanto edita a formatação JSON.
5. Teste com um trecho JSON mínimo
   Substitua todo o seu código JSON por este exemplo mínimo:
   { "$schema": "https://developer.microsoft.com/json-schemas/sp/column-formatting.schema.json", "elmType": "div", "txtContent": "@currentField" }
   Salve a formatação. Se a coluna agora exibir o valor do campo dentro de uma div, seu JSON original tem um erro estrutural. Gradualmente, adicione de volta suas regras de formatação uma a uma, testando após cada adição, até encontrar a regra com falha.
6. Verifique se a coluna não está oculta ou removida da exibição
   Na lista, selecione a seta suspensa ao lado de um cabeçalho de coluna e escolha Configurações de coluna > Mostrar/ocultar colunas. Certifique-se de que a coluna que você está formatando esteja marcada. Se estiver oculta, a formatação não será renderizada. Verifique também as configurações de exibição: vá para a lista, clique nos três pontos ao lado de Todos os Itens e selecione Editar exibição atual. Confirme que a coluna foi adicionada à exibição.

Se a Formatação JSON Ainda Tiver Problemas Após a Correção Principal

Mesmo após aplicar os passos acima, alguns cenários causam problemas persistentes de renderização. As subseções a seguir cobrem os mais comuns.

Formatação JSON Funciona no Modo de Edição, mas Não no Modo de Exibição

Isso acontece quando o código JSON referencia um campo que não existe na exibição atual. Por exemplo, se sua formatação usa [$AssignedTo.title] mas a coluna Atribuído a não foi adicionada à exibição, o SharePoint não consegue resolver a referência. Adicione a coluna faltante à exibição editando a exibição e selecionando a coluna. Salve a exibição e recarregue a lista.

Formatação JSON Desaparece Após Migração ou Cópia do Site

Quando você move uma lista entre sites usando PowerShell, ferramentas de terceiros ou o recurso Salvar como Modelo, a formatação JSON pode não ser transferida. A formatação é armazenada no esquema da coluna, que nem sempre é exportado. Após a migração, reaplique a formatação manualmente. Abra as configurações da coluna, selecione Formatar esta coluna e cole o código JSON original. Salve a formatação.

Formatação JSON Renderiza Diferente no Celular ou na Exibição Moderna

O SharePoint renderiza a formatação JSON de forma diferente na exibição de lista moderna versus no aplicativo móvel. Algumas propriedades CSS como padding, margin e flex-direction se comportam de forma inconsistente. Para verificar a renderização no celular, abra a lista em um navegador móvel ou use as ferramentas de desenvolvedor do navegador para simular uma viewport móvel. Ajuste seu JSON para usar unidades relativas como em ou valores percentuais em vez de valores fixos em pixels.

Formatação JSON de Coluna: Tipos de Coluna Suportados vs Não Suportados

Tipo de Coluna	Formatação JSON Suportada	Caso de Uso Comum
Linha de texto única	Sim	Codificação de cores condicional com base no valor do texto
Número	Sim	Barras de progresso ou ícones condicionais para limites
Escolha	Sim	Emblemas de status com cores personalizadas por escolha
Pessoa ou Grupo	Sim	Exibir foto do perfil e nome do usuário
Data e Hora	Sim	Destacar datas vencidas com fundo vermelho
Sim/Não	Sim	Mostrar ícone de marca de verificação ou cruz
Hiperlink ou Imagem	Sim	Botão de link personalizado com efeito hover
Várias linhas de texto	Não	Use Linha de texto única
Pesquisa	Não	Crie uma coluna calculada para exibir o valor da pesquisa
Metadados Gerenciados	Não	Use uma coluna de texto com o ID do termo
Calculada	Não	Aplique formatação diretamente nas colunas de origem

Agora você pode diagnosticar sistematicamente por que sua formatação JSON de coluna não renderiza. Comece validando a sintaxe com uma ferramenta externa e confirmando que o tipo de coluna é suportado. Use o trecho de teste mínimo para isolar erros. Limpe o cache do navegador após cada edição. Para problemas persistentes, verifique a configuração da exibição e a compatibilidade com dispositivos móveis. Na próxima vez que criar uma regra de formatação, teste-a com uma única condição primeiro para evitar erros complexos. Dica avançada: use o console do desenvolvedor do navegador (F12) e procure por erros relacionados a JSON na guia Console enquanto a lista carrega — o SharePoint pode registrar falhas de análise lá.