Taster

진단부품톤 고르기
부품 갤러리 / Point field

Point field

Motion effect and particles

A GPU or canvas point cloud in neutral tones that forms shapes slowly, or thin noise-driven lines on a calm surface, replacing purple orbs and aurora blobs.

내 사이트에서 가져오기

색을 고르면 아래 부품이 그 색으로 바뀝니다.

실제로 돌아가는 부품입니다. 눌러 보고 입력해 보세요.

내 앱에 넣기

  1. 아직 npm 패키지가 없어서 Taster 리포를 받아 그 안의 명령을 씁니다. 내 앱 폴더가 들어 있는 폴더에서 한 번만 받습니다.

    git clone https://github.com/makim-414/taster.git && npm ci --prefix taster/packages/engine
  2. 내 앱 폴더에서 이 부품을 넣습니다. 부품 파일과 토큰 파일이 src/components/taster 에 들어갑니다.

    node ../taster/packages/engine/cli.mjs add motion/point-field --from https://taster-six.vercel.app --dir src/components/taster
  3. 부품은 Tailwind 클래스로 그리고, Taster 프리셋이 그 클래스를 토큰에 연결합니다. Tailwind CSS 를 설치하고, tokens.css 를 앱 루트에서 한 번 불러온 뒤, 앱 루트에 이 설정을 둡니다. 프리셋이 없으면 빌드는 되어도 부품이 스타일 없이 나옵니다.

    // tailwind.config.cjs
    module.exports = {
      presets: [require('./src/components/taster/tailwind-preset.cjs')],
      content: ['./index.html', './src/**/*.{ts,tsx}'],
    };

    Tailwind v3 는 이 파일을 그대로 읽습니다. v4 는 Tailwind 를 불러오는 src/ 의 스타일시트 맨 위에 이 두 줄을 넣습니다.

    @import "tailwindcss";
    @config "../tailwind.config.cjs";

    tokens.css 는 :root 에 --bg, --text, --border, --accent 를 정의합니다. 내 앱의 스타일시트가 같은 이름을 뒤에서 다시 정의하면 그쪽 색이 이깁니다. 새 Vite 앱의 스타터 CSS 처럼 그런 변수가 있으면 지우거나 이름을 바꾸세요.

언제 쓰나요

  • Ambient backgroundA GPU or canvas point cloud in neutral tones that forms shapes slowly, or thin noise-driven lines on a calm surface, replacing purple orbs and aurora blobs.

대신 없애 주는 AI 티

  • Aurora or mesh blob background (BG-01)
  • Purple gradient (COL-01)
  • Near-black background with a neon glow (COL-03)

정보

설치할 패키지
tailwindcss
라이선스
MIT
코드 보기
import * as React from 'react'
import { cn } from '../blocks/_cn'
import { useReducedMotion } from './_motion'

// Point field: a quiet backdrop of small points that drift slowly on a 2D canvas behind a section's
// content. One neutral ink read from the tokens (the canvas takes its color from --text-subtle through
// currentColor, so a theme or a brand change follows), one to one and a half pixel points at 25 to 45
// percent opacity, depth carried by size and lightness, never by hue.
// The first frame is drawn at once and the page reads finished without it: the canvas is aria-hidden,
// ignores the pointer, and sits on the section surface. The loop pauses off screen and in a hidden tab,
// the point count follows the area (fewer on phones), the pixel ratio is capped at 2, and under reduced
// motion one still frame is drawn and nothing moves.
// Follows patterns/ambient-background: no blurred color orbs (BG-01), no neon glow (COL-03), no cursor chase,
// slower than reading speed. "wave" lays the points along slow sine bands; "drift" scatters them.
// Original code, MIT.

export interface PointFieldProps extends React.HTMLAttributes<HTMLDivElement> {
  mode?: 'drift' | 'wave'
  /** Points per 10,000 square pixels. Default 8 (about 300 on a 1100 by 280 band), capped at 2,000. */
  density?: number
  /** 0 to 1. Default 0.35. */
  speed?: number
  /** Content drawn above the field. */
  children?: React.ReactNode
}

interface Pt {
  x: number
  y: number
  z: number
  p: number
}

export function PointField({ mode = 'wave', density = 8, speed = 0.35, className, children, ...props }: PointFieldProps) {
  const wrap = React.useRef<HTMLDivElement>(null)
  const canvas = React.useRef<HTMLCanvasElement>(null)
  const reduce = useReducedMotion()

  React.useEffect(() => {
    const host = wrap.current
    const cv = canvas.current
    const ctx = cv?.getContext('2d')
    if (!host || !cv || !ctx) return
    let w = 0
    let h = 0
    let pts: Pt[] = []
    let raf = 0
    let t = 0
    let visible = true
    const dpr = Math.min(window.devicePixelRatio || 1, 2)

    function seed() {
      const r = host!.getBoundingClientRect()
      w = Math.max(1, Math.round(r.width))
      h = Math.max(1, Math.round(r.height))
      cv!.width = Math.round(w * dpr)
      cv!.height = Math.round(h * dpr)
      const n = Math.min(2000, Math.round(((w * h) / 10000) * density))
      pts = Array.from({ length: n }, () => ({ x: Math.random() * w, y: Math.random() * h, z: Math.random(), p: Math.random() * Math.PI * 2 }))
    }

    function draw() {
      const color = getComputedStyle(cv!).color
      ctx!.setTransform(dpr, 0, 0, dpr, 0, 0)
      ctx!.clearRect(0, 0, w, h)
      ctx!.fillStyle = color
      for (const q of pts) {
        let x = q.x
        let y = q.y
        if (mode === 'wave') {
          // Each point rides a slow sine band; nearer points (higher z) move a little more.
          y = q.y + Math.sin(q.x * 0.008 + t * 0.6 + q.p * 0.15) * (10 + q.z * 14)
          x = (q.x + t * (4 + q.z * 6)) % w
        } else {
          x = (q.x + Math.cos(q.p + t * 0.2) * 12 * q.z + t * 3 * (0.5 + q.z)) % w
          y = q.y + Math.sin(q.p + t * 0.25) * 10 * q.z
        }
        ctx!.globalAlpha = 0.25 + q.z * 0.2
        const s = 1 + q.z * 0.5
        ctx!.fillRect(x, y, s, s)
      }
      ctx!.globalAlpha = 1
    }

    function loop() {
      t += 0.016 * speed * 2
      draw()
      raf = requestAnimationFrame(loop)
    }
    function start() {
      cancelAnimationFrame(raf)
      if (!reduce && visible && !document.hidden) raf = requestAnimationFrame(loop)
    }

    seed()
    draw() // the still first frame
    start()

    const ro = typeof ResizeObserver !== 'undefined' ? new ResizeObserver(() => { seed(); draw() }) : null
    ro?.observe(host)
    const io =
      typeof IntersectionObserver !== 'undefined'
        ? new IntersectionObserver((e) => {
            visible = e.some((x) => x.isIntersecting)
            start()
          })
        : null
    io?.observe(host)
    const onVis = () => start()
    document.addEventListener('visibilitychange', onVis)
    return () => {
      cancelAnimationFrame(raf)
      ro?.disconnect()
      io?.disconnect()
      document.removeEventListener('visibilitychange', onVis)
    }
  }, [mode, density, speed, reduce])

  return (
    <div ref={wrap} className={cn('relative isolate overflow-hidden', className)} {...props}>
      <canvas ref={canvas} aria-hidden className="pointer-events-none absolute inset-0 -z-10 h-full w-full text-text-subtle" />
      {children}
    </div>
  )
}