BrowserNav

  • Autor: Tony Malykh
  • Compatibilidad con NVDA: de 2019.3 a 2023.1
  • Descargar versión estable

Complemento BrowserNav para NVDA

Este complemento proporciona a los usuarios de NVDA potentes órdenes de navegación en el modo exploración. Funciona en navegadores web, así como en cualquier otra aplicación que soporte el modo exploración de NVDA, tales como documentos de Word y clientes de correo electrónico.

Por ejemplo, con BrowserNav puedes encontrar párrafos alineados verticalmente; es decir, párrafos con el mismo desplazamiento horizontal. Se puede usar para leer árboles jerárquicos de comentarios o tablas HTML mal formadas. También te permite navegar por párrafos con el mismo tamaño de fuente o estilo. BrowserNav también proporciona nuevas órdenes de navegación de una sola letra: p para ir al siguiente párrafo e Y para ir a la pestaña siguiente.

También puedes encontrar párrafos escritos con el mismo tamaño de fuente o estilo.

BrowserNav también proporciona nuevas órdenes de navegación rápida: p para el siguiente párrafo e y para la siguiente pestaña.

Descarga

  • Versión estable actual: BrowserNav
  • Última versión en Python 2 (compatible con NVDA 2019.2 y anteriores): BrowserNav v1.1

Uso en navegadores y otros programas que soportan el modo exploración

BrowserNav puede utilizarse para navegar por desplazamiento horizontal desde el borde izquierdo de la pantalla, por tamaño o por estilo de la fuente.

  • Al navegar por desplazamiento horizontal, puedes encontrar fácilmente párrafos alineados verticalmente en la página. Concretamente, puedes pulsar NVDA+alt+flechas arriba y abajo para saltar al párrafo anterior o siguiente con la misma alineación, respectivamente. Por ejemplo, esto puede ser útil al explorar árboles jerárquicos de comentarios (como los de reddit.com) para saltar por los comentarios de primer nivel y evitar aquellos con niveles más altos.
  • Al navegar por tamaño de fuente, puedes encontrar fácilmente párrafos escritos con el mismo tamaño de fuente, un tamaño mayor o menor.
  • También puedes navegar por tamaño de fuente aplicando restricción de estilo.

El rotor de BrowserNav se usa para alternar entre estas opciones. Dependiendo del ajuste de este rotor, BrowserNav indicará mediante pitidos el desplazamiento horizontal o el tamaño de fuente del elemento seleccionado. Además, BrowserNav crepitará con las órdenes de navegación rápida para indicar cuánto texto se ha saltado (esta función sólo está disponible en Google Chrome y Firefox).

BrowserNav funciona en cualquier navegador soportado por NVDA, aunque algunas funciones pueden no estar disponibles en todos los navegadores. BrowserNav también funciona en otras aplicaciones que soportan el modo exploración de NVDA, como documentos de Word y clientes de correo electrónico.

Atajos de teclado:

  • NVDA+alt+flechas arriba y abajo: salta al párrafo anterior o siguiente con el mismo desplazamiento horizontal o tamaño de fuente.
  • NVDA+alt+inicio o NVDA+alt+flecha izquierda: salta al párrafo anterior con menos desplazamiento o mayor tamaño de fuente (párrafo padre).
  • NVDA+alt+fin o NVDA+control+alt+flecha izquierda: salta al siguiente párrafo con menos desplazamiento o mayor tamaño de fuente (párrafo padre siguiente).
  • NVDA+alt+avance página o NVDA+alt+flecha derecha: salta al siguiente párrafo con más desplazamiento o menor tamaño de fuente (párrafo hijo).
  • NVDA+alt+retroceso página o NVDA+control+alt+flecha derecha: salta al párrafo anterior con más desplazamiento o menor tamaño de fuente (párrafo hijo anterior).
  • NVDA+o: cambia el rotor entre desplazamiento horizontal, tamaño de fuente o tamaño de fuente con restricción de estilo.
  • Y o shift+y: salta a la pestaña siguiente o anterior.
  • P y shift+p: salta al siguiente diálogo o al anterior.
  • Z o shift+Z: salta al menú siguiente o anterior.
  • ` o Shift+` (comilla inversa o tilde): salta al cambio de formato siguiente o anterior.
  • \ o Shift+\ (barra invertida): desplazarse arriba o abajo para revelar cualquier elemento de la página, puede ser útil en páginas web dinámicas para cargar todos los elementos. También puede ser útil en páginas web con desplazamiento infinito para cargar el siguiente fragmento.
  • 0 o shift+0: salta a la vista en árbol siguiente o anterior.
  • 9 o shift+9: salta a la barra de herramientas siguiente o anterior.
  • NVDA+shift+flecha izquierda: volver a la posición anterior del cursor dentro del documento actual.
  • NVDA+e: edita algunos cuadros de edición semiaccesibles. Consulta la sección correspondiente más adelante.
  • T o shift+t: saltar a la tabla siguiente o anterior, pero situando el cursor en la primera celda. A veces NVDA pone el cursor antes de la primera celda y BrowserNav corrige este comportamiento.

