Icon
Icon(아이콘) 위젯은 아이콘 폰트의 글리프 하나를 화면에 표시하는 위젯입니다.
메뉴·버튼·상태 표시 등에서 의미를 시각적으로 전달할 때 사용합니다.
정의 / 역할
Icon 위젯은 아이콘 폰트에 포함된 글리프 하나를 지정한 크기·색으로 그려줍니다. 표시할 글리프는 코드 포인트와 폰트 패밀리로 지정하며, 크기·색·의미 라벨·텍스트 방향을 설정할 수 있습니다.
- 카테고리: Contents
- 기본 아이콘 코드 포인트:
0xe000 - 기본 배치 크기(Sized Box): 36 × 36 (px)
기능
| 기능 | 설명 |
|---|---|
| 아이콘 표시 | 아이콘 폰트의 글리프 하나를 화면에 그립니다. |
| 크기·색 설정 | 아이콘의 크기(size)와 색(color)을 지정합니다. |
| 글리프 지정 | 코드 포인트와 폰트 패밀리로 표시할 글리프(iconData)를 정합니다. |
| 접근성 설정 | 스크린 리더용 의미 라벨(semanticLabel)과 텍스트 방향(textDirection)을 지정합니다. |
사용 방법
- 왼쪽 위젯 팔레트에서 Contents 카테고리를 엽니다.
- Icon 항목을 캔버스로 끌어다 놓습니다.
- 오른쪽 속성 패널에서 표시할 아이콘(
iconData)을 선택합니다. - 필요하면 크기(
size)·색(color)을 조정합니다.
속성 (Property)
| 속성 | 설명 | 기본값 | 값 / 타입 |
|---|---|---|---|
iconData | 표시할 아이콘 글리프 (코드 포인트 + 폰트 패밀리) | 0xe000 | 아이콘 설정 |
size | 아이콘 크기 | 미지정 | 숫자(px) |
color | 아이콘 색 | 미지정 | 색상 |
semanticLabel | 스크린 리더가 읽는 의미 라벨 | 미지정 | 문자열 |
textDirection | 아이콘이 그려지는 텍스트 방향 | 미지정 | rtl, ltr |
주의 / 팁
팁
size·color를 지정하지 않으면 상위 위젯·테마에서 상속받은 값으로 표시됩니다. 특정 크기·색이 필요하면 두 속성을 직접 지정하세요.
노트
아이콘 글리프는 코드 포인트와 폰트 패밀리 두 값으로 지정됩니다. 스크립트로 아이콘을 바꿀 때도 두 값을 함께 넘겨야 합니다.
더 알아보기
팁
이 위젯을 스크립트로 제어하는 Widget Control(Property·Method·Event) 전체는 Icon (아이콘) Widget Control 문서에서 확인하세요.