Taster

진단부품톤 고르기
부품 갤러리 / Before after

Before after

Media and gallery

A draggable divider over one frame to compare an original and an edited version, or two text versions side by side with removed and added lines marked.

내 사이트에서 가져오기

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

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

내 앱에 넣기

  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 media/before-after --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 처럼 그런 변수가 있으면 지우거나 이름을 바꾸세요.

언제 쓰나요

  • Before and after compareA draggable divider over one frame to compare an original and an edited version, or two text versions side by side with removed and added lines marked.

정보

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

// Before and after: two images of the same frame stacked in one box; the "after" image is clipped at a
// divider the reader drags, so neither image is resized or shifted. The divider is a real range input
// laid over the image, so it works with a mouse, touch, the arrow keys (Shift for bigger steps), Home and
// End, and screen readers announce the split as a percentage.
// Follows patterns/before-after-compare: one aspect ratio set once, a 2px line and a flat 44px tall grip, small
// solid labels in the corners, no autoplay sweep, no glow on the handle.
// Original code, MIT.

export interface BeforeAfterProps extends React.HTMLAttributes<HTMLDivElement> {
  before: { src: string; alt: string }
  after: { src: string; alt: string }
  /** Width over height, for example 3 / 2. */
  ratio?: number
  labels?: { before: string; after: string }
  /** Start position in percent. Default 50. */
  initial?: number
  /** Accessible name of the divider. */
  sliderLabel?: string
  caption?: string
}

export function BeforeAfter({
  before,
  after,
  ratio = 3 / 2,
  labels = { before: 'Before', after: 'After' },
  initial = 50,
  sliderLabel = 'Divider position',
  caption,
  className,
  ...props
}: BeforeAfterProps) {
  const [split, setSplit] = React.useState(initial)
  return (
    <figure className={cn('m-0 min-w-0', className)} {...props}>
      <div className="relative w-full overflow-hidden rounded-xl bg-bg-sunken select-none" style={{ aspectRatio: String(ratio), ['--split' as string]: `${split}%` }}>
        <img src={before.src} alt={before.alt} draggable={false} className="absolute inset-0 h-full w-full object-cover" />
        <img
          src={after.src}
          alt={after.alt}
          draggable={false}
          className="absolute inset-0 h-full w-full object-cover"
          style={{ clipPath: 'inset(0 0 0 var(--split))' }}
        />
        <span aria-hidden className="pointer-events-none absolute inset-y-0 w-0.5 -translate-x-1/2 bg-on-scrim" style={{ left: 'var(--split)' }} />
        <span
          aria-hidden
          className="pointer-events-none absolute top-1/2 flex h-11 w-7 -translate-x-1/2 -translate-y-1/2 items-center justify-center rounded-pill border-2 border-on-scrim text-on-scrim"
          style={{ left: 'var(--split)', background: 'var(--scrim)' }}
        >
          <svg viewBox="0 0 24 24" width="14" height="14" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round">
            <path d="m9 7-5 5 5 5" />
            <path d="m15 7 5 5-5 5" />
          </svg>
        </span>
        <span className="pointer-events-none absolute left-3 top-3 rounded-sm bg-bg px-2 py-1 text-caption text-text">{labels.before}</span>
        <span className="pointer-events-none absolute right-3 top-3 rounded-sm bg-bg px-2 py-1 text-caption text-text">{labels.after}</span>
        <input
          type="range"
          min={0}
          max={100}
          step={1}
          value={split}
          aria-label={sliderLabel}
          aria-valuetext={`${labels.before} ${split}%, ${labels.after} ${100 - split}%`}
          onChange={(e) => setSplit(Number(e.target.value))}
          className="peer absolute inset-0 h-full w-full cursor-ew-resize appearance-none bg-transparent opacity-0 [touch-action:pan-y]"
        />
        <span aria-hidden className="pointer-events-none absolute inset-0 rounded-xl peer-focus-visible:ring-2 peer-focus-visible:ring-inset peer-focus-visible:ring-ring" />
      </div>
      {caption ? <figcaption className="mt-3 break-keep text-label text-text-subtle">{caption}</figcaption> : null}
    </figure>
  )
}