Script WhatsApp Web

Informações sobre o script para o WhatsApp Web

O WhatsApp Web With More Accessibility é um script que fiz para que nós, usuários de leitores de tela, possamos trabalhar com o WhatsApp Web com mais autonomia, praticidade e confiança.

Vídeo de instalação

Assista o vídeo em que eu falo um pouco sobre acessibilidade e usabilidade no WhatsApp Web e mostro passo a passo como realizar a instalação do script em seu navegador:

Informações e instalação

Seguem informações sobre o script e sua instalação:

Para utilização do script WhatsApp Web With More Accessibility, é necessário ter instalada a extensão Tampermonkey no navegador (Google Chrome, Mozilla Firefox, Opera, Microsoft Edge ou Safari). Após isso, basta acessar o script, que será reconhecido pelo Tampermonkey, e clicar em instalar.
Tudo isso é explicado passo a passo no vídeo anterior.

Depois de instalar o script para o WhatsApp Web (WhatsApp Web With More Accessibility), ao acessar a página, Deve-se aguardar o carregamento da aplicação e então utilizar o atalho ALT + S.
Caso o script esteja desativado, será exibida a mensagem: Script ativado com sucesso; se o script já estiver ativado, será dado um alerta com a mensagem Script desativado.
Ao desativá-lo, todos os elementos e atalhos criados por ele serão removidos, exceto o atalho de ativação e desativação.

Elementos e rótulos adicionados

Com o WhatsApp Web With More Accessibility ativado, serão aplicadas as seguintes modificações:

  • Antes do painel com a listagem de conversas haverá um cabeçalho de nível 1 H1 para facilitar a navegação via screen reader, ao pressionar a tecla h ou o número 1 no modo de navegação;
  • Após abrir uma conversa, no início da área do contato / grupo haverá um cabeçalho de nível H2, com o rótulo Conversa ativa + NOME DO CONTATO/GRUPO, que poderá ser acessado pressionando a tecla ‘h’ ou o número 2 no modo de navegação;
  • Os botões de emoji estarão etiquetados acima do campo de escrita de mensagem no rodapé;
  • Após o campo de escrita de mensagem haverá um botão que estará com o rótulo “Gravar mensagem de voz” caso o campo de texto esteja limpo, ou “Enviar mensagem de texto” caso esteja preenchido;
  • Ao clicar no botão “Gravar Mensagem de Voz”, irá surgir abaixo do campo de mensagem um botão “Cancelar gravação”, o tempo da gravação e um outro botão com o rótulo “Enviar mensagem de voz”;

Teclas de atalho

Depois de ativar o WhatsApp Web With More Accessibility, as seguintes teclas de atalho estarão disponíveis:

  • ALT + a: coloca o foco nas opções para escolher o tipo de anexo a ser enviado na conversa ativa;
  • ALT + B: coloca o foco no campo de busca e o rotula como “Buscar nas conversas e nos contatos…”;
  • ALT + C: coloca o foco na lista de conversas;
  • ALT + E: coloca o foco no campo de escrita de mensagem e o rotula como “Escreva uma mensagem (nome da conversa ativa)”;
  • ALT + G: foca o botão para gravar uma mensagem de voz. Para iniciar a gravação é só clicar no botão “Gravar mensagem de Voz”;
  • ALT + i: exibe informação sobre a versão do script;
  • ALT + L: abre uma caixa de opções para selecionar o idioma do script (Português, Inglês ou Espanhol), após pressionar a tecla ‘enter’ na opção desejada as mensagens do script passam a estar naquele idioma;
  • ALT + M: coloca o foco na lista de mensagens da conversa ativa;
  • ALT + N: abre um campo editável para enviar mensagem para um número de WhatsApp válido no formato (código do país, DDD e número: 5531988776655). Após digitar somente números é só pressionar enter;
  • ALT + S: ativa e desativa o script;
  • ALT + T: fala o título da conversa ativa;
  • 1 do teclado alfanumérico: vai para o progresso do áudio, e com setas esquerda e direita é possível avançar e retroceder a reprodução;
  • 2 do teclado alfanumérico: Em um áudio em reprodução, aumenta a velocidade de 1.0 para 1.5; de 1.5 para 2.0 e de 2.0 retorna para 1.0;
  • 3 do teclado alfanumérico: oculta ou exibe o texto original de uma mensagem de resposta;
  • ALT + seta para baixo: vai para próxima conversa e cai com foco no campo de edição de mensagem;
  • ALT + seta para cima: vai para a conversa anterior e cai com foco no campo de edição de mensagem.

OBS.: as vezes o NVDA não entra em modo de foco automaticamente ao utilizar os atalhos, Então talvez seja necessário colocá-lo em modo de foco com o atalho NVDA + barra de espaço. Outras teclas podem ser configuradas como tecla NVDA, mas por padrão é o ‘Insert’.

