Texto Alternativo do Mastodon Desaparece Após Upload de Mídia: Correção

Você faz upload de uma imagem no Mastodon, escreve sua postagem e publica. Mas, ao verificar, o texto alternativo que você escreveu sumiu. A mídia aparece sem descrição, deixando a postagem inacessível para usuários de leitores de tela. Esse problema ocorre porque a interface web do Mastodon e alguns aplicativos de terceiros lidam com os metadados do texto alternativo de forma diferente durante o processo de upload. Este artigo explica a causa raiz do texto alternativo ausente e fornece uma correção passo a passo que funciona na interface web e nos aplicativos móveis.

Por que o Texto Alternativo Desaparece Após o Upload de Mídia

O Mastodon trata o texto alternativo como uma propriedade do anexo de mídia, não da postagem em si. Quando você faz upload de uma imagem, o Mastodon cria um registro de anexo. O campo de texto alternativo existe dentro desse registro. Se você adicionar o texto alternativo antes do upload terminar, o navegador ou aplicativo pode descartar o texto porque o registro do anexo ainda não foi totalmente formado.

Outra causa comum é o design da interface. Na interface web padrão, o campo de texto alternativo aparece somente após você clicar no botão de edição na mídia enviada. Muitos usuários digitam o texto alternativo na caixa de composição principal, que o Mastodon ignora. O texto não é anexado à mídia, então desaparece.

Aplicativos de terceiros do Mastodon frequentemente reutilizam o mesmo registro de anexo em vários uploads. Se você enviar uma segunda imagem enquanto edita o texto alternativo da primeira, o aplicativo pode sobrescrever os metadados do primeiro anexo. O aplicativo salva o último conjunto de alterações e descarta os anteriores.

Como o Mastodon Armazena o Texto Alternativo Internamente

O Mastodon usa um endpoint de API de anexo de mídia. Cada anexo tem um campo description. Quando você envia a postagem, o cliente envia uma requisição PATCH para esse endpoint com o texto alternativo. Se o cliente enviar a requisição antes que o campo de descrição seja preenchido, o servidor salva uma string vazia. A postagem então mostra a mídia sem texto alternativo.

Passos para Recuperar e Preservar o Texto Alternativo no Mastodon

Siga estes passos para garantir que o texto alternativo permaneça anexado à sua mídia. Os passos funcionam na versão web 4.x do Mastodon e nos aplicativos oficiais para iOS e Android.

1. Faça upload da mídia primeiro e aguarde a miniatura aparecer
   Clique no ícone de anexo na caixa de composição. Selecione sua imagem ou vídeo. Aguarde até que a miniatura seja exibida na área de composição. Não digite o texto alternativo enquanto a barra de progresso do upload estiver visível.
2. Clique no botão de edição na mídia enviada
   Passe o mouse sobre a miniatura. Um ícone de lápis aparece no canto superior direito. Clique nele. O editor de mídia abre com um campo de texto alternativo.
3. Digite o texto alternativo no campo dedicado
   Insira uma descrição clara da imagem. Mantenha abaixo de 1.500 caracteres. O Mastodon trunca descrições mais longas em algumas visualizações.
4. Clique no botão Aplicar ou pressione Enter
   Após digitar, clique no botão Aplicar na parte inferior do editor. Não pressione Escape nem clique fora do editor — isso fecha o editor sem salvar.
5. Verifique se o texto alternativo aparece abaixo da miniatura
   Após fechar o editor, observe a caixa de composição. A miniatura agora mostra um pequeno selo ALT no canto. Esse selo confirma que o texto alternativo foi salvo.
6. Envie a postagem usando Ctrl+Enter
   Pressione Ctrl+Enter no Windows ou Cmd+Enter no Mac. Esse atalho de teclado envia a postagem sem mover o foco para fora da caixa de composição. Evite clicar no botão Publicar se o cursor ainda estiver no editor de texto alternativo.

Ativando a Interface Web Avançada para Campos de Texto Alternativo Persistentes

