Docs/Indicador de Progreso

Indicador de Progreso

El indicador de progreso es un badge opcional que se muestra junto a la barra e indica al lector exactamente dónde está — en porcentaje, en tiempo restante, o en ambos.

Barra ReadNinja con un badge de porcentaje
El indicador de porcentaje mostrado junto a la barra.
Barra ReadNinja con un badge de tiempo restante
El indicador de tiempo restante con un sufijo personalizado.

Todas las opciones

OpciónValoresPredeterminado
TipoNinguno / Porcentaje / Tiempo restante / AmbosNinguno
PosiciónEn la barra / Izquierda / DerechaEn la barra
Tamaño del textoAuto / 8 – 32 pxAuto
Color del textoAuto (contraste) / Color fijoAuto
Velocidad de lectura100 – 400 ppm200
Formato del tiempoSolo minutos / Minutos + segundosMinutos
PrefijoCualquier texto (ej. Quedan )
SufijoCualquier texto (ej. min)

El color de texto «Auto» elige automáticamente negro o blanco según el color de la barra, para que la etiqueta sea siempre legible, incluso si cambias la barra a un color claro u oscuro.

El Prefijo y el Sufijo te permiten construir etiquetas naturales como Quedan 2 min o Leído al 45% sin tocar ninguna plantilla.

Cálculo del tiempo restante

Cuando el tipo de indicador incluye Tiempo restante, ReadNinja utiliza el número de palabras del artículo y tu velocidad de lectura configurada para estimar lo que queda por leer.

// Fórmula utilizada internamente
const remainingSeconds = (wordCount * (1 - progress / 100)) / wpm * 60
  • wordCount — número total de palabras en la zona de contenido.
  • progress — progreso de lectura actual, de 0 a 100.
  • wpm — el ajuste Velocidad de lectura, en palabras por minuto.

Ejemplo práctico

Toma un artículo de 800 palabras con la velocidad de lectura por defecto de 200 ppm. El lector ha avanzado el 50% del artículo:

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

Con el formato Solo minutos por defecto, el badge muestra 2 min. Con Minutos + segundos, muestra 2:00.

Reducir la velocidad de lectura a 150 ppm en el mismo artículo al mismo nivel de progreso mostraría 2:40 (160 segundos). Aumentarla a 300 ppm mostraría 1:20 (80 segundos).