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.
실제로 돌아가는 부품입니다. 눌러 보고 입력해 보세요.
내 앱에 넣기
아직 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 blocks/theme-scope --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 처럼 그런 변수가 있으면 지우거나 이름을 바꾸세요.
언제 쓰나요
- 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)
정보
코드 보기
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'