Taster

진단부품톤 고르기
부품 갤러리 / Theme scope

Theme scope

Theme and tokens

Raw values, roles and component tokens in three layers with one brand variable on top, and both light and dark defined as token sets with a switch. Dark steps by gray levels, not neon glow.

내 사이트에서 가져오기

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

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

내 앱에 넣기

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

언제 쓰나요

  • Token themesRaw values, roles and component tokens in three layers with one brand variable on top, and both light and dark defined as token sets with a switch. Dark steps by gray levels, not neon glow.

대신 없애 주는 AI 티

  • Same large radius and same soft shadow on everything (CMP-04)
  • Dark only, no light mode (CMP-11)
  • Cream background with a terracotta accent (COL-02)
  • Near-black background with a neon glow (COL-03)
  • Green as the replacement for banned purple (COL-05)
  • Text that does not stand out from its background (COL-08)

정보

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

// ThemeScope. Applies a token set to one subtree instead of the whole page: the light set from themes/light.css
// (through its .theme-light class), the brand slot, and the radius scale. Every registry component inside follows,
// because components read only the alias layer. Use it for a light preview panel inside a dark app, a customer's
// brand preview, or a side by side comparison of two settings.
//
// CSS custom properties that are built from other properties (--accent from --brand, --r-* from --radius) are
// resolved where they are declared, so a scope has to declare them again. This component does that for you.
// It never invents a value: brand and radius come from the caller. Needs tokens.css, and themes/light.css for
// theme="light".

export interface ThemeScopeProps extends React.HTMLAttributes<HTMLDivElement> {
  /** "light" applies themes/light.css to this subtree. "inherit" keeps the page's set. */
  theme?: 'inherit' | 'light'
  /** Any CSS color for the brand slot. --accent follows it. */
  brand?: string
  /** Text color on top of the brand fill. Pick one with 4.5:1 contrast against `brand`. */
  brandForeground?: string
  /** Base radius, for example "4px" or "0.75rem". The --r-* scale is rebuilt from it. */
  radius?: string
  /** Extra overrides for named tokens, for example { '--sp-4': '12px' }. */
  tokens?: Record<`--${string}`, string>
  /** Paint the scope with its own background and text color. */
  surface?: boolean
}

const RADIUS_SCALE: Record<string, string> = {
  '--r-sm': 'calc(var(--radius) * 0.6)',
  '--r-md': 'calc(var(--radius) * 0.8)',
  '--r-card': 'var(--radius)',
  '--r-xl': 'calc(var(--radius) * 1.4)',
  '--r-2xl': 'calc(var(--radius) * 1.8)',
  '--r-3xl': 'calc(var(--radius) * 2.2)',
  '--r-4xl': 'calc(var(--radius) * 2.6)',
}

export const ThemeScope = React.forwardRef<HTMLDivElement, ThemeScopeProps>(
  ({ theme = 'inherit', brand, brandForeground, radius, tokens, surface = true, className, style, ...props }, ref) => {
    const vars: Record<string, string> = {}
    if (brand) {
      vars['--brand'] = brand
      vars['--accent'] = 'var(--brand)'
    }
    if (brandForeground) vars['--accent-fg'] = brandForeground
    if (radius) {
      vars['--radius'] = radius
      Object.assign(vars, RADIUS_SCALE)
    }
    if (tokens) Object.assign(vars, tokens)
    return (
      <div
        ref={ref}
        data-theme-scope={theme}
        className={cn(theme === 'light' && 'theme-light', surface && 'bg-bg text-text', className)}
        style={{ ...(vars as React.CSSProperties), ...style }}
        {...props}
      />
    )
  },
)
ThemeScope.displayName = 'ThemeScope'