BackgroundPattern
Fondo decorativo detrás de cabeceras, estados vacíos o tarjetas de bienvenida: rejillas o figuras concéntricas con desvanecido.
Cuándo usarlo
Props. pattern (grid · grid-dot · grid-check · circles · squares), size (sm · md · lg: celda de 80/96 px en rejillas; 336/480/768 px en concéntricos), mask (radial · radial-down · radial-up · linear-down · linear-up · none), width/height (área de la rejilla, 1536×960 por defecto), seed (reparto de casillas en grid-check).
Visual. Líneas border-secondary de 1px; puntos utility-neutral-300 cada 32 px; casillas bg-secondary. Ocupa todo su contenedor (position: absolute; inset: 0), así que el padre necesita position: relative y el contenido, su propio position: relative para quedar encima.
Reglas. Decoración, no información: lleva aria-hidden. Uno por vista, y nunca detrás de tablas o texto largo.
Detalles. Funciona sin JavaScript. El mismo seed da siempre las mismas casillas, también entre servidor y navegador.
Diferencia con la vista previa de la guía. Bajo cada muestra, el nombre del patrón sale aquí en Geist Mono, la fuente de código de la guía; en la vista previa salía con el monospace del navegador. Es solo el pie del ejemplo, no el componente.
Ejemplos
grid · radial · md
grid-dot · radial · md
grid-check · radial · sm
circles · radial · sm
squares · radial · sm
grid · linear-down · sm
Props
| Prop | Tipo | Por defecto | Descripción |
|---|---|---|---|
pattern | "grid" · "grid-dot" · "grid-check" · "circles" · "squares" | grid | grid rejilla · grid-dot puntos cada 32px · grid-check rejilla con casillas · circles y squares
concéntricos. |
size | "sm" · "md" · "lg" | md | Celda de 80/96/96px en las rejillas; lado de 336/480/768px en los concéntricos. |
mask | "radial" · "radial-down" · "radial-up" · "linear-down" · "linear-up" · "none" | radial | Desvanecido hacia los bordes. |
width | number | 1536 | Ancho del área de la rejilla en px. |
height | number | 960 | Alto del área de la rejilla en px. |
seed | number | 7 | Reparto de las casillas en grid-check. |
className | string | — | |
style | CSSProperties | — |
Código
import { BackgroundPattern } from "@jotis-me/react";
export default function Page() {
return (
<>
<div className="relative">
<BackgroundPattern pattern="grid" size="sm" mask="radial" />
<div className="relative">Contenido</div>
</div>
</>
);
}---
import { BackgroundPattern } from "@jotis-me/react";
---
<div className="relative">
<BackgroundPattern pattern="grid" size="sm" mask="radial" />
<div className="relative">Contenido</div>
</div>