Passos para Favoritar, deletar, encaminhar ou baixar mensagens

A janela que o atalho ALT + D se refere, só será exibida depois que os seguintes passos forem realizados:

  1. Utilizar o atalho ALT + M para ir para lista de mensagens;
  2. Se certificar de que o NVDA está no modo de foco (no Jaws é o cursor virtual desativado);
  3. Ao chegar sobre a mensagem que deseja encaminhar, apertar seta para direita;
  4. Clicar no botão encaminhar. Assim será aberta a janela com as opções.

Se nessa janela você escolher realmente encaminhar, então ao clicar o foco irá para uma lista para você selecionar o contato para o qual deseja encaminhar aquela mensagem. Escolha o contato utilizando a seta para baixo ou para cima e precionando ‘enter’. Caso deseje escolher mais contatos, caminhe com setas novamente e aperte ‘enter’ no outro contato. Quando quiser enviar, utilize o atalho ALT + V. Dessa forma, somente aquela mensagem será encaminhada. Para selecionar mais mensagens, depois que a janela com as opções for aberta, não clique no botão ‘encaminhar’. Utilize o atalho ALT + M para retornar à lista de mensagens, e utilize a ‘barra de espaço’ para selecionar outras mensagens. Depois de selecioná-las, utilize o atalho ALT + D para retornar para a janela com as opções, clique no botão ‘encaminhar’ e selecione os contatos e depois envie com ALT + V. Caso não queira encaminhar, você pode clicar nos outros botões:

  • Se clicar em ‘favoritar’ aquelas mensagens ficarão como favoritas;
  • caso clique em ‘deletar’ outra janela entrará em foco, então você confirma se deseja realmente deletar ou cancelar;
  • ou se clicar em ‘baixar’ o download será realizado. Caso mais de uma mensagem esteja selecionada, o arquivo baixado estará no formato.zip, que você pode utilizar programas como WINRAR ou WINZIP para descompactá-lo.

Atualização do script

Ao ser ativado, o script irá verificar se há uma nova versão. Caso haja, será atualizado e será informada a nova versão.

Links para extensão e script

WhatsApp Web script information

WhatsApp Web With More Accessibility is a script I made so that we, screen reader users, can work with WhatsApp Web with more autonomy, practicality and confidence.

Installation Video

Watch the video in which I talk a little about accessibility and usability on WhatsApp Web and show you step by step how to install the script in your browser:

Script information

The following is information about the script and its installation:

To use the WhatsApp Web With More Accessibility script, you must have the Tampermonkey extension installed on your browser (Google Chrome, Mozilla Firefox, Opera, Microsoft Edge or Safari). After that, just access the script, which will be recognized by Tampermonkey, and click install.
All this is explained step by step in the previous video.

After installing the script for WhatsApp Web (WhatsApp Web With More Accessibility), when accessing the page, you must wait for the application to load and then use the shortcut ALT + S.
If the script is deactivated, the message will be displayed: Script activated successfully; if the script is already enabled, an alert will be given with the message Script disabled.
When deactivating it, all elements and shortcuts created by it will be removed, except the activation and deactivation shortcut.

Added elements and labels

With WhatsApp Web With More Accessibility enabled, the following modifications will apply:

  • Before the panel with the conversation listing there will be a level 1 header H1 to facilitate navigation via screen reader, when pressing the h key or the number 1 in browse mode;
  • After opening a conversation, at the beginning of the contact/group area there will be an H2 level header, labeled Active conversation + CONTACT/GROUP NAME, which can be accessed by pressing the ‘h’ key or the number 2 on the navigation mode;
  • The emoji buttons will be labeled above the message writing field in the footer;
  • After the message writing field there will be a button labeled “Record voice message” if the text field is clear, or “Send text message” if it is filled in;
  • By clicking the “Record Voice Message” button, a “Cancel Recording” button will appear below the message field, the recording time and another button labeled “Send Voice Message”;

Shortcut keys

