Pular para o conteúdo
Estrutura

AspectRatio

/componentes/aspect-ratio.mdmarkdown cru, para quem lê com agent em vez de olho

Dezesseis por nove

16 / 9

Num cartão de produto

Quadrada

Fone sem fio

A moldura já tem altura antes da imagem chegar.

Importar
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

PropTipo
ratio0.4.0

Largura dividida por altura.

number

Além destas, a peça aceita className, style, id e children, repassados ao elemento de baixo.

@rivocode/ui, 149 peças no catálogo. Esta página é gerada dos mesmos arquivos que alimentam o design system, então ela não envelhece sozinha.

Feito por RivoCode.