A interface web padrão do Mastodon esconde o campo de texto alternativo atrás do botão de edição. A interface web avançada mostra o campo diretamente abaixo de cada anexo. Isso reduz a chance de esquecer de adicionar o texto alternativo.

1. Abra Preferências
   Clique no ícone de engrenagem no canto superior direito da interface web do Mastodon. Selecione Preferências no menu.
2. Navegue até Aparência
   Na barra lateral esquerda, clique em Aparência.
3. Ative a Interface web avançada
   Marque a caixa rotulada Ativar interface web avançada. Role para baixo e clique em Salvar alterações.
4. Recarregue a página
   Atualize a aba do navegador. A caixa de composição agora mostra um campo de texto rotulado Descrever para leitores de tela diretamente abaixo de cada anexo.

Se o Mastodon Ainda Perder o Texto Alternativo Após Seguir os Passos

Texto Alternativo Ausente Após Editar uma Postagem

O Mastodon não permite editar o texto alternativo em postagens já publicadas através da interface web. Quando você edita uma postagem, o editor de mídia abre, mas quaisquer alterações no texto alternativo podem não ser salvas. Para corrigir isso, exclua a postagem e faça novamente o upload da mídia com o texto alternativo correto usando os passos acima. A API oficial do Mastodon suporta a edição de texto alternativo em postagens publicadas, mas a interface web não expõe esse endpoint. Use uma ferramenta de terceiros como a API REST do Mastodon diretamente ou um cliente como o Tusky (Android) que suporta edição de postagem com alterações de texto alternativo.

Texto Alternativo Desaparece ao Usar um Aplicativo de Terceiros

Alguns aplicativos de terceiros têm um fluxo de upload diferente. Por exemplo, o aplicativo pode fazer upload da imagem primeiro e depois pedir o texto alternativo em uma tela separada. Se você pular essa tela, o aplicativo envia a postagem sem texto alternativo. Verifique a documentação do aplicativo para o processo específico de upload de mídia. Como alternativa, abra a interface web do Mastodon no navegador do seu celular e use a interface web avançada para adicionar o texto alternativo antes de publicar.

Texto Alternativo Truncado ou Não Visível em Postagens Federadas

Quando sua postagem é federada para outra instância do Mastodon, o servidor receptor armazena o texto alternativo. Se a instância receptora estiver executando uma versão antiga do Mastodon (anterior à 3.0), pode não exibir o texto alternativo na interface web. O texto ainda está presente na resposta da API. Usuários nessa instância podem acessá-lo através de leitores de tela ou visualizando o JSON bruto da postagem. Não há correção do seu lado. O administrador da instância deve atualizar o Mastodon.

Métodos de Texto Alternativo no Mastodon: Interface Web vs Aplicativos Móveis

Item	Interface Web Padrão	Interface Web Avançada
Visibilidade do campo de texto alternativo	Oculto atrás do botão de edição	Sempre visível abaixo de cada anexo
Número de cliques para adicionar texto alternativo	3 cliques (upload, editar, aplicar)	2 cliques (upload, digitar diretamente)
Atalho de teclado para enviar	Ctrl+Enter ou Cmd+Enter	Ctrl+Enter ou Cmd+Enter
Selo de texto alternativo na miniatura	Mostra selo ALT após salvar	Mostra selo ALT após digitar

Os aplicativos oficiais do Mastodon para iOS e Android mostram o campo de texto alternativo imediatamente após o upload, similar à interface web avançada. Os aplicativos não exigem clicar em um botão de edição. Após o upload, digite a descrição no campo rotulado Texto alternativo que aparece abaixo da imagem.

Para garantir que o texto alternativo nunca esteja ausente, crie o hábito de verificar o selo ALT na miniatura antes de publicar. Ative a interface web avançada no desktop. No celular, use o aplicativo oficial em vez de um cliente de terceiros. Se você gerencia uma instância do Mastodon, mantenha o software atualizado para a versão estável mais recente para que todos os usuários se beneficiem do suporte completo da API de texto alternativo.