Taster

진단부품톤 고르기
부품 갤러리 / Split form hero

Split form hero

Hero

The first action is an input inside the hero, such as a link to analyze. Submitting slides the hero into a short form or a sample result on the same screen, so the page needs no heavy contact form further down.

내 사이트에서 가져오기

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

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

내 앱에 넣기

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

언제 쓰나요

  • In-hero form flowThe first action is an input inside the hero, such as a link to analyze. Submitting slides the hero into a short form or a sample result on the same screen, so the page needs no heavy contact form further down.

대신 없애 주는 AI 티

  • Heavy contact form in the middle of a landing page (AC-12)
  • A subscribe form at the end of every page (CMP-10)

정보

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

// Split form hero: the headline on one side and a single field with its button on the same side, a
// visual on the other. The field is the first action, so the hero asks for one value, not a form.
// Follows patterns/in-hero-form-flow: a real <form>, one field and one button, a helper line that says
// what happens next, aria-live on the part that changes, a fixed minimum height so the page below does
// not jump, and no fake success. Without `onSubmit` or `action` the button stays disabled and says so.
// Original code, MIT.

export type SplitFormStatus = 'idle' | 'sending' | 'done' | 'error'

export interface SplitFormHeroProps extends Omit<React.HTMLAttributes<HTMLElement>, 'title' | 'onSubmit'> {
  eyebrow?: string
  title: string
  lead: string
  field: {
    label: string
    name?: string
    type?: 'email' | 'url' | 'text' | 'tel'
    placeholder?: string
    autoComplete?: string
  }
  submitLabel: string
  /** What happens after submit and how long it takes. */
  helper?: string
  /** Called with the value. Resolve to show `doneMessage`, throw to show the error line. */
  onSubmit?: (value: string) => Promise<void> | void
  /** Native form action, used when there is no onSubmit. */
  action?: string
  /** Shown after a successful submit. Say the next step, not "Thanks!". */
  doneMessage?: (value: string) => React.ReactNode
  errorMessage?: string
  /** The visual on the other side: a screenshot, a sample result or a photo. */
  aside: React.ReactNode
  /** Put the visual on the left instead. */
  reverse?: boolean
  as?: 'h1' | 'h2'
}

const KEEP = 'break-keep [overflow-wrap:break-word]'
const FIELD =
  'h-11 w-full min-w-0 rounded-md sm:w-auto sm:flex-1 border border-border-input bg-transparent px-3 text-body text-text outline-none ' +
  'placeholder:text-text-subtle focus-visible:ring-2 focus-visible:ring-ring aria-[invalid=true]:border-danger'
const SUBMIT =
  'inline-flex h-11 shrink-0 items-center justify-center rounded-md bg-accent px-5 text-body 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'

export function SplitFormHero({
  eyebrow,
  title,
  lead,
  field,
  submitLabel,
  helper,
  onSubmit,
  action: rawAction,
  doneMessage = () => 'Done. Check your inbox for the next step.',
  errorMessage = 'That did not go through. Check the value and try again.',
  aside,
  reverse = false,
  as: Heading = 'h1',
  className,
  ...props
}: SplitFormHeroProps) {
  const titleId = React.useId()
  const inputId = React.useId()
  const helpId = React.useId()
  const [value, setValue] = React.useState('')
  const [status, setStatus] = React.useState<SplitFormStatus>('idle')
  const statusRef = React.useRef<HTMLParagraphElement>(null)
  // A refused URL (blocks/_url.ts) counts as no action, so the form stays unwired instead of posting to this page.
  const action = safeHref(rawAction)
  const wired = !!onSubmit || !!action

  async function handle(e: React.FormEvent<HTMLFormElement>) {
    if (!onSubmit) return // native submit to `action`
    e.preventDefault()
    if (!e.currentTarget.reportValidity()) return
    setStatus('sending')
    try {
      await onSubmit(value)
      setStatus('done')
    } catch {
      setStatus('error')
    }
  }

  React.useEffect(() => {
    if (status === 'done' || status === 'error') statusRef.current?.focus()
  }, [status])

  return (
    <section aria-labelledby={titleId} className={cn('overflow-hidden', className)} {...props}>
      <div className="grid items-center gap-12 py-12 lg:grid-cols-2 lg:py-16">
        <div className={cn('max-w-[520px]', reverse && 'lg:order-2')}>
          {eyebrow ? <p className={cn('mb-3 text-label font-medium text-text-muted', KEEP)}>{eyebrow}</p> : null}
          <Heading id={titleId} className={cn('text-h1 font-semibold leading-[var(--lh-tight)] tracking-[-0.01em] text-text text-balance', KEEP)}>
            {title}
          </Heading>
          <p className={cn('mt-4 text-title font-reg leading-[var(--lh-normal)] text-text-muted text-pretty', KEEP)}>{lead}</p>
          <div className="mt-8 min-h-[116px]">
            {status === 'done' ? (
              <p ref={statusRef} tabIndex={-1} role="status" className={cn('text-body text-text outline-none', KEEP)}>
                {doneMessage(value)}
              </p>
            ) : (
              <form action={action} method={action ? 'post' : undefined} onSubmit={handle} noValidate={false}>
                <label htmlFor={inputId} className="mb-2 block text-label font-medium text-text-muted">
                  {field.label}
                </label>
                <div className="flex flex-col gap-2 sm:flex-row">
                  <input
                    id={inputId}
                    name={field.name ?? 'value'}
                    type={field.type ?? 'email'}
                    required
                    placeholder={field.placeholder}
                    autoComplete={field.autoComplete ?? (field.type === 'email' || !field.type ? 'email' : undefined)}
                    value={value}
                    onChange={(e) => {
                      setValue(e.target.value)
                      if (status === 'error') setStatus('idle')
                    }}
                    aria-describedby={helpId}
                    aria-invalid={status === 'error' ? true : undefined}
                    className={FIELD}
                  />
                  <button type="submit" disabled={!wired || status === 'sending'} className={SUBMIT}>
                    {status === 'sending' ? 'Sending' : submitLabel}
                  </button>
                </div>
                <p id={helpId} ref={status === 'error' ? statusRef : undefined} tabIndex={-1} aria-live="polite" className={cn('mt-2 text-label text-text-subtle outline-none', KEEP)}>
                  {status === 'error' ? <span className="text-text">{errorMessage}</span> : !wired ? 'Not connected yet.' : helper}
                </p>
              </form>
            )}
          </div>
        </div>
        <div className={cn('min-w-0', reverse && 'lg:order-1')}>{aside}</div>
      </div>
    </section>
  )
}