Marcadores

BrowserNav 2.0 introduce un nuevo conjunto de características de marcadores.

Atajos de marcadores

  • NVDA+j: mostrar el menú emergente de salto rápido.
  • J o shift+j: salta al próximo marcador de salto rápido o al anterior.
  • / y control+/: alterna el modo omitir desorden para navegar por líneas (flechas arriba y abajo) y por párrafos (control+flechas arriba y abajo) respectivamente.
  • Alt+j: hace clic en todos los marcadores de clic automático en la página web.
  • Alt+1, Alt+2, ..., Alt+0: saltar al siguiente marcador jerárquico del nivel correspondiente. El 0 corresponde al nivel 10.
  • Shift+Alt+1, shift+Alt+2, ..., Alt+0: saltar al marcador jerárquico anterior del nivel correspondiente.
  • Alt+o Shift+Alt+: salta al marcador jerárquico siguiente o anterior de cualquier nivel.

Sitios

Lo primero que se debería configurar es el sitio para el que se desean crear los marcadores. En la mayoría de casos puedes querer indicar el tipo de coincidencia para que sea del dominio, o del dominio y sus subdominios. Para ilustrar la segunda opción, puedes indicar:

  • URL: amazon.com
  • Tipo de coincidencia: dominio y subdominios
  • Esto hará que coincidan amazon.com, smile.amazon.com, y todos los demás dominios *.amazon.com.

Si necesitas un control más preciso, puedes indicar también la URL exacta o definir una expresión regular para la URL.

A causa de esta definición flexible, pueden estar activos al mismo tiempo varios sitios de salto rápido en una misma página web.

Tipos de marcadores

Una vez que hayas configurado la definición del sitio, puedes proceder a definir algunos marcadores para él.

BrowserNav soporta actualmente cuatro tipos de marcadores:

  • Marcadores de salto rápido: puedes saltar a ellos pulsando j o shift+j.
  • Marcadores de saltar desorden: estos marcadores se evitan automáticamente al navegar por líneas (flechas arriba y abajo) o por párrafos (control+flechas arriba o abajo). Esto permite ocultar el desorden en páginas web, tal como líneas en blanco, marcas de tiempo u otra información redundante. La información no se elimina completamente, se puede deshabilitar temporalmente el salto de desorden con las órdenes / y control+/. Por defecto, evitar desorden se salta los párrafos vacíos en todos los sitios web.
  • Marcadores de clic automático: se pueden marcar elementos clicables, como enlaces, botones o casillas de verificación, para que sean marcadores de clic automático. Al pulsar alt+j, se pueden pulsar todos los marcadores de clic automático de la página actual con un solo atajo sin mover el cursor. Esto puede ser útil para pulsar un botón usado con frecuencia en un sitio web, como el botón de reproducción en YouTube o el botón Silenciar en sitios web de videoconferencias.
  • Marcadores jerárquicos: son similares a los marcadores de salto rápido, pero tienen en cuenta el desplazamiento horizontal del marcador. Sitios como Reddit y Hacker News tienen un árbol jerárquico de comentarios, bastante difícil de recorrer eficientemente para usuarios de lectores de pantalla. En estos sitios web puedes marcar comentarios como marcadores jerárquicos y navegar entre ellos pulsando alt+dígito o alt+shift+dígito, donde dígito es un número de la fila numérica: 1, 2, 3... 0 - que sería el nivel del comentario. Por defecto, BrowserNav tiene marcadores configurados para Hacker News y old.reddit.com. Sin embargo, fueron difíciles de configurar para el sitio web reddit.com moderno, ya que no parece haber un párrafo fácilmente localizable que identifique los comentarios.

Creación de un nuevo marcador

Una vez hayas configurado un sitio, la forma más sencilla de crear un nuevo marcador sería navegar al párrafo deseado en el documento, pulsar NVDA+j para mostrar el menú de contexto de marcadores y seleccionar Marcadores > Crear nuevo marcador para el sitio...

Se abrirá el diálogo de configuración del marcador. Ahora puedes personalizar el marcador. Puedes cambiar cómo coincide el texto (por ejemplo, coincidencia de cadena o expresión regular).

