Diferencia entre revisiones de «Principio 3/3.1 Leíble/3.1.1-A»

De WCAG Wiki
Sin resumen de edición
 
(No se muestran 109 ediciones intermedias del mismo usuario)
Línea 1: Línea 1:
== '''3.1.1- A. Idioma de la página''' ==
{{CriterioWCAG
|id_wcag_criterio=3.1.1
|id_wcag_subcriterio=3.1.1-A
|wcag_titulo_criterio=3.1.1-A. Idioma de la página
|wcag_nivel=A
|wcag_version=2.0
|wcag_principio=3_Comprensible
|wcag_principio_url=Principio_3
|wcag_pauta=3.1_Legible
|wcag_pauta_url=Principio_3/3.1_Legible
|wcag_grupo=Lenguaje
|wcag_subgrupo=Idioma_principal
|wcag_subcriterio_url=Principio_3/3.1_Legible/3.1.1-A


=== Identificación General del Criterio ===
|wcag_discapacidades=
<li class="discapacidad-item">
  [[Archivo:Sinvision.png|20px|class=icon-discapacidad|alt=Discapacidad visual total]]
  <span class="discapacidad-texto">[[:Categoría:Discapacidad visual total|Visual total]]</span> –
  <span class="gravedad gravedad-grave">Barrera grave</span>
</li>
<li class="discapacidad-item">
  [[Archivo:Cognitiva.png|20px|class=icon-discapacidad|alt=Discapacidad cognitiva]]
  <span class="discapacidad-texto">[[:Categoría:Discapacidad cognitiva|Cognitiva]]</span> –
  <span class="gravedad gravedad-moderada">Barrera moderada</span>
</li>


<html>
|wcag_lista_discapacidades=
  <article class="wcag-card">
[[Categoría:Discapacidad visual total]]
 
[[Categoría:Discapacidad cognitiva]]
    <dl class="wcag-info">
      <div>
        <dt>Nivel</dt>
        <dd>A</dd>
      </div>
      <div>
        <dt>Versión</dt>
        <dd>2.2</dd>
      </div>
      <div>
        <dt>Principio</dt>
        <dd>Comprensible</dd>
      </div>
      <div>
        <dt>Pauta</dt>
        <dd>3.1 Legible</dd>
      </div>
      <div>
        <dt>Categoría</dt>
        <dd>Contenido</dd>
      </div>
      <div>
        <dt>Subcategoría</dt>
        <dd>Texto</dd>
      </div>
    </dl>
 
    <section class="wcag-users" aria-labelledby="usuarios-afectados-titulo">
      <p id="usuarios-afectados-titulo">Usuarios afectados</p>
      <ul>
        <li>
          <img src="https://www.wikiwcag.udl.cat/images/0/08/IconoVisual.jpg" alt="Icono de una persona con discapacidad visual" />
          <span>Personas con discapacidad visual total</span>
        </li>
        <li>
          <img src="https://www.wikiwcag.udl.cat/images/2/2d/IconoBajaVision.jpg" alt="Icono de lector de pantalla" />
          <span>Usuarios de lector de pantalla</span>
        </li>
        <li>
          <img src="https://www.wikiwcag.udl.cat/images/1/19/UsuarioGenerico.png" alt="Icono de persona genérica" />
          <span>Otros con dificultades de percepción o comprensión textual</span>
        </li>
      </ul>
    </section>
  </article>
</html>
 
 
=== Descripción y comprensión del criterio ===
==== Descripción resumida ====
<span class="wcag-info-intro">El idioma predeterminado de cada página web puede ser determinado por software.</span>
 
==== Objetivo ====
<span class="wcag-info-intro">
Proporcionar la información necesaria para que los agentes de usuario puedan presentar el texto y otro contenido lingüístico de forma correcta.
</span>


==== Ejemplo ====
|wcag_texto_criterioOAW=
<span class="wcag-info-intro">Un caso real o hipotético que ayude a entenderlo.</span>
Se debe identificar el idioma principal de la página con los atributos adecuados según la gramática usada y con un código de idioma correcto.


==== Importancia de cumplir el criterio ====
|wcag_descripcion_resumida=
<span class="wcag-info-intro">
El idioma principal de la página debe declararse correctamente para que los agentes de usuario puedan pronunciar y procesar el contenido sin errores.
Para que los usuarios que utilizan un lector de pantalla puedan comprender el texto leido por la herramienta.
</span>


==== Referencias WCAG / Técnicas ====
|wcag_objetivo=
<div class="wcag-info-intro">
Proporcionar la información necesaria para que los agentes de usuario puedan presentar el texto y otro contenido lingüístico de forma correcta, especialmente lectores de pantalla.
Se indican las referencias con las pautas 2.1:
* H57: Using the language attribute on the HTML element
* H57: Using the language attribute on the HTML element
* H57: Using the language attribute on the HTML element
* H57: Using the language attribute on the HTML element
 
</div>


==== Recursos de apoyo ====
|wcag_importancia=
<div class="wcag-info-intro">
Las personas usuarias de lectores de pantalla dependen de la identificación correcta del idioma para recibir pronunciación adecuada. Un marcado incorrecto genera errores de comprensión y dificulta el acceso al contenido.
Se indica un video con un ejemplo del criterio.


<html>
|wcag_referencias=
  <iframe width="640" height="360"
<ul>
          src="https://www.youtube.com/embed/Ed8CNJrkm74?start=4950"
<li><span lang="en">[https://www.w3.org/WAI/WCAG21/Techniques/html/H57 H57: Using the language attribute on the HTML element]</span></li>
          title="Video de YouTube"
          frameborder="0"
          allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share"
          allowfullscreen>
  </iframe>
</html>


</div>
|wcag_recursos=


=== Evaluación y aplicación práctica ===
<ul>
==== Tipo de comprobación ====
<li>Atributos <code>lang</code> y <code>xml:lang</code></li>
<span class="wcag-info-intro">Comprobación Manual </span>
<li>Códigos BCP47 (ej: <code>es</code>, <code>en-US</code>, <code>ca</code>)</li>
<li>[https://www.w3.org/International/articles/language-tags Language tags in HTML and XML]


==== Procedimiento de evaluación ====
<div class="wcag-info-intro">Pasos específicos para verificar el cumplimiento.


<span class="paso-badge>Paso 1.</span>
|wcag_tipo_evaluacion=Manual
Usando la herramienta de inspección de código del navegador, comprobar que existe el elemento con los atributos lang y/o xml:lang. Buscar en la etiqueta <strong> html </strong> y comprobar el atributo <strong>"lang"</strong>:


<code class="wcag-codigo-html">
|wcag_pasos_evaluacion=
<html lang="XXXX">
<ol class="paso-list">
</code>
<li><span class="paso-badge">Paso 1.</span>
Usando la herramienta de inspección de código del navegador, comprobar que existe el elemento <code>&lt;html&gt;</code> con los atributos <code>lang</code> y/o <code>xml:lang</code>.
</li>


<span class="paso-badge>Paso 2.</span>
<li><span class="paso-badge">Paso 2.</span>
Verificar que el código de idioma sigue la sintaxis correcta.
Verificar que el código de idioma sigue la sintaxis correcta.
** Tabla de [https://www.w3schools.com/tags/ref_language_codes.asp ISO 639-1 Language Codes] (lenguajes genéricos)
</li>
** [https://datatracker.ietf.org/doc/html/rfc5646 Tags for Identifying Languages] (dialectos de lenguajes)
</ol>
</div>
 
==== Herramientas recomendadas ====
<span class="wcag-info-intro">Bookmarklets, extensiones, validadores, etc</span>
 
'''Herramienta de inspección Bookmarklet'''


<html>
|wcag_resultado_evaluacion=
<div class="highlight-box">
El idioma principal de la página está identificado y coincide con el idioma del contenido.
    <strong>Arrastra este botón a tu barra de marcadores:</strong>


    <a class="bookmarklet-button"
|wcag_ejemplo_evaluacion=
      href="javascript:(function(){alert('Idioma de la página:\n' + document.documentElement.lang);})();">
<pre class="wcag-codigo-html">
      Consultar idioma de la página
<html lang="es">
    </a>
<body>
  </div>
  <h1>Bienvenido</h1>
</body>
</html>
</html>
</pre>


==== Ejemplo accesible ====  
|wcag_otras_herramientas_evaluacion=
<span class="wcag-info-intro">
<ul>
Descripción + código + enlace + video (si aplica).
<li>
</span>
<strong>Bookmarklet:</strong><br>
<html>
<html>
<div class="accessibility-card">
<div class="highlight-box">
    <p>Identificación correcta del idioma: Ingles de Reino unido. “en-GB” </p>
Clica o arrastra este botón a tu barra de marcadores y podrás ejecutarlo y ver el idoma de otras páginas. <br>
    <img src="https://www.wikiwcag.udl.cat/images/0/0e/3.1.1-A-202425.jpg" alt="">
    <pre>Explicación del ejemplo "El código HTML tiene atributo alt="en-GB" que es el idioma (inglés) en el que está escrito el contenido de la página"</pre>
    <pre> URL  <a href="https://www.sony.com.cn/">página web de SONY  (china)</a> </pre>
    <pre> VIDEO  <a href="https://youtu.be/Ed8CNJrkm74?t=5086">video de ejemplo accesible</a></pre>


   </div>
<a class="bookmarklet-button"
  href="javascript:(function(){alert('Idioma de la página:  \n ' + document.documentElement.lang);})();">
   Ver el idioma de la página
</a>
</div>
</html>
</html>
</li>


==== Ejemplo no accesible ====
<li>'''Inspección del código''': comprobar que el idioma principal de la página está indicado usando el atributo <code>lang</code> en la etiqueta <code>&lt;html&gt;</code> con un código de idioma válido (p. ej., <code>lang="es"</code>, <code>lang="en"</code>).</li>
<span class="wcag-info-intro">Descripción + código + enlace + video (si aplica).
<li>'''Validadores HTML''': usar el validador del W3C u otras herramientas automáticas para detectar la ausencia del atributo <code>lang</code> o códigos incorrectos.</li>
</span>
<li>'''Prueba con lectores de pantalla''': (NVDA, JAWS, VoiceOver) cargar la página desde el inicio y comprobar que el lector anuncia el idioma correcto.</li>
 
<li>'''Herramientas del navegador''': revisar el árbol accesible (Accessibility panel en DevTools) para confirmar que el idioma está reconocido correctamente.</li>
<html>
</ul>
 
<div class="accessibility-card-error">
    <p>El idioma no se identifica de forma adecuada en el atributo alt.
Se escribe el idioma "en" y deberia ser "ch" </p>
    <img src="https://www.wikiwcag.udl.cat/images/b/bc/3.1.1-NA-202425.jpg" alt="">
    <pre>alt="Se muestra un atributo lang no valido porque no se identifica el idioma de forma adecuada"</pre>
    <pre> URL <a href="https://www.sony.co.uk/">página web de SONY  (inglaterra)</a></pre>
    <pre> VIDEO  <a href="https://youtu.be/Ed8CNJrkm74?t=5042">video de ejemplo NO accesible</a></pre>
  </div>
</html><span> </span>
 
==== Implementación correcta ====
<span class="wcag-info-intro">Código HTML/CSS/JS correcto o buenas prácticas.
</span>
 
==== Errores comunes ====
<span class="wcag-info-intro">Lo que se suele hacer mal.</span>
 
==== Criterios relacionados ====
<span class="wcag-info-intro">Otros criterios que pueden verse afectados o complementarse.</span>
 
=== Metadatos complementarios ===
==== Versión del documento / ficha ====
<span class="wcag-info-intro">Fecha y versión de actualización</span>


==== Autor / fuente de referencia ====
}}
<span class="wcag-info-intro">Quién elaboró la ficha o de dónde se tomó</span>

Revisión actual - 06:09 6 nov 2025

3.1.1-A. Idioma de la página

Discapacidades afectadas

Este criterio puede afectar a distintas personas con discapacidad. A continuación se indican las más relevantes.

Enunciado del criterio (Observatorio de Accesibilidad Web)

  • Se debe identificar el idioma principal de la página con los atributos adecuados según la gramática usada y con un código de idioma correcto.

Comprensión del criterio

Descripción resumida

El idioma principal de la página debe declararse correctamente para que los agentes de usuario puedan pronunciar y procesar el contenido sin errores.

Objetivo

Proporcionar la información necesaria para que los agentes de usuario puedan presentar el texto y otro contenido lingüístico de forma correcta, especialmente lectores de pantalla.

Importancia de cumplir el criterio

Las personas usuarias de lectores de pantalla dependen de la identificación correcta del idioma para recibir pronunciación adecuada. Un marcado incorrecto genera errores de comprensión y dificulta el acceso al contenido.

Referencias WCAG

Recursos de apoyo

Evaluación del criterio

Tipo de evaluación

Evaluación Manual

Procedimiento de evaluación

  1. Paso 1. Usando la herramienta de inspección de código del navegador, comprobar que existe el elemento <html> con los atributos lang y/o xml:lang.
  2. Paso 2. Verificar que el código de idioma sigue la sintaxis correcta.

Resultado esperado

El idioma principal de la página está identificado y coincide con el idioma del contenido.

Ejemplo

<html lang="es">
<body>
  <h1>Bienvenido</h1>
</body>
</html>

Otras herramientas de evaluación

  • Bookmarklet:
    Clica o arrastra este botón a tu barra de marcadores y podrás ejecutarlo y ver el idoma de otras páginas.
    Ver el idioma de la página
  • Inspección del código: comprobar que el idioma principal de la página está indicado usando el atributo lang en la etiqueta <html> con un código de idioma válido (p. ej., lang="es", lang="en").
  • Validadores HTML: usar el validador del W3C u otras herramientas automáticas para detectar la ausencia del atributo lang o códigos incorrectos.
  • Prueba con lectores de pantalla: (NVDA, JAWS, VoiceOver) cargar la página desde el inicio y comprobar que el lector anuncia el idioma correcto.
  • Herramientas del navegador: revisar el árbol accesible (Accessibility panel en DevTools) para confirmar que el idioma está reconocido correctamente.










Ejemplos accesibles y no accesibles creados por alumnos

Comentarios

A continuación se muestran comentarios sobre el criterio 3.1.1-A. Idioma de la página

Loading comments...