AspectRatio
Dezesseis por nove
Num cartão de produto
Fone sem fio
A moldura já tem altura antes da imagem chegar.
import { AspectRatio } from '@rivocode/ui'Quando usar
Segura a proporção de uma caixa antes do conteúdo dela chegar.
<AspectRatio ratio={16 / 9}>
<img src={capa} alt="" />
</AspectRatio>
Serve para o que tem tamanho vindo de fora: imagem de produto, mapa, incorporação de vídeo. Sem ela a linha inteira pula quando a imagem carrega, e a pessoa clica no lugar errado porque o botão andou meio segundo depois de ela mirar.
Imagem, vídeo e iframe dentro dela cobrem a moldura sozinhos. Imagem menor que a caixa deixaria um vão que parece defeito de carregamento.
Por que existe, se o CSS já faz
aspect-ratio resolve isto sozinho hoje. A peça existe para a proporção virar um
número passado por prop, e não mais uma classe arbitrária escrita em cada tela,
cada uma com um valor ligeiramente diferente.
Quando não usar
Foto que a pessoa precisa ampliar, como a de um imóvel ou de um comprovante, é
ImageViewer, que abre em tela cheia com zoom; a AspectRatio só segura a
moldura. Vários cartões ou fotos que se percorrem de lado são Carousel.
Quando o tamanho não vem de fora, a peça sobra: ícone e caixa de altura fixa já
sabem quanto medem antes de carregar. E o retrato de uma pessoa é Avatar.
No React Native
Traduz: o @rivocode/ui-native exporta AspectRatio - ratio numérico, igual. A API não é a mesma do web (no nativo tudo é controlado), e a tabela de paridade diz o que muda peça a peça.
API
| Prop | Tipo |
|---|---|
ratio0.4.0Largura dividida por altura. | number |
Além destas, a peça aceita className, style, id e children, repassados ao elemento de baixo.