# Nombre, función, valor: controles para lectores de pantalla

Source: https://allyway.ai/es/glossary/nombre-funcion-valor

Nombre, función, valor es el criterio de conformidad WCAG 4.1.2: en todos los componentes de la interfaz de usuario, el nombre y el rol pueden determinarse por software, los estados, las propiedades y los valores que el usuario puede establecer pueden definirse por software y los cambios se notifican a las tecnologías de apoyo. Es de nivel A.

Nombre, función, valor es la regla que hace que los controles resulten comprensibles para las tecnologías de apoyo. Un lector de pantalla tiene que saber cómo se llama un control («Buscar»), qué es (un botón, una casilla de verificación, un menú) y en qué estado está (marcado, desplegado, 3 de 5). Cuando un `div` tiene el aspecto de un interruptor pero no expone nada de esto, los usuarios videntes que usan el ratón pueden manejarlo, pero todos los demás oyen «se puede hacer clic» o no oyen nada.

## Qué significa

El criterio [WCAG 4.1.2 Nombre, función, valor](https://www.w3.org/WAI/WCAG22/Understanding/name-role-value.html) es de nivel A y forma parte de las [WCAG 2.2](https://allyway.ai/es/regulations/wcag-2-2). En todos los componentes de la interfaz de usuario, incluidos los elementos de formulario, los enlaces y los componentes generados por scripts, exige lo siguiente:

| Parte | Qué significa | Origen habitual |
|---|---|---|
| Nombre | El software puede leer la etiqueta del control | Texto visible, `<label>`, `aria-label`, `aria-labelledby` |
| Función | Qué tipo de control es | Elemento nativo (`<button>`, `<input>`) o un rol ARIA |
| Estado, propiedad, valor | Estado actual que los usuarios pueden cambiar | `checked`, `aria-expanded`, `aria-pressed`, valor de un slider |
| Notificación | Los cambios llegan a las tecnologías de apoyo | Comportamiento nativo o atributos ARIA actualizados |

La nota del W3C resulta tranquilizadora: el criterio va dirigido sobre todo a quienes crean o programan sus propios componentes. Los controles HTML estándar ya lo cumplen cuando se usan conforme a la especificación. Los problemas empiezan con los componentes personalizados: interruptores, [pestañas](https://allyway.ai/es/glossary/pestanas-accesibles), [acordeones](https://allyway.ai/es/glossary/acordeon-accesible) y [cuadros combinados](https://allyway.ai/es/glossary/desplegable-accesible) construidos con `div` y `span`.

> **Note:** > **Primero, lo nativo**
> Un `<button>` real incluye de serie su rol, la compatibilidad con el teclado y el foco. El W3C recoge como fallo F59 el uso de scripts para convertir un `div` o un `span` en un control sin exponer su rol.

Las personas que dependen de este criterio usan [lectores de pantalla](https://allyway.ai/es/glossary/lector-de-pantalla), lupas de pantalla y software de reconocimiento de voz. Un usuario de voz solo puede decir «clic en Buscar» si el [nombre accesible](https://allyway.ai/es/glossary/nombre-accesible) del botón es realmente «Buscar».

## Ejemplos

```html title="Ejemplo"
<!-- Custom toggle: name, role and state are exposed -->
<button type="button" aria-pressed="false" id="dark-mode">
  Dark mode
</button>

<!-- Disclosure: state changes with every click -->
<button type="button" aria-expanded="false" aria-controls="faq-1">
  Shipping costs
</button>
<div id="faq-1" hidden>Shipping is free from €50.</div>
```

El script alterna `aria-pressed` o `aria-expanded` a la vez que el cambio visual. Eso cubre las partes de «valor» y «notificación»: el lector de pantalla anuncia «Shipping costs, botón, contraído» y después «expandido». Las técnicas del W3C en las que se basa son ARIA4 (un rol) y ARIA5 (atributos de estado y de propiedad); consulte [ARIA](https://allyway.ai/es/glossary/aria) para conocer los fundamentos.

**Do:** Qué hacer

Use elementos nativos siempre que sea posible, dé a cada control un nombre que coincida con su texto visible, actualice `aria-expanded`, `aria-pressed` o `aria-checked` cada vez que cambie el estado y haga que los componentes personalizados se puedan usar por completo con la [navegación por teclado](https://allyway.ai/es/glossary/navegacion-por-teclado).

**Don't:** Qué evitar

Construir botones con elementos `div` en los que se puede hacer clic, dejar sin nombre los botones de icono (un [botón vacío](https://allyway.ai/es/glossary/boton-vacio)), mostrar un estilo de «marcado» que el código nunca expone o añadir un rol sin el comportamiento de teclado que promete.

## Cómo comprobar Nombre, función, valor



## Preguntas frecuentes

Q: ¿Qué significa Nombre, función, valor en las WCAG?
A: Es el criterio de conformidad 4.1.2, de nivel A. Todo control debe exponer a las tecnologías de apoyo cómo se llama, qué tipo de control es y cuál es su estado o valor actual, y los cambios deben anunciarse.

Q: ¿Los elementos HTML estándar cumplen el criterio 4.1.2 automáticamente?
A: Sí, cuando se usan conforme a la especificación. Un `<button>` con texto o un `<input type="checkbox">` con etiqueta ya exponen nombre, rol y estado. El criterio afecta sobre todo a los componentes personalizados.

Q: ¿Hace falta ARIA para cumplir Nombre, función, valor?
A: No. La primera opción es el HTML nativo. ARIA hace falta cuando se construye un componente que HTML no ofrece, o para añadir un estado como `aria-expanded` a un botón que controla una sección.

Q: ¿Cuáles son los fallos más habituales de Nombre, función, valor?
A: Controles sin un nombre determinado por software (F68), elementos `div` o `span` convertidos en controles mediante scripts sin un rol (F59), alternativas textuales que no se actualizan cuando cambia una imagen (F20) y campos de formulario con varias partes pero un solo nombre (F86).

Q: ¿En qué se diferencia el criterio 4.1.2 del nombre accesible?
A: El nombre accesible es una parte del criterio 4.1.2. Este exige además el rol, el estado y el valor actuales, y que los cambios se transmitan a las tecnologías de apoyo.
