DocumentazioneExperience Cloud KCS

Dynamic Media di AEM: la trasparenza PNG viene visualizzata come sfondo bianco

Ultimo aggiornamento: 11 agosto 2026

Questo articolo descrive come risolvere i problemi in cui le immagini PNG con sfondi trasparenti vengono visualizzate con uno sfondo bianco anziché con trasparenza in Adobe Experience Manager Dynamic Media.

Descrizione description

Ambiente

Dynamic Media di Adobe Experience Manager (AEM) (tutte le versioni)

Sintomi

  • Le immagini PNG con sfondi trasparenti vengono caricate in DAM e visualizzate in modo trasparente nelle anteprime delle risorse.
  • Quando queste immagini vengono utilizzate su pagine web o sono accessibili tramite URL di consegna diretta, la trasparenza viene sostituita da uno sfondo bianco.
  • In alcuni casi, l’utilizzo del parametro fmt=png-alpha nell’URL di consegna non risolve il problema.
  • Non vengono visualizzati messaggi di errore; il problema riguarda il rendering delle immagini.

Causa

Per impostazione predefinita, Dynamic Media restituisce immagini con uno sfondo opaco, a meno che la trasparenza non sia esplicitamente richiesta utilizzando fmt=png-alpha. Se questo parametro non è presente o non è configurato correttamente, lo sfondo apparirà bianco.

Risoluzione resolution

Per risolvere il problema, segui i passaggi seguenti:

  1. Verifica che l’URL di consegna dell’immagine includa il parametro fmt=png-alpha per richiedere esplicitamente il PNG con trasparenza alfa.
  2. Se utilizzate un predefinito immagine, verificate che sia configurato per l’output di PNG con trasparenza alfa. Se necessario, aggiorna il predefinito per includere fmt=png-alpha.
  3. Dopo aver aggiornato gli URL o i predefiniti, cancella la cache del browser e la cache CDN per garantire che venga trasmessa l’immagine più recente.
  4. Incorpora l’immagine in una pagina HTML di base per verificare che la trasparenza sia riprodotta correttamente all’esterno dell’interfaccia utente di AEM. Se la trasparenza viene visualizzata correttamente qui, il problema potrebbe riguardare le impostazioni CSS o di sfondo della pagina.
  5. Verificare le impostazioni di ImageServer. Per impostazione predefinita, se la trasparenza non è richiesta in modo esplicito, ImageServer restituisce immagini con un colore di sfondo opaco (il valore predefinito è bianco). Aggiorna la richiesta o il predefinito per garantire che la trasparenza sia sempre richiesta per le risorse che lo richiedono.

Dopo aver completato questi passaggi, verifica che la trasparenza PNG venga visualizzata correttamente sulle pagine web.

recommendation-more-help
experience-cloud-kcs-help-kbarticles