Risoluzione dei problemi

Soluzioni ai problemi più comuni.

Risoluzione dei problemi

Un <img> mostra ancora la sua immagine

Assicurati che l'immagine sia dentro un <Skeletonizer> attivo. Il motore nasconde il contenuto reale (visibility: hidden) sotto l'overlay SVG, quindi l'immagine dovrebbe sparire dietro la sua osso. Gli elementi di contenuto <canvas> / <video> sono un caso limite noto per la misurazione — usa v-skeleton-replace="'image'" o un <SkeletonImage> per quelli.

Il mio widget personalizzato non viene skeletonizzato correttamente

Usa v-skeleton-replace="'<kind>'" per forzare un tipo di osso, oppure v-skeleton-union per comprimere il widget in un'unica osso.

Lo skeleton lampeggia al primo paint

Il motore gira dopo l'idratazione per scelta. Collega :enabled al tuo stato di caricamento, così si attiva solo mentre i dati sono in corso. Per placeholder SSR above-the-fold, usa le primitive manuali Skeleton*, che vengono renderizzate dal server.

Non succede nulla

  • Verifica che skeletonizer.enabled non sia false globalmente (oppure chiama useSkeletonizer().enable()).
  • Verifica che il sottoalbero sia effettivamente dentro un <Skeletonizer>.
  • Se hai impostato autoScan: false, il motore non scansiona automaticamente — chiama tu refresh().

I contenuti aggiunti dopo non vengono skeletonizzati

Il MutationObserver riscansiona automaticamente, ma se i nodi sono stati aggiunti da codice al di fuori della reattività di Vue, chiama useSkeletonizer().refresh() dopo la modifica.

I colori non corrispondono al mio tema

I valori predefiniti sono grigi neutri. Sovrascrivi baseColor / highlightColor in config, tramite setTheme(), o impostando le variabili CSS --sk-*. Vedi Temi.

TypeScript non trova i componenti/composable

Esegui nuxi prepare per rigenerare i tipi e assicurati che nuxt-skeletonizer sia elencato in modules.

Ancora bloccato? Apri una issue.