Docs/Indicateur de Progression

Indicateur de Progression

L'indicateur de progression est un badge optionnel qui s'affiche à côté de la barre et indique au lecteur exactement où il en est — en pourcentage, en temps restant, ou les deux.

Barre ReadNinja avec un badge de pourcentage
L'indicateur de pourcentage affiché à côté de la barre.
Barre ReadNinja avec un badge de temps restant
L'indicateur de temps restant avec un suffixe personnalisé.

Toutes les options

OptionValeursDéfaut
TypeAucun / Pourcentage / Temps restant / Les deuxAucun
PositionDans la barre / Gauche / DroiteDans la barre
Taille du texteAuto / 8 – 32 pxAuto
Couleur du texteAuto (contraste) / Couleur fixeAuto
Vitesse de lecture100 – 400 mpm200
Format tempsMinutes uniquement / Minutes + secondesMinutes
PréfixeN'importe quel texte (ex. Encore )
SuffixeN'importe quel texte (ex. restantes)

La couleur de texte « Auto » choisit automatiquement le noir ou le blanc selon la couleur de la barre, pour que le libellé reste toujours lisible, même si vous changez la barre vers une couleur claire ou foncée.

Le Préfixe et le Suffixe vous permettent de construire des libellés naturels comme Encore 2 min restantes ou Lu à 45 % sans toucher au moindre template.

Calcul du temps restant

Quand le type d'indicateur inclut Temps restant, ReadNinja utilise le nombre de mots de l'article et votre vitesse de lecture configurée pour estimer ce qu'il reste à lire.

// Formule utilisée en interne
const remainingSeconds = (wordCount * (1 - progress / 100)) / wpm * 60
  • wordCount — nombre total de mots dans la zone de contenu.
  • progress — progression de lecture actuelle, de 0 à 100.
  • wpm — le réglage Vitesse de lecture, en mots par minute.

Exemple concret

Prenez un article de 800 mots avec la vitesse de lecture par défaut de 200 mpm. Le lecteur a parcouru 50 % de l'article :

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

Avec le format Minutes uniquement par défaut, le badge affiche 2 min. Avec Minutes + secondes, il affiche 2:00.

Réduire la vitesse de lecture à 150 mpm sur le même article au même niveau de progression afficherait 2:40 (160 secondes). L'augmenter à 300 mpm afficherait 1:20 (80 secondes).