Skip to content

표시 컴포넌트

텍스트와 작은 시각 요소. 모두 아래 프롭 외에 공통 프롭(base props)도 받습니다.

프롭 표는 npm run gen:docs로 zod 스키마에서 자동 생성됩니다.

heading

레벨에 따른 섹션 헤딩.

프롭 타입 설명
text string 헤딩 텍스트
level number 1–6, HTML h1–h6과 매칭
heading:
  level: 1
  text: "Welcome back"

text

옵션 강조 tone이 있는 인라인 또는 블록 텍스트.

프롭 타입 설명
value string 텍스트 내용
tone "muted" | "strong" | "accent" 강조 스타일
text:
  value: "Last synced 2 minutes ago"
  tone: muted

image

이미지 플레이스홀더. src/alt를 받지만 실제 이미지는 가져오지 않습니다 — mid-fi 스케치 도구라서 렌더러가 아닙니다.

프롭 타입 설명
src string 이미지 URL (호버/title에만 표시)
alt string Alt 텍스트
image:
  src: "https://example.com/hero.jpg"
  alt: "Product hero image"
  w: 400
  h: 240

icon

작은 아이콘 마커. v0.2에서는 아이콘 크기 박스 안의 텍스트 라벨 (Obsidian의 Lucide 아이콘은 아직 직접 연결 안 됨).

프롭 타입 설명
name string 아이콘 식별자 텍스트
size number 박스 크기 (픽셀)
icon:
  name: "settings"
  size: 20

avatar

name에서 이니셜을 도출한 원형 아바타.

프롭 타입 설명
name string 표시 이름 — 이니셜이 여기서 도출됨
size number 지름 (픽셀)
avatar:
  name: "Ada Lovelace"
  size: 40

badge

variant가 있는 작은 상태 뱃지.

프롭 타입 설명
label string 뱃지 텍스트
variant "default" | "primary" | "success" | "warning" | "danger" 시각 스타일
badge:
  label: "Beta"
  variant: primary

badge:
  label: "Failed"
  variant: danger

tag

태그 모양 라벨 (주제나 키워드). badge보다 단순함 — variant 없고 중립적.

프롭 타입 설명
label string 태그 텍스트
row:
  gap: 6
  items:
    - tag: { label: "react" }
    - tag: { label: "typescript" }
    - tag: { label: "obsidian" }

kbd

키보드 단축키 표시. 각 키를 <kbd> 스타일 박스에 넣고 +로 연결.

프롭 타입 설명
keys string[] 단축키의 키들
kbd:
  keys: ["Ctrl", "K"]

kbd:
  keys: ["Cmd", "Shift", "P"]