AspectRatio
Mantiene una relación de aspecto fija para su contenido — imágenes, video, iframes, mapas — para que nada salte mientras carga. La relación va en data-ts-ratio; el hijo directo llena la caja.
Estructura · TaishoDS Core, en HTML plano.
Ejemplos
Un ejemplo por caso, funcionando. Cada ejemplo es el HTML de su vista previa: se copia tal cual y, con el CSS y el JS del Core cargados, se ve y funciona igual.
Miniatura de video en 16:9
Cuándo usarlo
- Se va a insertar un medio de tamaño desconocido y el layout no debe saltar.
- Todas las piezas de una grilla tienen que tener la misma forma.
- Es un embed (video, mapa) que necesita una caja proporcional.
Cuándo no
- La imagen tiene un alto fijo conocido: no hace falta.
- Es contenido de texto: la altura la manda el texto.
Cómo usarlo
- La relación se elige por el contenido real (16/9 para video, 1/1 para retratos).
- Combinalo con
skeletonsi el medio tarda en llegar.
Cómo no usarlo
- No se usa para recortar algo que hay que ver entero.
- No se ponen varios hijos: el que llena la caja es el hijo directo.
TaishoDS Core
Necesita el JS del Core: lo engancha por atributos data-ts-*.
El ratio es un valor continuo: lo lee la hoja de estilos desde --ts-aspect-ratio, y esa variable la escribe el Core. Hasta que el Core corre, sólo se ven bien 1 y 16/9, que además llevan su clase (ts aspect-square, aspect-video); cualquier otro ratio se ve cuadrado.
El Core lo engancha por estos atributos. Van en el marcado; no hace falta inicializar nada.
data-ts-ratio
Qué hace: El ratio se pasa en data-ts-ratio="1.3333" sobre el elemento. El Core lo lleva a --ts-aspect-ratio al iniciar y cada vez que el atributo cambia. No hay interacción: es sólo el valor de reposo.
Sin build, desde el CDN: taisho.aspect-ratio.css, además de taisho.base.css. Con ese archivo alcanza.
Para el funcionamiento general del Core, ver Comportamiento.
Accesibilidad
- Contenedor puramente visual: no aporta semántica ni entra en el orden de foco.
Verificación
Qué se probó de verdad. Lo que no se probó lo dice: preferimos un «sin verificar» a una afirmación de más.
- axe WCAG 2.2 A + AA en navegador real, en tema claro y oscuro, antes de cada versión.
- teclado No agrega teclas propias: usa el comportamiento nativo del navegador.
- lector de pantalla Sin verificar con lector de pantalla. Conviene probarlo en la combinación de componentes propia, no sólo aquí, donde cada uno aparece solo y en su estado feliz.