[Image] Excessively long alternative text

Abierto
  • ¿Algo no está bien?
#873 4 comentarios 0 reacciones 0 asignados Ver en GitHub

Los mantenedores suelen responder en 2 días

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
2/5
Tiempo estimado
1-3 horas
Aptitud para principiantes
45/100
Tipo de issue
Error
Claridad
Bien especificado
Estado de actividad
Estancado
Área
accessibility, content

Línea de trabajo

Busca en el contenido de tutorials/ y tutorials/setting-up-your-environment/ los dos atributos alt exactos que se muestran en el issue. Acorta cada descripción hasta dejar solo su propósito esencial, conservando la información útil, y verifica después que las imágenes renderizadas tengan un texto alternativo conciso y que los tutoriales sigan mostrándose correctamente.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

Accessibility: Low Severity
Title

[Image] Excessively long alternative text

Description

An image (<img>) element on the page with very long (over 100 characters) alternative text. Non-text content must convey the same purpose or information as presented visually. When alt text is too long, users who rely on it may miss essential context or struggle to understand the content.

Steps to Reproduce
  1. go to tutorials/ and tutorials/setting-up-your-environment/
  2. Locate to the following element
<img class="aspect-photo object-cover" height="293" width="440" src="/_astro/SetupA.MT9CUmVs_UdPSt.webp" loading="eager" decoding="async" alt="An interactive sketch in the p5.js Web Editor draws circles on the canvas as the mouse pointer moves." style="">

<img height="1152" width="2048" src="/_astro/p5_editor_sign_up_page.ti-nvYfB_Z17jU5E.webp" loading="lazy" infersize="true" decoding="async" aspectratio="none" alt="An arrow pointing to the highlighted User Name, Emaill, Password, and Confirm Password fields on the Sign Up page." style="">
Actual Behavior

The image’s alt attribute contains more than 100 characters of description.

Expected Behavior

Alternative text should be concise and focused, describing the essential content and function of the image in a brief phrase or sentence.

Environments

No response

Suggested Fix
  1. Keep the alt text brief and focused—describe only the image’s essential purpose in a few words.
  2. If readers need more context, place supplementary details next to the image or link to a separate description page.
  3. Avoid hiding unique information solely in the alt text; ensure all critical content is visible elsewhere on the page.
Reference
What is your operating system?

None

Web browser and version

No response

Lenguaje dominante
MDX
Estrellas
97
Forks
330
Merge medio
3 d 15 h
PR fusionados (30 d)
13

Preparar el entorno

Este proyecto no incluye contenedor de desarrollo, Dockerfile ni guía de contribución, así que la configuración corre por tu cuenta: empieza por su README y consulta nuestra guía para la primera contribución para los pasos generales.

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de processing/p5.js-website

Todos los issues de processing/p5.js-website

Issues similares

Más issues de Accessibility

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.