Otras opciones de este diálogo:

  • Categoría: define el tipo de marcador.
  • Nombre para mostrar: nombre opcional de este marcador para una legibilidad mejor. Simplemente da un nombre mejor para poder identificarlo en una larga lista de marcadores.
  • Mensaje hablado cuando se encuentre el marcador: mensaje opcional que se verbalizará cada vez que alcances este marcador en el documento.
  • Desplazamiento en párrafos: después de hallar una coincidencia de texto, BrowserNav desplazará el cursor tantos párrafos adelante o atrás como sea necesario. Esto puede ser útil, por ejemplo, si el texto de destino al que deseas saltar no contiene ningún texto común que pueda coincidir (p.ej. un mensaje en un foro) pero un párrafo anterior contiene una palabra coincidente (por ejemplo, votar). En este caso, puedes hacer que coincida la palabra votar y especificar desplazamiento=1, para situar el cursor en el primer párrafo del mensaje en lugar de la palabra votar.
  • Atributos: lista separada por espacios de atributos del párrafo que coinciden. La lista de atributos disponibles para el párrafo actual está disponible en el siguiente campo del formulario. La lista de atributos se rellena previamente con algunos roles comunes y normalmente no es necesario editarla.
  • Atributos disponibles en el párrafo actual: todos los atributos que se encuentran en el párrafo actual. Puedes seleccionarlos y pulsar la barra espaciadora para añadirlos a la lista de atributos coincidentes.

Opciones de sitio avanzadas

En el diálogo de configuración del sitio puedes especificar diversas opciones avanzadas:

  • Nombre para mostrar: nombre para mostrar opcional que mejore la legibilidad en la lista de sitios.
  • Modo foco: permite anular el manejo por defecto de los eventos de foco en NVDA. Ciertos sitios hacen mal uso de los eventos de foco. Para usarlos de forma más conveniente, puedes ignorarlos, o desactivar entrar automáticamente en modo foco cuando se recibe un evento de foco.
  • Modo de región viva: algunos sitios web usan mal las regiones vivas. Esta opción permite desactivar el anuncio de regiones vivas sólo en el sitio web actual.
  • Modo de pitidos de depuración: este modo se usa principalmente con propósitos de depuración. Se puede hacer que NVDA pite cuando ocurran ciertos eventos (foco, actualización de región viva o clic automático exitoso).
  • Opciones de clic automático: al configurar un marcador de clic rápido, se puede permitir que se haga clic en el marcador tras un cierto tiempo de espera una vez el sitio web está completamente cargado. Otra opción permite que BrowserNav se mantenga vigilando el sitio web y siempre que aparezca cualquier marcador de clic rápido, haga clic en él. Ten en cuenta que esta función es experimental.

Configuración

Las definiciones de marcadores se almacenan en la carpeta de configuración de NVDA, en el archivo browserNavRules.json. Puedes editar este archivo manualmente o compartirlo con alguien.

Se puede encontrar la carpeta de configuración de NVDA abriendo el menú Inicio y escribiendo: Explorar directorio de configuración del usuario de NVDA.

El archivo de configuración predeterminado de BrowserNav incluye marcadores de ejemplo.

Editar cuadros de edición semiaccesibles

Muchas aplicaciones web modernas, como Jupiter entre otras, usan cuadros de edición que no son accesibles. Por ejemplo, se muestran en blanco, pero puedes copiar texto de ellos o pegarlo con los atajos control+e, control+c y control+v.

BrowserNav ofrece una función experimental para editar estos cuadros de edición de manera más conveniente. Para usarla:

  1. Busca el cuadro de edición en la ventana del navegador.
  2. Pulsa NVDA+e.
  3. Aparecerá una nueva ventana con los contenidos del cuadro de edición.
  4. Edita los contenidos del cuadro de edición en esta ventana.
  5. Cuando acabes, puedes pulsar escape para cerrar la ventana de edición accesible y actualizar el cuadro de edición en la página web.
  6. Alternativamente, puedes pulsar control+intro, shift+intro o alt+intro. Esto cerrará la ventana de edición, actualizará el cuadro de edición y pasará el gesto a la aplicación web.
  7. Para cerrar la ventana de edición sin guardar los cambios, pulsa alt+f4.
  8. En cualquier momento, si se pierden los contenidos del texto previamente editado, pulsa NVDA+control+e para copiarlo al portapapeles.

Notas:

  • No cambies el estado del navegador. P. ej. no cambies de pestaña y no lleves el foco a otros elementos dentro de la pestaña mientras la ventana de edición de texto está abierta. Al hacerlo evitas que BrowserNav actualice el texto correctamente en el cuadro de edición.
  • Asegúrate de soltar los modificadores control, shift o alt rápidamente tras pulsar control+intro, shift+intro o alt+intro. Mantenerlos durante aproximadamente un segundo causará problemas.
  • Esta función es experimental en la actualidad. Espera una tasa de éxito del 90-95%.
  • Se ha probado exhaustivamente con Google Chrome y Firefox. Podría funcionar en otros navegadores, pero hay una mayor posibilidad de problemas, como la pérdida de información.