After enabling WhatsApp Web With More Accessibility, the following hotkeys will be available:

  • ALT + a: puts focus on the options to choose the type of attachment to send in the active conversation;
  • ALT + B: puts focus on the search field and labels it as “Search in conversations and contacts…”;
  • ALT + C: puts focus on the conversation list;
  • ALT + E: puts focus on the message writing field and labels it as “Write a message (name of active conversation)”;
  • ALT + G: Focus the button to record a voice message. To start recording just click on the “Record Voice Message” button;
  • ALT + i: display script version information;
  • ALT + L: opens an option box to select the script language (Portuguese, English or Spanish), after pressing the ‘enter’ key on the desired option, the script’s messages will be in that language;
  • ALT + M: puts focus on the message list of the active conversation;
  • ALT + N: opens an editable field to send a message to a valid WhatsApp number in the format (country code, area code and number: 5531988776655). After typing only numbers just press enter;
  • ALT + S: toggles the script on and off;
  • ALT + T: speak the title of the active conversation;
  • 1 from alphanumeric keyboard: goes to audio progress, and with left and right arrows it is possible to forward and rewind playback;
  • 2 of alphanumeric keyboard: In an audio playing, increases the speed from 1.0 to 1.5; from 1.5 to 2.0 and from 2.0 back to 1.0;
  • 3 from alphanumeric keyboard: hides or displays the original text of a reply message;
  • ALT + down arrow: go to next conversation and drop focus on message edit field;
  • ALT + Up Arrow: Go to the previous conversation and drop focus into the message edit field.

NOTE: sometimes NVDA does not enter focus mode automatically when using the shortcuts, so you may need to put it in focus mode with the NVDA shortcut + spacebar. Other keys can be configured as NVDA key, but by default it is ‘Insert’.

Steps to Favorite, Delete, Forward or Download Messages

The window that the shortcut ALT + D refers to will only be displayed after the following steps are performed:

  1. Use shortcut ALT + M to go to message list;
  2. Make sure NVDA is in focus mode (in Jaws it’s the virtual cursor disabled);
  3. When you reach the message you want to forward, press the right arrow;
  4. Click the forward button. This will open the window with the options.

If in this window you choose to actually forward, then when you click the focus will go to a list for you to select the contact you want to forward that message to. Choose the contact using the down or up arrow and pressing ‘enter’. If you want to choose more contacts, walk with arrows again and press ‘enter’ on the other contact. When you want to send, use the shortcut ALT + V. That way, only that message will be forwarded. To select more messages, after the options window is opened, do not click on the ‘forward’ button. Use the shortcut ALT + M to return to the message list, and use the ‘spacebar’ to select other messages. After selecting them, use the shortcut ALT + D to return to the window with the options, click on the ‘forward’ button and select the contacts and then send with ALT + V. If you do not want to forward, you can click on the other buttons :

  • If you click ‘favorite’ those messages will be favorites;
  • if you click ‘delete’ another window will come into focus, so you confirm if you really want to delete or cancel;
  • or if you click on ‘download’ the download will be performed. If more than one message is selected, the downloaded file will be in.zip format, which you can use programs like WINRAR or WINZIP to unzip it.

Script Update

When activated, the script will check for a new version. If there is, it will be updated and the new version will be informed.

Links to extension and script

informacion sobre el script WhatsApp Web

WhatsApp Web Con Más Accesibilidad es un script que hice para que los usuarios de lectores de pantalla podamos trabajar con WhatsApp Web con más autonomía, practicidad y confianza.

Vídeo de instalación

Mira el video en el que hablo un poco sobre accesibilidad y usabilidad en WhatsApp Web y te muestro paso a paso cómo instalar el script en tu navegador:

Información del guión

La siguiente es información sobre el script y su instalación:

Para usar el script WhatsApp Web con más accesibilidad, debe tener instalada la extensión Tampermonkey en su navegador (Google Chrome, Mozilla Firefox, Opera, Microsoft Edge o Safari). Después de eso, acceda al script, que será reconocido por Tampermonkey, y haga clic en instalar.
Todo esto está explicado paso a paso en el vídeo anterior.

Después de instalar el script para WhatsApp Web (WhatsApp Web Con Más Accesibilidad), al acceder a la página, debe esperar a que cargue la aplicación y luego usar el atajo ALT + S.
Si el script está desactivado, se mostrará el mensaje: Script activado con éxito; si el script ya está habilitado, se dará una alerta con el mensaje Script deshabilitado.
Al desactivarlo, se eliminarán todos los elementos y accesos directos creados por él, excepto el acceso directo de activación y desactivación.

Elementos y etiquetas añadidos

Con WhatsApp Web con más accesibilidad habilitado, se aplicarán las siguientes modificaciones:

  • Antes del panel con el listado de conversaciones habrá un encabezado de nivel 1 H1 para facilitar la navegación a través del lector de pantalla, al pulsar la tecla h o el número 1 en modo navegación;
  • Después de abrir una conversación, al comienzo del área de contacto/grupo habrá un encabezado de nivel H2, etiquetado Conversación activa + NOMBRE DE CONTACTO/GRUPO, al que se puede acceder presionando la tecla ‘h’ o el número 2 en el modo de navegación;
  • Los botones emoji estarán etiquetados encima del campo de escritura del mensaje en el pie de página;
  • Después del campo de escritura del mensaje habrá un botón llamado “Grabar mensaje de voz” si el campo de texto está vacío, o “Enviar mensaje de texto” si está lleno;
  • Al hacer clic en el botón “Grabar mensaje de voz”, aparecerá un botón “Cancelar grabación” debajo del campo del mensaje, el tiempo de grabación y otro botón con la etiqueta “Enviar mensaje de voz”;

