Taster

진단부품톤 고르기
부품 갤러리 / Buy box

Buy box

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/buy-box --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.
  • Cart and checkoutLine items, a free-shipping progress line, order summary and a stepped checkout.

대신 없애 주는 AI 티

  • Long content as one image (LAY-07)

정보

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

// Buy box: the right column of a product page. Name, one descriptor line, price, one radio group per
// option (size, color, pack), a quantity stepper, the one solid button, and one line about delivery or
// returns. Options are real radio inputs in a fieldset, so arrow keys move within a group and the
// choice is announced; a sold out value stays visible, disabled, with the reason in text.
// The button names what it does and the price moves with the quantity. Nothing is added until the caller's
// onAdd resolves, and the result is said in a live line next to the button, not in a toast that hides it.
// Follows patterns/product-detail-page and patterns/cart-and-checkout: no countdown, no fake stock
// pressure, no tinted badge, no second competing button.
// Original code, MIT.

export interface BuyOption {
  id: string
  label: string
  values: { value: string; label: string; soldOut?: boolean }[]
}

export interface BuyBoxProps extends Omit<React.HTMLAttributes<HTMLElement>, 'onChange'> {
  name: string
  descriptor?: string
  /** Unit price as a number, formatted with `format`. */
  price: number
  format?: (n: number) => string
  options?: BuyOption[]
  maxQuantity?: number
  addLabel?: string
  /** Resolves when the item is in the cart. Throw to show the error line. */
  onAdd?: (choice: { options: Record<string, string>; quantity: number }) => Promise<void> | void
  /** One line, for example "Ships in 2 business days. Free returns within 30 days." */
  note?: string
  as?: 'h1' | 'h2'
}

const KEEP = 'break-keep [overflow-wrap:break-word]'
const usd = (n: number) => new Intl.NumberFormat('en-US', { style: 'currency', currency: 'USD' }).format(n)
const STEPPER_BTN =
  'inline-flex h-11 w-11 items-center justify-center text-text outline-none transition-colors duration-press ease-out hover:bg-bg-sunken focus-visible:ring-2 focus-visible:ring-inset focus-visible:ring-ring disabled:pointer-events-none disabled:opacity-40'

export function BuyBox({
  name,
  descriptor,
  price,
  format = usd,
  options = [],
  maxQuantity = 10,
  addLabel = 'Add to cart',
  onAdd,
  note,
  as: Heading = 'h1',
  className,
  ...props
}: BuyBoxProps) {
  const [choice, setChoice] = React.useState<Record<string, string>>(() =>
    Object.fromEntries(options.map((o) => [o.id, o.values.find((v) => !v.soldOut)?.value ?? ''])),
  )
  const [qty, setQty] = React.useState(1)
  const [status, setStatus] = React.useState<'idle' | 'adding' | 'added' | 'error'>('idle')
  const uid = React.useId()

  async function add() {
    if (!onAdd) return
    setStatus('adding')
    try {
      await onAdd({ options: choice, quantity: qty })
      setStatus('added')
    } catch {
      setStatus('error')
    }
  }

  return (
    <section aria-labelledby={`${uid}-name`} className={cn('min-w-0 max-w-[440px]', className)} {...props}>
      <Heading id={`${uid}-name`} className={cn('text-h2 font-semibold leading-[var(--lh-snug)] text-text', KEEP)}>
        {name}
      </Heading>
      {descriptor ? <p className={cn('mt-1 text-body text-text-muted', KEEP)}>{descriptor}</p> : null}
      <p className="mt-4 text-title font-medium tabular-nums text-text">{format(price)}</p>

      <div className="mt-6 grid gap-6">
        {options.map((o) => (
          <fieldset key={o.id} className="m-0 min-w-0 border-0 p-0">
            <legend className="mb-2 text-label font-medium text-text-muted">
              {o.label}: <span className="text-text">{o.values.find((v) => v.value === choice[o.id])?.label}</span>
            </legend>
            <div className="flex flex-wrap gap-2">
              {o.values.map((v) => (
                <label
                  key={v.value}
                  className={cn(
                    'relative inline-flex h-11 min-w-11 cursor-pointer items-center justify-center rounded-md border px-4 text-body transition-colors duration-press ease-out',
                    'has-[:focus-visible]:ring-2 has-[:focus-visible]:ring-ring',
                    choice[o.id] === v.value ? 'border-text text-text' : 'border-border text-text-muted hover:border-text-subtle',
                    v.soldOut && 'cursor-not-allowed text-text-subtle line-through hover:border-border',
                  )}
                >
                  <input
                    type="radio"
                    name={`${uid}-${o.id}`}
                    value={v.value}
                    checked={choice[o.id] === v.value}
                    disabled={v.soldOut}
                    onChange={() => {
                      setChoice((c) => ({ ...c, [o.id]: v.value }))
                      setStatus('idle')
                    }}
                    className="sr-only"
                  />
                  {v.label}
                  {v.soldOut ? <span className="sr-only">, sold out</span> : null}
                </label>
              ))}
            </div>
          </fieldset>
        ))}

        <div>
          <p id={`${uid}-qty`} className="mb-2 text-label font-medium text-text-muted">
            Quantity
          </p>
          <div role="group" aria-labelledby={`${uid}-qty`} className="inline-flex items-center rounded-md border border-border">
            <button type="button" className={cn(STEPPER_BTN, 'rounded-l-md')} onClick={() => setQty((q) => Math.max(1, q - 1))} disabled={qty <= 1} aria-label="Decrease quantity">
              <svg viewBox="0 0 24 24" width="16" height="16" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" aria-hidden>
                <path d="M5 12h14" />
              </svg>
            </button>
            <output aria-live="polite" className="w-10 text-center text-body tabular-nums text-text">
              {qty}
            </output>
            <button type="button" className={cn(STEPPER_BTN, 'rounded-r-md')} onClick={() => setQty((q) => Math.min(maxQuantity, q + 1))} disabled={qty >= maxQuantity} aria-label="Increase quantity">
              <svg viewBox="0 0 24 24" width="16" height="16" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" aria-hidden>
                <path d="M12 5v14M5 12h14" />
              </svg>
            </button>
          </div>
        </div>
      </div>

      <button
        type="button"
        onClick={add}
        disabled={!onAdd || status === 'adding'}
        className="mt-8 inline-flex h-12 w-full items-center justify-center gap-2 rounded-md bg-accent px-6 text-title font-medium text-accent-fg outline-none transition-[opacity,transform] duration-press ease-out hover:opacity-90 active:scale-press focus-visible:ring-2 focus-visible:ring-ring disabled:pointer-events-none disabled:opacity-50"
      >
        {status === 'adding' ? 'Adding' : addLabel}
        <span aria-hidden className="opacity-70">
          &middot;
        </span>
        <span className="tabular-nums">{format(price * qty)}</span>
      </button>
      <p aria-live="polite" className={cn('mt-3 min-h-[1.5em] text-label', KEEP, status === 'error' ? 'text-text' : 'text-text-muted')}>
        {status === 'added'
          ? `Added ${qty} to your cart.`
          : status === 'error'
            ? 'Could not add it. Try again.'
            : !onAdd
              ? 'Not connected yet.'
              : note ?? ''}
      </p>
    </section>
  )
}