Clase 07 · Módulo 05
Sistema visual, modo oscuro y accesibilidad
Sistema visual, modo oscuro y accesibilidad
Qué logras en esta clase
Tu app se ve coherente en todas sus pantallas, funciona en tema claro y oscuro y puede usarla alguien que no ve la pantalla.
- Defines los valores visuales una sola vez.
- Respetas muescas y bordes de cada teléfono.
- Compruebas la app con un lector de pantalla.
02
Qué es un sistema visual
Es la lista corta de decisiones que toda la app respeta: qué colores existen, qué tamaños de letra, cuánto espacio entre cosas, qué tan redondas son las esquinas.
Sin esa lista, cada pantalla que Claude genera elige sus propios valores. Al cabo de veinte pantallas hay catorce grises y nueve tamaños de letra, y nada se siente parte de lo mismo.
03
La regla del sistema visual
Ningún color ni tamaño se escribe directo en una pantalla. Todos salen de un único archivo con nombre.
04
Qué contiene
| Grupo | Ejemplos de valores |
|---|---|
| Colores | fondo, superficie, texto, texto secundario, acento, error |
| Espaciado | una escala corta: 4, 8, 12, 16, 24, 32 |
| Tipografía | título, subtítulo, cuerpo, nota |
| Forma | radio de esquinas, grosor de borde |
A cada valor con nombre se le llama token. Pocos y bien elegidos: una escala de seis espacios basta para casi todo.
05
Nombra por función, no por tono
const claro = { fondo: '#FFFFFF', texto: '#111111', acento: '#0A7B61' };
const oscuro = { fondo: '#0E0E0E', texto: '#F2F2F2', acento: '#3ECFA8' };Las pantallas piden fondo o texto, nunca «blanco» o «negro». Así el mismo código sirve en ambos temas y cambiar la paleta entera es editar un archivo.
06
Cómo fijarlo con Claude Code
- Define con Claude la paleta, la escala de espacios y los tamaños de letra.
- Pide el archivo de tema con esos valores.
- Anota en las instrucciones del proyecto que ninguna pantalla usa valores sueltos.
- Cada cierto tiempo, pide una búsqueda de colores escritos fuera del tema.
07
Tipografía: del sistema o propia
| Opción | Lo bueno | Lo malo |
|---|---|---|
| Fuente del sistema | Sin carga, familiar, soporta todo idioma | Se ve distinta en Android y iOS |
| Fuente propia | Identidad igual en ambos | Hay que incluirla y esperar su carga |
Las fuentes propias se cargan con expo-font, que en el SDK 58 soporta fuentes variables (un solo archivo con todos los grosores). Comprueba siempre la licencia de la fuente.
08
Áreas seguras: lo que el teléfono tapa
Las pantallas actuales tienen muescas, cámaras perforadas, esquinas curvas y una barra de gestos abajo. El área segura es la zona donde tu contenido no queda tapado.
Varía en cada modelo. No se resuelve con un margen fijo arriba: lo que calza en tu teléfono queda corto o sobra en otro.
09
Dos formas de respetarlas
| Herramienta | Qué hace | Cuándo |
|---|---|---|
SafeAreaView | Caja que ya suma el relleno necesario | Pantallas simples |
useSafeAreaInsets | Entrega las medidas de cada borde | Cuando el fondo debe llegar al borde y solo el contenido se aparta |
Ambas vienen de react-native-safe-area-context, una dependencia de Expo Router: en los proyectos de la plantilla por defecto no hace falta instalarla.
10
Detalles de las áreas seguras
- El encabezado y la barra de pestañas del sistema ya respetan su borde: no sumes relleno otra vez.
- Un botón fijo al pie necesita el relleno inferior, o queda bajo la barra de gestos.
- En web, desde el SDK 58 las áreas seguras se manejan con CSS, no con esta librería.
11
Modo oscuro: primero, permitirlo
La propiedad userInterfaceStyle de la configuración de la app (app.json) acepta tres valores:
automatic: sigue el ajuste del teléfono.light: siempre claro.dark: siempre oscuro.
Los proyectos nuevos de la plantilla por defecto usan automatic. Si la propiedad falta, la app queda en claro.
12
Después, leer el tema y aplicarlo
const esquema = useColorScheme();
const colores = esquema === 'dark' ? oscuro : claro;useColorScheme dice si el teléfono está en claro u oscuro y se actualiza cuando el usuario lo cambia. Con eso se elige la paleta, y las pantallas usan colores.fondo, colores.texto.
13
El recorrido del tema
Si un componente tiene un color escrito a mano, queda fuera de este recorrido. Es el clásico texto negro sobre fondo negro que aparece al activar el modo oscuro.
14
Probar el modo oscuro
- En un teléfono: cambia el tema en los ajustes del sistema, con la app abierta.
- En el emulador de Android:
adb shell "cmd uimode night yes"lo activa y connose desactiva. - En el simulador de iOS (solo Mac): Cmd + Shift + A.
Recorre todas las pantallas en ambos temas, incluidos modales, estados vacíos y mensajes de error.
15
Un tema oscuro no es invertir colores
- Evita el negro puro con blanco puro en textos largos: cansa.
- Las sombras casi no se ven sobre oscuro; la profundidad se da con superficies un poco más claras.
- Los colores de acento suelen necesitar una versión más luminosa.
- Las imágenes con fondo blanco resaltan demasiado.
Si no vas a cuidarlo, es mejor fijar light que entregar un modo oscuro roto.
16
Por qué la accesibilidad no es un extra
Una app accesible sirve a quien no ve o ve poco, y también a cualquiera que la use bajo el sol o con una mano ocupada.
17
Lectores de pantalla
Android trae TalkBack y iOS trae VoiceOver. Leen en voz alta el elemento que tiene el foco y permiten activarlo con gestos.
Para un lector, tu pantalla es una secuencia de elementos con nombre y función. Un ícono sin nombre se anuncia como «botón» a secas, o no se anuncia.
18
Las cuatro props que más rinden
| Prop | Responde |
|---|---|
accessibilityLabel | ¿Qué es? |
accessibilityRole | ¿Qué tipo de elemento es? (button, link, header, image…) |
accessibilityState | ¿En qué estado está? (deshabilitado, seleccionado, marcado) |
accessibilityHint | ¿Qué pasa si lo activo? |
Si no pones etiqueta, el lector arma una con los textos que haya dentro.
19
Un botón de ícono bien hecho
<Pressable
onPress={eliminar}
accessibilityRole="button"
accessibilityLabel="Eliminar pedido"
>
<IconoBasurero />
</Pressable>Sin la etiqueta, este botón no tiene nombre. El rol link se reserva para lo que abre una dirección en el navegador; las acciones dentro de la app son button.
20
Texto que crece
Muchas personas agrandan la letra en los ajustes del teléfono, y React Native lo respeta por defecto. El texto crecerá en tu app.
- No des alto fijo a cajas con texto.
- Permite que los textos pasen a otra línea.
- Prueba con la letra del sistema al máximo.
21
Contraste, color y tamaño de toque
- Contraste: la pauta WCAG nivel AA pide una relación de al menos 4,5 a 1 entre el texto normal y su fondo, y 3 a 1 para texto grande.
- Color: nunca como única señal. Un error lleva también ícono o mensaje.
- Toque: los elementos pequeños necesitan zona sensible amplia;
hitSlopla agranda. Las guías de diseño de Apple y de Android publican el mínimo recomendado.
22
Cómo comprobarlo
- Activa TalkBack o VoiceOver en los ajustes de accesibilidad de tu teléfono.
- Recorre el flujo principal sin mirar la pantalla.
- Anota cada elemento sin nombre o con nombre confuso.
- Verifica que el orden de lectura tenga sentido.
23
Errores comunes
- Colores y tamaños escritos directo en cada pantalla.
- Margen superior fijo en vez de área segura.
- Activar el modo oscuro sin recorrer todas las pantallas.
- Botones de ícono sin etiqueta o tamaño de letra bloqueado.
- Confiar en bloquear la orientación: en iOS 27,
ScreenOrientation.lockAsyncpuede no tener efecto si la app es redimensionable.
24
Lo que te llevas
- Un archivo de tema con valores nombrados por función.
- Áreas seguras con
SafeAreaViewouseSafeAreaInsets, nunca con márgenes fijos. - Modo oscuro:
userInterfaceStyle,useColorSchemey cero colores sueltos. - Etiqueta, rol y estado en todo lo tocable.
- La accesibilidad se comprueba con el lector de pantalla encendido.
25
Hazlo ahora
En 15 minutos:
- Pide a Claude Code que liste los colores escritos fuera del archivo de tema.
- Cambia tu teléfono a modo oscuro y recorre la app; anota lo que se ve mal.
- Sube la letra del sistema al máximo y repite.
- Activa el lector de pantalla y completa una tarea sin mirar.
- Entrega las tres listas a Claude y corrige primero lo que impide usar la app.
Clase terminada
Sigue con la próxima.
Fuentes · revisadas el 18 de noviembre de 2026