커서 잔물결

Cursor Ripples

포인터가 움직인 곳에서 물결이 번지며 아래 이미지가 출렁입니다.

다른 이름: CursorRipplescursor ripplepointer ripple

WebGPU 를 지원하는 브라우저에서 움직입니다

이 기기에서는 데모를 그리지 못해 정지 화면을 보여 줍니다

React
// WebGPU 를 지원하는 브라우저에서만 그립니다.
// /samples/… 는 이 사이트의 샘플 파일입니다. 내 프로젝트의 이미지·영상 경로로 바꾸세요.
import { Shader, CursorRipples, ImageTexture } from 'shaders/react'

export default function ShaderEffect() {
  return (
    <Shader style={{ width: '100%', height: 320 }} disableTelemetry>
      <ImageTexture
        objectFit="cover"
        url="/samples/photo.jpg" />
      <CursorRipples />
    </Shader>
  )
}
Vue
<!-- WebGPU 를 지원하는 브라우저에서만 그립니다. -->
<!-- /samples/… 는 이 사이트의 샘플 파일입니다. 내 프로젝트의 이미지·영상 경로로 바꾸세요. -->
<script setup lang="ts">
import { Shader, CursorRipples, ImageTexture } from 'shaders/vue'
</script>

<template>
  <Shader style="width: 100%; height: 320px" :disable-telemetry="true">
    <ImageTexture
      object-fit="cover"
      url="/samples/photo.jpg"/>
    <CursorRipples/>
  </Shader>
</template>
Svelte
<!-- WebGPU 를 지원하는 브라우저에서만 그립니다. -->
<!-- /samples/… 는 이 사이트의 샘플 파일입니다. 내 프로젝트의 이미지·영상 경로로 바꾸세요. -->
<script>
  import { Shader, CursorRipples, ImageTexture } from 'shaders/svelte'
</script>

<Shader style="width: 100%; height: 320px" disableTelemetry>
  <ImageTexture
    objectFit="cover"
    url="/samples/photo.jpg" />
  <CursorRipples />
</Shader>
Solid
// WebGPU 를 지원하는 브라우저에서만 그립니다.
// /samples/… 는 이 사이트의 샘플 파일입니다. 내 프로젝트의 이미지·영상 경로로 바꾸세요.
import { Shader, CursorRipples, ImageTexture } from 'shaders/solid'

export default function ShaderEffect() {
  return (
    <Shader style={{ width: '100%', height: '320px' }} disableTelemetry>
      <ImageTexture
        objectFit="cover"
        url="/samples/photo.jpg" />
      <CursorRipples />
    </Shader>
  )
}
JavaScript
// WebGPU 를 지원하는 브라우저에서만 그립니다.
// /samples/… 는 이 사이트의 샘플 파일입니다. 내 프로젝트의 이미지·영상 경로로 바꾸세요.
// <canvas id="canvas" style="width:100%;height:320px"></canvas> 가 페이지에 있어야 한다
import { createShader } from 'shaders/js'

const shader = await createShader(document.getElementById("canvas"), {
  components: [
    {
      type: 'ImageTexture',
      props: {
        objectFit: 'cover',
        url: '/samples/photo.jpg',
      },
    },
    {
      type: 'CursorRipples',
    }
  ]
}, { disableTelemetry: true })

속성(props) · CursorRipples

값을 바꾸면 위 데모와 코드 탭에 바로 반영됩니다. 설명은 라이브러리 레지스트리의 영어 원문(MIT)입니다.

이름값기본값범위·선택지설명(원문)
intensityIntensity100 – 20 (step 0.1)Strength of the ripple distortion
decayDecay100 – 20 (step 0.1)How quickly ripples fade (higher = faster)
radiusRadius0.50.1 – 1 (step 0.1)Radius of cursor influence
chromaticSplitChromatic Split10 – 3 (step 0.1)RGB channel separation along ripple edges
edgesEdgesstretchstretch · transparent · mirror · wrapHow to handle edges when distortion pushes content out of bounds

모든 컴포넌트 공통: blendMode · opacity · visible · maskSource/maskType · boundingBox · id

포인터가 지나간 자리에 둥근 물결이 퍼지며 밑의 화면을 흔든다. 물에 손가락을 대고 원형 파문을 만드는 것처럼, 사진이나 색면이 잠깐 일렁인다.

`intensity`는 왜곡 세기(기본값 10, 범위 0–20), `decay`는 파문이 사라지는 속도(기본값 10, 범위 0–20이며 높을수록 빠름), `radius`는 영향 반경(기본값 0.5, 범위 0.1–1)을 조절한다. `chromaticSplit`은 가장자리의 색 분리(기본값 1, 범위 0–3)를 더한다.

효과 레이어라 이미지·영상·도형처럼 픽셀이 있는 레이어 아래에 둘 대상이 있어야 보인다. 사진이나 큰 색면과 조합하고, 글자 위에서는 왜곡과 색 분리가 읽기를 어렵게 만들 수 있다.

언제 쓰나

사진 카드의 포인터 피드백, 히어로 이미지의 반응, 큰 색면의 장식에 좋다. 작은 글자나 정적인 정보가 중요한 화면에서는 피한다.

페이지로 열기 ↗