Teclas de acceso directo

Después de habilitar WhatsApp Web con más accesibilidad, estarán disponibles las siguientes teclas de acceso rápido:

  • ALT + a: pone el foco en las opciones para elegir el tipo de archivo adjunto a enviar en la conversación activa;
  • ALT + B: pone el foco en el campo de búsqueda y lo etiqueta como “Buscar en conversaciones y contactos…”;
  • ALT + C: pone el foco en la lista de conversaciones;
  • ALT + E: pone el foco en el campo de escritura del mensaje y lo etiqueta como “Escribir un mensaje (nombre de la conversación activa)”;
  • ALT + G: enfoca el botón para grabar un mensaje de voz. Para comenzar a grabar, simplemente haga clic en el botón “Grabar mensaje de voz”;
  • ALT + i: muestra la información de la versión del script;
  • ALT + L: abre un cuadro de opción para seleccionar el idioma del script (portugués, inglés o español), luego de presionar la tecla ‘enter’ en la opción deseada, los mensajes del script estarán en ese idioma;
  • ALT + M: pone el foco en la lista de mensajes de la conversación activa;
  • ALT + N: abre un campo editable para enviar un mensaje a un número de WhatsApp válido en el formato (código de país, código de área y número: 5531988776655). Después de escribir solo números, simplemente presione enter;
  • ALT + S: activa y desactiva el script;
  • ALT + T: decir el título de la conversación activa;
  • 1 desde el teclado alfanumérico: va al progreso del audio, y con las flechas izquierda y derecha es posible avanzar y retroceder la reproducción;
  • 2 de teclado alfanumérico: En una reproducción de audio, aumenta la velocidad de 1.0 a 1.5; de 1.5 a 2.0 y de 2.0 a 1.0;
  • 3 desde el teclado alfanumérico: oculta o muestra el texto original de un mensaje de respuesta;
  • ALT + flecha hacia abajo: ir a la siguiente conversación y colocar el foco en el campo de edición del mensaje;
  • ALT + Flecha arriba: Ir a la conversación anterior y colocar el foco en el campo de edición del mensaje.

NOTA: a veces, NVDA no entra en el modo de enfoque automáticamente cuando usa los atajos, por lo que es posible que deba ponerlo en modo de enfoque con el atajo de NVDA + barra espaciadora. Se pueden configurar otras claves como clave NVDA, pero por defecto es ‘Insertar’.

Pasos para agregar a favoritos, eliminar, reenviar o descargar mensajes

La ventana a la que hace referencia el atajo ALT + D solo se mostrará después de realizar los siguientes pasos:

  1. Utilice el atajo ALT + M para ir a la lista de mensajes;
  2. Asegúrate de que NVDA esté en modo de enfoque (en Jaws el cursor virtual está deshabilitado);
  3. Cuando llegue al mensaje que desea reenviar, presione la flecha derecha;
  4. Haga clic en el botón de avance. Esto abrirá la ventana con las opciones.

Si en esta ventana elige reenviar realmente, cuando haga clic en el foco irá a una lista para que seleccione el contacto al que desea reenviar ese mensaje. Elija el contacto usando la flecha hacia abajo o hacia arriba y presionando ‘enter’. Si desea elegir más contactos, camine con flechas nuevamente y presione ‘enter’ en el otro contacto. Cuando quieras enviar, usa el atajo ALT + V. De esa forma, solo se reenviará ese mensaje. Para seleccionar más mensajes, después de abrir la ventana de opciones, no haga clic en el botón ‘reenviar’. Use el atajo ALT + M para regresar a la lista de mensajes y use la ‘barra espaciadora’ para seleccionar otros mensajes. Después de seleccionarlos, use el atajo ALT + D para volver a la ventana con las opciones, haga clic en el botón ‘reenviar’ y seleccione los contactos y luego envíe con ALT + V. Si no desea reenviar, puede hacer clic en los otros botones :

  • Si hace clic en ‘favorito’, esos mensajes serán favoritos;
  • si hace clic en ‘eliminar’, aparecerá otra ventana, de modo que confirme si realmente desea eliminar o cancelar;
  • o si hace clic en ‘descargar’, se realizará la descarga. Si se selecciona más de un mensaje, el archivo descargado estará en formato .zip, que puede usar programas como WINRAR o WINZIP para descomprimirlo.

Actualización del guión

Cuando está activado, el script buscará una nueva versión. Si la hay, se actualizará y se informará la nueva versión.

Enlaces a extensión y secuencia de comandos