Docs/Indicatore di Avanzamento

Indicatore di Avanzamento

L'indicatore di avanzamento è un badge opzionale che viene visualizzato accanto alla barra e indica al lettore esattamente dove si trova — in percentuale, in tempo rimanente, o entrambi.

Barra ReadNinja con un badge di percentuale
L'indicatore di percentuale visualizzato accanto alla barra.
Barra ReadNinja con un badge di tempo rimanente
L'indicatore di tempo rimanente con un suffisso personalizzato.

Tutte le opzioni

OpzioneValoriPredefinito
TipoNessuno / Percentuale / Tempo rimanente / EntrambiNessuno
PosizioneNella barra / Sinistra / DestraNella barra
Dimensione testoAuto / 8 – 32 pxAuto
Colore testoAuto (contrasto) / Colore fissoAuto
Velocità di lettura100 – 400 ppm200
Formato tempoSolo minuti / Minuti + secondiMinuti
PrefissoQualsiasi testo (es. Ancora )
SuffissoQualsiasi testo (es. rimanenti)

Il colore testo "Auto" sceglie automaticamente il nero o il bianco in base al colore della barra, così l'etichetta rimane sempre leggibile, anche se cambi la barra verso un colore chiaro o scuro.

Il Prefisso e il Suffisso ti permettono di costruire etichette naturali come Ancora 2 min rimanenti o Letto al 45% senza toccare alcun template.

Calcolo del tempo rimanente

Quando il tipo di indicatore include Tempo rimanente, ReadNinja usa il numero di parole dell'articolo e la tua velocità di lettura configurata per stimare quanto rimane da leggere.

// Formula usata internamente
const remainingSeconds = (wordCount * (1 - progress / 100)) / wpm * 60
  • wordCount — numero totale di parole nella zona di contenuto.
  • progress — avanzamento di lettura attuale, da 0 a 100.
  • wpm — l'impostazione Velocità di lettura, in parole al minuto.

Esempio concreto

Prendi un articolo di 800 parole con la velocità di lettura predefinita di 200 ppm. Il lettore ha percorso il 50% dell'articolo:

remainingSeconds = (800 * (1 - 50/100)) / 200 * 60
                 = (800 * 0.5) / 200 * 60
                 = 400 / 200 * 60
                 = 2 * 60
                 = 120 secondi

Con il formato Solo minuti predefinito, il badge mostra 2 min. Con Minuti + secondi, mostra 2:00.

Ridurre la velocità di lettura a 150 ppm sullo stesso articolo allo stesso livello di avanzamento mostrerebbe 2:40 (160 secondi). Aumentarla a 300 ppm mostrerebbe 1:20 (80 secondi).