Taster

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

Icon

Icon and mark

Decide the slot before the glyph: control, explanatory, identity, data marker or no icon. Keep icons only where the slot needs one, draw them from one set, and leave headings and feature cards to real content.

내 사이트에서 가져오기

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

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

내 앱에 넣기

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

언제 쓰나요

  • Icon placement mapDecide the slot before the glyph: control, explanatory, identity, data marker or no icon. Keep icons only where the slot needs one, draw them from one set, and leave headings and feature cards to real content.
  • Line icon setOne family of 24 pixel line icons with a shared stroke weight, inheriting text color, used only where the icon adds meaning. A category icon sits directly beside its name with no colored circle or tile.

대신 없애 주는 AI 티

  • The same few stock icons on repeat (ICO-01)
  • Icons from more than one set (ICO-02)
  • Stroke weights that do not match (ICO-03)
  • An icon on every card (ICO-04)
  • Rounded square icon tile (CMP-03)
  • Three icon cards in a row (LAY-02)
  • Emoji as icons or bullets (AC-03)
  • Glyph inside a filled circle (AC-11)

정보

설치할 패키지
tailwindcss
라이선스
MIT
코드 보기
import * as React from 'react'

// Line icons used by the registry components. 24px grid, round caps, currentColor only.
// Only the glyphs the components actually use are included here.
// Add more by dropping another entry into `paths`, drawn on the same grid and stroke, or swap in your own icon set.
// Before adding an icon to a screen, find its slot in patterns/icon-placement.md: most feature cards need none.

const paths = {
  'search': '<circle cx="11" cy="11" r="6"/><path d="M16 16l4 4"/>',
  'chart-line': '<path d="M4 20h16"/><path d="M5 16l4-4 3 2 3.5-8.5"/>',
  'chart-bar': '<path d="M4 20h16"/><path d="M7 20v-6"/><path d="M12 20v-10"/><path d="M17 20v-4"/>',
  'list': '<path d="M8 6h12M8 12h12M8 18h12"/><path d="M4 6h1.5M4 12h1.5M4 18h1.5"/>',
  'check': '<path d="M5 13l4 4 10-10"/>',
  'arrow-up-right': '<path d="M7 17 17 7"/><path d="M8 7h9v9"/>',
  'close': '<path d="M6 6l12 12M18 6 6 18"/>',
  'menu': '<path d="M4 7h16M4 12h16M4 17h16"/>',
  'chevron-down': '<path d="m6 9 6 6 6-6"/>',
  'download': '<path d="M12 4v11"/><path d="m7 10 5 5 5-5"/><path d="M5 20h14"/>',
  'file': '<path d="M14 3H7a1 1 0 0 0-1 1v16a1 1 0 0 0 1 1h10a1 1 0 0 0 1-1V7z"/><path d="M14 3v4h4"/>',
  'chevron-left': '<path d="m15 6-6 6 6 6"/>',
  'chevron-right': '<path d="m9 6 6 6-6 6"/>',
  'arrow-left': '<path d="M19 12H5"/><path d="m11 6-6 6 6 6"/>',
  'arrow-right': '<path d="M5 12h14"/><path d="m13 6 6 6-6 6"/>',
  'play': '<path d="M8 5.5v13l10.5-6.5z"/>',
  'pause': '<path d="M8 5v14M16 5v14"/>',
  'eye': '<path d="M2.5 12S6 5.5 12 5.5 21.5 12 21.5 12 18 18.5 12 18.5 2.5 12 2.5 12z"/><circle cx="12" cy="12" r="2.75"/>',
  'eye-off': '<path d="M4 4l16 16"/><path d="M9.9 6A9.6 9.6 0 0 1 12 5.5c6 0 9.5 6.5 9.5 6.5a17 17 0 0 1-2.6 3.4M6.6 7.6C3.9 9.4 2.5 12 2.5 12S6 18.5 12 18.5c1.7 0 3.2-.5 4.4-1.2"/><path d="M10.1 10.2a2.75 2.75 0 0 0 3.7 3.7"/>',
  'copy': '<rect x="8.5" y="8.5" width="11" height="11" rx="2"/><path d="M15.5 8.5V6.5a2 2 0 0 0-2-2h-7a2 2 0 0 0-2 2v7a2 2 0 0 0 2 2h2"/>',
  'monitor': '<rect x="3" y="4.5" width="18" height="12" rx="2"/><path d="M8.5 20h7M12 16.5V20"/>',
  'phone': '<rect x="7" y="2.5" width="10" height="19" rx="2"/><path d="M11 18h2"/>',
  'tablet': '<rect x="4.5" y="2.5" width="15" height="19" rx="2"/><path d="M10.5 18h3"/>',
} as const

