Fundo da Seção Não Salva: Causa Raiz e Correção

Ao definir uma imagem ou cor de fundo em uma seção de página moderna do SharePoint, a alteração pode desaparecer após salvar e republicar a página. Isso acontece porque o recurso de fundo da seção depende de uma propriedade específica de web part que pode ser substituída por configurações de layout de página ou políticas de tema. Este artigo explica a causa raiz exata do problema e fornece uma correção passo a passo que preserva o fundo em todos os tipos de seção.

Por que o Fundo da Seção Desaparece Após Salvar

As páginas modernas do SharePoint permitem definir uma imagem ou cor de fundo em qualquer seção. A configuração é armazenada na definição JSON da página. Ao salvar e publicar a página, o SharePoint renderiza novamente o layout da página. Durante esse processo, duas coisas podem fazer o fundo ser perdido.

Primeiro, se a seção contiver uma web part que tenha sua própria propriedade de fundo, como a web part Hero ou a web part Quick Links com fundo, o fundo no nível da seção pode ser sobrescrito pelo fundo da web part. O SharePoint prioriza o fundo da web part sobre o fundo da seção.

Segundo, o tema do site pode substituir os fundos de seção. Um tema personalizado que define um fundo para a classe CSS da seção forçará a seção a usar o fundo do tema em vez daquele definido no editor de páginas. Essa é uma causa comum quando o tema é aplicado no nível do conjunto de sites ou no nível do locatário.

Terceiro, o tipo de seção importa. Uma seção padrão de três colunas não suporta imagens de fundo da mesma forma que uma seção de largura total. Se você definir um fundo em uma seção padrão, o SharePoint pode descartar a propriedade durante o salvamento porque o contêiner de layout não aceita a propriedade de fundo em todos os caminhos de renderização do navegador.

Passos para Corrigir o Problema de Salvar o Fundo da Seção

Siga estes passos em ordem. Teste após cada passo para confirmar que o fundo permanece após a publicação.

1. Altere a seção para largura total
   Edite a página. Selecione a seção que perde o fundo. No painel de configurações da seção, altere o layout para Seção de largura total. Seções de largura total são o único tipo de seção que salva de forma confiável imagens e cores de fundo personalizadas. Após alterar o layout, defina o fundo novamente. Salve e publique a página.
2. Verifique se há web parts com fundo próprio
   Abra a página no modo de edição. Observe cada web part na seção problemática. Se uma web part tiver uma cor ou imagem de fundo definida, remova o fundo da web part. Para fazer isso, edite a web part, vá para o painel de layout ou estilo e defina o fundo como Nenhum ou Transparente. Salve a web part. Em seguida, defina o fundo da seção novamente. Publique a página.
3. Crie um tema personalizado que não substitua os fundos de seção
   Se o problema persistir, o tema do site provavelmente está sobrescrevendo o fundo da seção. Vá para Central de administração do SharePoint > Temas > Temas personalizados. Crie um novo tema. No JSON do tema, não inclua uma propriedade de fundo para a classe da seção. Exporte o tema atual do site usando PnP PowerShell. Procure pela propriedade sectionBackground ou sectionBackgroundImage. Remova essas propriedades do JSON. Carregue o tema modificado. Aplique o tema ao conjunto de sites. Em seguida, defina o fundo da seção na página novamente.
4. Limpe o cache do navegador e republique
   Após fazer alterações, limpe o cache do navegador para o site. No Chrome, pressione Ctrl+Shift+Delete, selecione Imagens e arquivos em cache e limpe. Recarregue a página. Abra a página no modo de edição, defina o fundo da seção novamente e publique. Isso força o SharePoint a renderizar o JSON da página sem dados de tema em cache.
5. Use a API REST do SharePoint para verificar a propriedade de fundo
   Se o fundo ainda desaparecer, verifique o JSON da página diretamente. Abra as ferramentas de desenvolvedor do navegador (F12). Vá para a guia Rede. Recarregue a página. Encontre a chamada de API para obter o conteúdo da página. Procure pela propriedade sectionBackground no JSON. Se a propriedade estiver ausente após a publicação, o fundo foi removido durante o salvamento. Isso confirma um conflito de tema ou web part. Repita os passos 2 e 3.

Se o Fundo da Seção Ainda Não Salvar Após a Correção Principal

O fundo da seção funciona no modo de edição, mas não no modo de exibição

Isso indica um conflito de CSS. O navegador aplica o fundo no modo de edição porque o editor injeta estilos inline. No modo de exibição, o CSS do tema substitui o estilo inline. Para corrigir, adicione uma substituição de CSS personalizada. Vá para Configurações do Site > Página mestra e escolha um arquivo CSS personalizado. Adicione o seguinte CSS: div[data-automation-id="CanvasSection"] { background-image: none !important; background-color: inherit !important; }. Isso impede que o tema sobrescreva o fundo da seção. Em seguida, defina o fundo da seção novamente no editor de páginas.

A imagem de fundo não aparece em dispositivos móveis

As páginas modernas do SharePoint usam design responsivo. Em viewports móveis, os fundos de seção às vezes são ocultados para melhorar o desempenho. Isso é proposital. Para forçar o fundo no celular, você deve usar uma seção de largura total e definir a imagem de fundo com uma fonte de alta resolução. Além disso, adicione uma media query CSS: @media (max-width: 640px) { div[data-automation-id="CanvasSection"] { background-image: url('sua-url-da-imagem') !important; } }. Carregue este CSS no arquivo CSS personalizado do site.

A cor de fundo volta ao branco após a publicação

Um fundo branco após a publicação sugere que o tema tem um fundo branco padrão para seções. Vá para Central de administração do SharePoint > Temas > Temas personalizados. Edite o tema ativo. No JSON do tema, encontre a propriedade sectionBackgroundColor. Defina-a como uma string vazia ou remova a propriedade. Aplique o tema atualizado. Em seguida, defina a cor da seção novamente na página.

Causa Raiz	Método de Correção	Tempo para Aplicar
Tipo de seção padrão não suporta fundo	Alterar seção para largura total	1 minuto
Fundo da web part substitui fundo da seção	Remover fundo da web part	2 minutos
Tema personalizado sobrescreve fundo da seção	Modificar JSON do tema para remover propriedade sectionBackground	10 minutos
Conflito de CSS no modo de exibição	Adicionar substituição de CSS personalizada	5 minutos

Agora você pode corrigir o problema de salvar o fundo da seção alterando o tipo de seção para largura total, removendo fundos conflitantes de web parts e ajustando o tema do site. Comece aplicando a correção de seção de largura total. Se o fundo ainda não salvar, verifique o JSON do tema. Como dica avançada, use a API REST do SharePoint para inspecionar o JSON da página após cada correção e confirmar que a propriedade de fundo está presente na definição da página salva.