Taster

진단부품톤 고르기
부품 갤러리 / Product gallery

Product gallery

Commerce

Image and info in two columns, option selector, ingredient story, full list in an accordion, reviews, cross-sell and an expandable delivery estimate.

내 사이트에서 가져오기

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

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

내 앱에 넣기

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

언제 쓰나요

  • Product detail pageImage and info in two columns, option selector, ingredient story, full list in an accordion, reviews, cross-sell and an expandable delivery estimate.

대신 없애 주는 AI 티

  • Long content as one image (LAY-07)

정보

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

// Product gallery: the image set of a product page. One main image at four by five and a strip of
// thumbnails, beside it on wide screens and under it on phones. A thumbnail is a button that shows its
// image; the current one carries aria-current and a full-ink outline, and the arrow keys move between
// thumbnails (roving focus), so the strip is one tab stop. Previous and next buttons sit on the main image
// for one-handed use, and the position is read out as "2 of 5".
// Follows patterns/product-detail-page (main image at 4:5 with a column or row of thumbnails) and
// patterns/media-thumb-strip. No zoom lens that follows the cursor, no autoplay.
// Original code, MIT.

export interface ProductImage {
  src: string
  alt: string
  /** Smaller file for the thumbnail. Defaults to src. */
  thumb?: string
}

export interface ProductGalleryProps extends React.HTMLAttributes<HTMLDivElement> {
  images: ProductImage[]
  labels?: { previous?: string; next?: string; of?: string; strip?: string }
}

// The arrows sit on the photo, where a gray ring can vanish: a text colored ring outside a page colored gap
// shows on light and dark pictures alike.
const STEP =
  'absolute top-1/2 inline-flex h-11 w-11 -translate-y-1/2 items-center justify-center rounded-pill bg-bg text-text outline-none transition-opacity duration-press ease-out ' +
  'hover:opacity-90 focus-visible:ring-2 focus-visible:ring-text focus-visible:ring-offset-2 focus-visible:ring-offset-[color:var(--bg)] disabled:hidden'

export function ProductGallery({ images, labels = {}, className, ...props }: ProductGalleryProps) {
  const L = { previous: 'Previous image', next: 'Next image', of: 'of', strip: 'Product images', ...labels }
  const [i, setI] = React.useState(0)
  const thumbs = React.useRef<Array<HTMLButtonElement | null>>([])
  const n = images.length
  const cur = images[i]

  function go(to: number, focus = false) {
    const k = (to + n) % n
    setI(k)
    if (focus) thumbs.current[k]?.focus()
  }

  return (
    <div className={cn('grid gap-3 lg:grid-cols-[72px_minmax(0,1fr)] lg:gap-4', className)} {...props}>
      <div className="relative order-1 overflow-hidden rounded-md bg-bg-sunken lg:order-2">
        <div className="aspect-[4/5]">
          {cur ? <img key={cur.src} src={cur.src} alt={cur.alt} className="h-full w-full object-cover" /> : null}
        </div>
        {n > 1 ? (
          <>
            <button type="button" onClick={() => go(i - 1)} disabled={i === 0} className={cn(STEP, 'left-3')} aria-label={L.previous}>
              <svg viewBox="0 0 24 24" width="18" height="18" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round" aria-hidden>
                <path d="m15 6-6 6 6 6" />
              </svg>
            </button>
            <button type="button" onClick={() => go(i + 1)} disabled={i === n - 1} className={cn(STEP, 'right-3')} aria-label={L.next}>
              <svg viewBox="0 0 24 24" width="18" height="18" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round" aria-hidden>
                <path d="m9 6 6 6-6 6" />
              </svg>
            </button>
            <p className="absolute bottom-3 right-3 rounded-sm bg-bg px-2 py-1 text-caption tabular-nums text-text" aria-live="polite">
              {i + 1} {L.of} {n}
            </p>
          </>
        ) : null}
      </div>
      {n > 1 ? (
        <ul
          aria-label={L.strip}
          className="order-2 m-0 flex list-none gap-2 p-0 lg:order-1 lg:flex-col"
          onKeyDown={(e) => {
            const k = { ArrowRight: 1, ArrowDown: 1, ArrowLeft: -1, ArrowUp: -1 }[e.key]
            if (k) {
              e.preventDefault()
              go(i + k, true)
            }
            if (e.key === 'Home') go(0, true)
            if (e.key === 'End') go(n - 1, true)
          }}
        >
          {images.map((im, k) => (
            <li key={im.src + k} className="w-16 shrink-0 lg:w-full">
              <button
                ref={(el) => {
                  thumbs.current[k] = el
                }}
                type="button"
                tabIndex={k === i ? 0 : -1}
                aria-current={k === i ? 'true' : undefined}
                aria-label={`${im.alt}, ${k + 1} ${L.of} ${n}`}
                onClick={() => go(k)}
                className={cn(
                  'block aspect-[4/5] w-full overflow-hidden rounded-sm bg-bg-sunken outline-none transition-opacity duration-press ease-out focus-visible:ring-2 focus-visible:ring-ring',
                  k === i ? 'ring-1 ring-text ring-offset-2 ring-offset-[color:var(--bg)]' : 'opacity-70 hover:opacity-100',
                )}
              >
                <img src={im.thumb ?? im.src} alt="" className="h-full w-full object-cover" />
              </button>
            </li>
          ))}
        </ul>
      ) : null}
    </div>
  )
}