jotis.meRegula

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

PropTipoPor defectoDescripción
pattern"grid" · "grid-dot" · "grid-check" · "circles" · "squares"gridgrid rejilla · grid-dot puntos cada 32px · grid-check rejilla con casillas · circles y squares concéntricos.
size"sm" · "md" · "lg"mdCelda 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"radialDesvanecido hacia los bordes.
widthnumber1536Ancho del área de la rejilla en px.
heightnumber960Alto del área de la rejilla en px.
seednumber7Reparto de las casillas en grid-check.
classNamestring—
styleCSSProperties—

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>
		</>
	);
}