export type IconName = keyof typeof paths

/** The three sizes of the set. Numbers are allowed for one-off layouts but should be rare. */
export type IconSize = 'sm' | 'md' | 'lg' | number

const SIZE_VAR: Record<'sm' | 'md' | 'lg', string> = {
  sm: 'var(--icon-sm, 16px)',
  md: 'var(--icon-md, 20px)',
  lg: 'var(--icon-lg, 24px)',
}

export interface IconProps extends Omit<React.SVGProps<SVGSVGElement>, 'name'> {
  name: IconName
  /** sm 16px beside body text, md 20px in buttons and nav, lg 24px for category entries. Default md. */
  size?: IconSize
  /** Stroke width on the 24 grid. Default --icon-stroke (2). Keep one value for the whole page. */
  strokeWidth?: number
  /** Accessible label. When omitted the icon is decorative (aria-hidden). */
  title?: string
}

export const Icon = React.forwardRef<SVGSVGElement, IconProps>(function Icon(
  { name, size = 'md', strokeWidth, title, style, width, height, ...rest },
  ref,
) {
  const box = typeof size === 'number' ? `${size}px` : SIZE_VAR[size]
  // Explicit width and height attributes still win, so older call sites keep their size.
  const px = (v: number | string | undefined) => (v === undefined ? undefined : typeof v === 'number' ? `${v}px` : v)
  return (
    <svg
      ref={ref}
      xmlns="http://www.w3.org/2000/svg"
      viewBox="0 0 24 24"
      fill="none"
      stroke="currentColor"
      strokeLinecap="round"
      strokeLinejoin="round"
      role={title ? 'img' : undefined}
      aria-hidden={title ? undefined : true}
      aria-label={title}
      data-icon={name}
      {...rest}
      style={{
        width: px(width) ?? box,
        height: px(height) ?? box,
        flex: 'none',
        strokeWidth: strokeWidth ?? 'var(--icon-stroke, 2)',
        ...style,
      }}
    >
      {/* The title is text React escapes; only the constant glyph strings above are set as markup. */}
      {title ? <title>{title}</title> : null}
      <g dangerouslySetInnerHTML={{ __html: paths[name] ?? '' }} />
    </svg>
  )
})

export interface IconLabelProps extends React.HTMLAttributes<HTMLSpanElement> {
  icon: IconName
  size?: IconSize
  /** Put the icon after the label, for example an external link arrow. */
  trailing?: boolean
}

/**
 * An icon beside its label, centered on the first line of the label rather than on the whole block,
 * so a label that wraps keeps the icon on line one.
 */
export function IconLabel({ icon, size = 'sm', trailing = false, children, className, style, ...rest }: IconLabelProps) {
  const glyph = (
    <span aria-hidden="true" style={{ display: 'inline-flex', alignItems: 'center', height: '1lh', flex: 'none' }}>
      <Icon name={icon} size={size} />
    </span>
  )
  return (
    <span
      className={className}
      style={{ display: 'inline-flex', alignItems: 'flex-start', gap: 'var(--sp-2, 8px)', ...style }}
      {...rest}
    >
      {trailing ? null : glyph}
      <span>{children}</span>
      {trailing ? glyph : null}
    </span>
  )
}