Skip to content

fix(app): announce the selected state in report, publish and emoji panel - #736

Open
romulofer wants to merge 1 commit into
Varanda-org:mainfrom
romulofer:fix/a11y-publicar-denunciar
Open

romulofer wants to merge 1 commit into
Varanda-org:mainfrom
romulofer:fix/a11y-publicar-denunciar

Conversation

@romulofer

Copy link
Copy Markdown
Contributor

O que muda e por quê

Parte da #153: o leitor de tela não anunciava alguns estados em Publicar, Denunciar e no painel de emojis.

  • Denunciar: "esta publicação" e "a conta toda" guardavam o estado selecionado num View em volta do botão, que o leitor não lê. O Pill ganhou a prop selected e o próprio botão anuncia o estado. Sem a prop, nada muda.
  • Publicar: o grupo "Publicar como" ganha nome, e cada opção ganha aria-checked (a web descarta accessibilityState).
  • Painel de emojis: a fileira de grupos vira tablist, cada aba ganha aria-selected, e "Nenhum emoji encontrado" passa a ser anunciado ao buscar.

Fica aberto na #153: teste com VoiceOver e TalkBack e com fonte ampliada, e o alvo de toque de 32 pt das abas de emoji.

Issue

Refs #153 (a issue segue aberta: faltam os critérios de leitor de tela num aparelho)

Como verificar

  • node apps/app/test/a11yCompose.test.js (4 testes novos, todos falham sem a correção)
  • npm test -w apps/app e npm run lint
  • Caminhada com TalkBack, VoiceOver e navegador em docs/verification/fix-a11y-publicar-denunciar.md

Checklist

  • npm run lint e npm run demo passam; npm test -w apps/app passa (377 arquivos, 0 falhas). Não rodei npm test na raiz nem --affected.
  • docs/protocol.md ou docs/rpc.md: não se aplica, nenhum formato mudou
  • Entrada do changelog em docs/changelog/fix-a11y-publicar-denunciar.md e verificação em docs/verification/fix-a11y-publicar-denunciar.md
  • Textos para o usuário estão em pt-BR
  • Conferido no Android e no simulador iOS: não conferi, só os testes de código-fonte. A caminhada com leitor de tela está na verificação, sem marcar.
  • Nenhum segredo, chave ou dado pessoal no diff

@romulofer
romulofer requested a review from a team as a code owner November 17, 2026 11:15

@rodrigopavezi rodrigopavezi left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Obrigado pelo PR! A direção está certa e o teste segue o padrão dos outros testes do compositor. Dois pontos antes do merge, nos comentários de linha:

  1. Denunciar na web: o estado do Pill vai só em accessibilityState, que o react-native-web descarta, então na web as duas opções continuam sem anunciar qual está selecionada.
  2. "Nenhum emoji encontrado": a região viva nasce junto com o texto a cada busca, e no iOS accessibilityLiveRegion não existe. Do jeito que está, provavelmente só o Android anuncia.

O terceiro comentário é opcional.

A falha de android-build e native não é deste PR: o Maven Central respondeu 429 (limite de pedidos) ao baixar o plugin do Gradle. O próximo push roda a CI de novo.

Uma nota de processo: a #153 está sem responsável. Da próxima vez, peça na issue para ser responsável e espere a atribuição antes de começar (CONTRIBUTING.md).

Comment thread apps/app/src/ui/Pill.js
<Pressable
accessibilityRole='button'
accessibilityState={{ disabled: off }}
accessibilityState={selected === undefined ? { disabled: off } : { disabled: off, selected: selected === true }}

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

No nativo, isso resolve. Na web, o react-native-web descarta accessibilityState (o comentário acima do ReasonRow, em Denunciar.js, diz isso), então "esta publicação" e "a conta toda" continuam mudas lá. Sugestão: com selected definido, passe também aria-pressed={selected === true} neste Pressable, porque num botão o aria-selected não vale. Outra saída é as duas opções virarem radio com aria-checked, como o ReasonRow. Vale um teste para o atributo da web, como os de Chip e das abas.

<ScrollView key={hits ? 'q:' + query.trim() : 'g:' + group} style={styles.scroll} nestedScrollEnabled keyboardShouldPersistTaps='handled'>
{shown.length === 0
? <Text style={styles.empty}>Nenhum emoji encontrado</Text>
? <Text style={styles.empty} accessibilityLiveRegion='polite' aria-live='polite'>Nenhum emoji encontrado</Text>

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

O ScrollView acima troca de key a cada busca, então este Text é montado já com o texto. Na web, uma região viva inserida junto com o conteúdo costuma não ser anunciada: ela precisa já existir antes de o texto mudar. No iOS, accessibilityLiveRegion não existe. Sugestão: deixe uma região viva sempre montada fora do ScrollView com chave, vazia quando há resultados, e, para o iOS, chame AccessibilityInfo.announceForAccessibility('Nenhum emoji encontrado') quando a busca passa a não ter resultado.

{pagesOn({ hosted: node.hosted, accountOrigin: node.accountOrigin }) && roster.length > 0
? (
<View style={styles.asRow} accessibilityRole='radiogroup'>
<View style={styles.asRow} accessibilityRole='radiogroup' accessibilityLabel='Publicar como'>

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Opcional: o grupo agora tem o nome "Publicar como" e o Text visível logo abaixo repete o mesmo texto, então na web o leitor pode dizer duas vezes. Dá para esconder esse Text do leitor (aria-hidden, ou importantForAccessibility='no' mais accessibilityElementsHidden no nativo).

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants