@hanzo/ui

Cuadrícula

Una cuadrícula CSS de verdad, cuyas pistas salen del contenedor y no de los hijos. Una prop para las columnas, y ningún breakpoint.

Una cuadrícula hecha a mano — cada hijo a width: calc(25% - 7.5px) — solo queda pareja mientras cada hijo esté de acuerdo, y una palabra larga deja la fila despareja. Eso no se arregla afinando el número. Aquí el padre declara las pistas una vez y los hijos no tienen voto: las columnas iguales son cosa de la estructura, y ningún hijo puede ensanchar su propia pista.

import { Cell, Grid } from '@hanzo/ui/grid'

Grid está en su propio subpath porque renderiza un div con display: grid, y ni lo uno ni lo otro existe en React Native. La API se nombra en términos de CSS grid — columns y rows son listas de pistas, Cell coloca y abarca — así que un motor de cuadrícula nativo cambia el archivo y no los puntos de llamada.

Columnas

columns acepta cualquier forma de escribir una lista de pistas: un número, una lista, o una lista de pistas ya escrita.

<Grid columns={3} gap="$3">
  <Tile>1</Tile>
  <Tile>2</Tile>
  <Tile>3</Tile>
</Grid>
1
2
3

Un número se vuelve repeat(3, minmax(0, 1fr)) y no 1fr, porque 1fr a solas significa minmax(auto, 1fr) y auto apoya el suelo de la pista en el contenido: una cadena que no se parte empuja entonces su columna y la hace más ancha. Esa es la fila despareja que el componente existe para impedir, así que la grafía larga es el propósito.

<Grid columns={['2fr', '1fr']} gap="$3">
  <Tile>main</Tile>
  <Tile>aside</Tile>
</Grid>
main
aside

Un número dentro de una lista son píxeles; cualquier otra cosa ya es un tamaño de pista.

Las que quepan

La forma responsive es un valor de columns, no una segunda prop, y no lleva ningún breakpoint dentro. min es lo más estrecha que puede quedar una columna antes de que la cuadrícula suelte una, y max pone techo al número.

<Grid columns={{ min: 160, max: 4 }} gap="$3">
  <Tile>1</Tile>
  <Tile>2</Tile>
  <Tile>3</Tile>
  <Tile>4</Tile>
  <Tile>5</Tile>
  <Tile>6</Tile>
</Grid>
1
2
3
4
5
6

Cambia el tamaño de la ventana: el número sigue a la columna en la que está la cuadrícula, así que el mismo bloque queda bien dentro de una barra lateral que no había visto nunca. min se escribe min(160px, 100%) y no un 160px pelado, así que un teléfono más estrecho que el suelo obtiene una pista a todo el ancho en vez de un scroll de lado. max se pliega en el mismo suelo — una M-ésima de la fila, restados los gaps — así que el techo no cuesta nada en una pantalla pequeña.

Celdas

Un hijo a secas no necesita envoltorio. Una Cell existe para abarcar o para colocar: un número abarca tantas pistas, una cadena es un grid-column tal como está escrito.

<Grid columns={4} gap="$3">
  <Cell col={2}><Tile>col=2</Tile></Cell>
  <Tile>3</Tile>
  <Tile>4</Tile>
  <Cell col="1 / -1"><Tile>col="1 / -1"</Tile></Cell>
</Grid>
col=2
3
4
col=“1 / -1”

row es lo mismo página abajo. rows en la cuadrícula da tamaño a las pistas de fila; sin ello, las filas se miden por el contenido.

Hueco

gap es un token de espacio o un número de píxeles en crudo. Un token lee la rampa en el documento — gap="$4" es var(--space-4) — así que una persona que mueve la densidad en el panel de apariencia mueve con ella cada cuadrícula. Un número resuelto al renderizar queda fijo en ese momento.

La lista de pistas, ella misma

tracks(columns, gap) se exporta porque es toda la decisión del componente: cualquier forma de escribir columns, a la única lista de pistas que significa, con los dos invariantes de arriba dentro.

import { tracks } from '@hanzo/ui/grid'

tracks(3)                       // 'repeat(3, minmax(0, 1fr))'
tracks({ min: 240 })            // 'repeat(auto-fill, minmax(min(240px, 100%), 1fr))'