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.
실제로 돌아가는 부품입니다. 눌러 보고 입력해 보세요.
내 앱에 넣기
아직 npm 패키지가 없어서 Taster 리포를 받아 그 안의 명령을 씁니다. 내 앱 폴더가 들어 있는 폴더에서 한 번만 받습니다.
git clone https://github.com/makim-414/taster.git && npm ci --prefix taster/packages/engine내 앱 폴더에서 이 부품을 넣습니다. 부품 파일과 토큰 파일이
src/components/taster에 들어갑니다.node ../taster/packages/engine/cli.mjs add commerce/product-gallery --from https://taster-six.vercel.app --dir src/components/taster부품은 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)
정보
코드 보기
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>
)
}