| Prop | 타입 | 기본값 | 설명 |
|---|---|---|---|
name | string | — | common-icons 갤러리 키. 지정 시 기본 슬롯 대신 미리 정의된 stroke 경로를 렌더합니다 |
src | string | object | — | 이미지 아이콘 경로. 단독 사용하거나 as="img"와 조합합니다 |
alt | string | '' | src 이미지의 대체 텍스트. 장식용 이미지는 빈 문자열을 사용합니다 |
as | string | Component | — | img 또는 커스텀 루트 요소. 커스텀 요소에서는 기본 슬롯으로 임의 콘텐츠를 전달합니다 |
size | 'sm' | 'md' | 'lg' | 'xl' | md | 아이콘 크기. md는 icon만, 나머지는 icon_sm · icon_lg · icon_xl |
color | string | — | 공통 color_* 클래스 (currentColor 상속) |
inline | boolean | false | 텍스트와 수직 정렬 (icon_inline) |
spin | boolean | false | 회전 애니메이션 (icon_spin) |
button | boolean | false | 클릭 가능한 아이콘 버튼 (icon_button + button 태그) |
circle | boolean | false | 원형 배경 (icon_circle) |
square | boolean | false | 사각 배경 (icon_square) |
pulse | boolean | false | 펄스 애니메이션 (icon_pulse, circle과 함께) |
aria-label | string | — | button·의미 있는 아이콘 시 접근성 라벨 |
ripple | boolean | — | 클릭 파장(ripple). button prop일 때만 적용 · true 활성 · false 비활성 · 미지정 시 button일 때 활성 |
장식용 아이콘은 aria-hidden="true"가 자동 적용됩니다. 의미 있는 아이콘·버튼은 aria-label을 지정하세요.