Web Part de Links Rápidos Perde Ícones: Causas e Soluções

O web part de Links Rápidos no SharePoint permite exibir um conjunto de links com ícones para navegação rápida. Você adiciona um ícone a um link, salva a página e, depois, o ícone desaparece ou é substituído por um placeholder genérico. Esse problema geralmente ocorre porque o SharePoint armazena os ícones como referências relativas que se quebram quando a página é movida, copiada ou quando o arquivo de origem do ícone é excluído ou renomeado. Este artigo explica por que os ícones desaparecem e fornece soluções para mantê-los visíveis.

Por que os Ícones dos Links Rápidos Desaparecem

O web part de Links Rápidos armazena cada ícone de link como uma URL relativa nas propriedades do web part. Quando você adiciona um ícone do seletor de ícones do SharePoint, o sistema faz upload do arquivo de ícone para a biblioteca de Ativos do Site do site atual e cria um caminho relativo como /sites/seu-site/AtivosDoSite/nome-do-icone.png. Esse caminho funciona apenas enquanto a página permanecer no mesmo site e o arquivo permanecer nesse local exato.

Três ações comuns fazem a referência do ícone quebrar:

Movimentação ou Cópia de Página Entre Sites

Quando você move ou copia uma página para um site diferente, o web part de Links Rápidos mantém a URL relativa antiga. O arquivo de ícone não existe nesse caminho no novo site, então o SharePoint mostra um ícone de link genérico.

Exclusão ou Renomeação do Arquivo de Ícone

Se alguém excluir ou renomear o arquivo de ícone na biblioteca de Ativos do Site, o web part não consegue carregar a imagem. O campo de ícone ainda contém a URL antiga, mas o arquivo não está mais disponível.

Modelo de Site ou Salvar como Modelo

Quando você salva um site como modelo e cria um novo site a partir desse modelo, o web part de Links Rápidos referencia a pasta de Ativos do Site original. O novo site não contém esses arquivos, então todos os ícones revertem para o placeholder padrão.

Soluções para Manter os Ícones dos Links Rápidos Visíveis

As soluções a seguir evitam a perda de ícones removendo a dependência de um local de arquivo específico. Aplique o método que melhor se adequa ao seu cenário.

Solução 1: Usar Código SVG Inline

Em vez de selecionar um ícone do seletor, cole a marcação SVG diretamente no campo de ícone. O código SVG é armazenado como parte dos dados do web part e viaja com a página. Nenhum arquivo externo é necessário.

1. Encontre ou crie um ícone SVG
   Acesse um site como Flaticon ou Font Awesome, baixe o arquivo SVG ou copie o código SVG. Você também pode escrever sua própria marcação SVG.
2. Abra as propriedades do web part de Links Rápidos
   Edite a página, selecione o web part de Links Rápidos e clique no ícone de lápis para abrir o painel de propriedades.
3. Edite um link
   Clique no link que deseja alterar e, em seguida, clique no ícone de lápis ao lado desse link.
4. Cole o código SVG no campo Ícone
   No editor de links, localize o campo Ícone. Exclua qualquer valor existente e cole seu código SVG. O campo aceita marcação SVG bruta. Clique em Salvar.
5. Republicar a página
   Clique em Publicar ou Republicar para salvar as alterações. O ícone agora é exibido como um SVG inline e não será quebrado quando a página for movida.

Solução 2: Hospedar Ícones em uma Biblioteca Dedicada

Armazene seus arquivos de ícone em uma biblioteca que você controle separadamente da página. Use URLs absolutas em vez de caminhos relativos. Esse método funciona melhor quando você precisa reutilizar os mesmos ícones em vários sites.

1. Crie uma biblioteca de ícones dedicada
   No site onde deseja armazenar os ícones, crie uma nova biblioteca de documentos chamada Ícones. Faça upload de todos os arquivos de ícone para esta biblioteca.
2. Obtenha a URL absoluta de cada ícone
   Selecione um arquivo de ícone na biblioteca, clique no menu de reticências, escolha Detalhes e copie o valor do Caminho. O caminho se parece com https://seutenant.sharepoint.com/sites/seu-site/Icones/nome-do-icone.png.
3. Edite o link dos Links Rápidos
   Abra a página para edição, selecione o web part de Links Rápidos e edite o link que precisa do ícone.
4. Cole a URL absoluta no campo Ícone
   Exclua a URL relativa existente e cole a URL absoluta que você copiou. Clique em Salvar.
5. Republicar a página
   Publique a página. O ícone agora carrega da URL absoluta e permanece intacto mesmo se a página for movida para outro site, desde que a biblioteca de ícones exista nessa URL.

Solução 3: Usar uma Extensão do SharePoint Framework

Para ambientes corporativos com muitos web parts de Links Rápidos, um desenvolvedor pode criar uma extensão do SharePoint Framework (SPFx) que substitui referências de ícone quebradas por ícones de fallback. Essa solução requer habilidades de codificação e implantação no catálogo de aplicativos do locatário. Não é uma solução sem código, mas é a mais confiável para implantações em larga escala.

O que Fazer Quando os Ícones Ainda Não Aparecem

Ícones dos Links Rápidos Mostram um X Vermelho

Um X vermelho indica que o arquivo de ícone está ausente ou a URL está incorreta. Verifique se o arquivo existe no caminho armazenado no web part. Se você usou uma URL relativa, confira se a página está no mesmo site que o arquivo de ícone. Se usou uma URL absoluta, garanta que a URL esteja correta e que o arquivo não tenha sido movido ou excluído.

Ícones dos Links Rápidos Estão Borrados ou Pixelados

O web part de Links Rápidos exibe ícones em 32×32 pixels. Se o arquivo de ícone for menor que isso, pode parecer borrado. Use um arquivo SVG ou um arquivo PNG de pelo menos 64×64 pixels. O web part reduzirá a imagem, preservando a nitidez.

Ícones dos Links Rápidos Não Carregam Após Restauração da Página

Quando você restaura uma página da lixeira ou de uma versão anterior, as referências de ícone revertem ao estado em que estavam no momento do salvamento. Se o arquivo de ícone foi excluído desde então, o ícone não carregará. Reaplique o ícone usando uma das soluções acima após restaurar a página.

URL Relativa vs URL Absoluta vs SVG Inline: Métodos de Armazenamento de Ícones

Item	URL Relativa	URL Absoluta	SVG Inline
Local de armazenamento	Arquivo na biblioteca de Ativos do Site	Arquivo em qualquer biblioteca acessível	Incorporado nos dados do web part
Sobrevive a movimentação de página	Não	Sim, se a URL da biblioteca permanecer válida	Sim
Sobrevive a modelo de site	Não	Não, a menos que a biblioteca também seja modelada	Sim
Requer upload de arquivo	Sim	Sim	Não
Facilidade de atualização	Substituir arquivo na biblioteca	Substituir arquivo na URL	Editar propriedades do web part

Agora você pode evitar a perda de ícones nos Links Rápidos escolhendo um método de armazenamento que se adapte ao seu fluxo de trabalho. Use SVG inline para páginas que podem ser movidas entre sites. Use URLs absolutas para ícones compartilhados por várias páginas. Se você gerencia muitos sites, considere uma extensão SPFx para tratamento automatizado de fallback. O método SVG inline não requer arquivos adicionais e é a maneira mais simples de garantir que os ícones permaneçam visíveis.