Saltar al contenido

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

16:9
html

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 skeleton si 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.

Relacionados

CardSkeletonAvatar

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.