Text
Text(텍스트) 위젯은 문자열을 화면에 표시하는 가장 기본적인 위젯입니다.
제목, 설명, 라벨 등 모든 글자 표시에 사용합니다.
정보
예제 파일: 07_Work_with_Widgets/text_objet.lfp
정의 / 역할
Text 위젯은 지정한 문자열을 화면에 그려줍니다. 기본적으로는 하나의 스타일(색·크기·정렬 등)이 글자 전체에 적용되지만, 스크립트의 setStyledText를 사용하면 글자 일부마다 다른 색을 지정할 수도 있습니다. 편집 화면에서 서식 있는 텍스트를 직접 작성하려면 RichText 위젯을 사용합니다.
- 카테고리: Contents
- 기본 표시 문구:
Hello World
기능
| 기능 | 설명 |
|---|---|
| 텍스트 표시 | 입력한 문자열을 화면에 표시합니다. 여러 줄 입력을 지원합니다. |
| 데이터 바인딩 | 텍스트 내용을 데이터와 연결해 값이 자동으로 반영되게 할 수 있습니다. |
| 정렬·줄바꿈 제어 | 문단 정렬, 자동 줄바꿈, 최대 줄 수, 넘침 처리 방식을 설정합니다. |
| 스크립트 제어 | 스크립트로 텍스트 내용·색·크기를 실시간 변경할 수 있습니다. |
사용 방법
- 왼쪽 위젯 팔레트에서 Contents 카테고리를 엽니다.
- Text 항목을 캔버스로 끌어다 놓습니다.
- 배치된 위젯을 선택한 뒤 오른쪽 속성 패널에서
text값을 원하는 문구로 수정합니다. - 필요하면 정렬(textAlign), 최대 줄 수(maxLines), 넘침 처리(overflow) 등을 조정합니다.
속성 (Property)
노트
아래 표는 스튜디오 속성 패널에 보이는 순서(위→아래)입니다. style 행을 펼치면 글자 색·크기·굵기·폰트 등 하위 옵션이 나옵니다. (SizedBox·Padding 같은 Styles 모디파이어는 별도 Styles 패널이라 여기 속성과 다릅니다.)
| 옵션 | 설명 | 기본값 | 값 / 타입 |
|---|---|---|---|
text | 표시할 문자열 (여러 줄 가능, 데이터 바인딩 지원) | 빈 문자열 | 문자열 |
style | 글자 스타일 - 색·크기·굵기·폰트 등 (펼치면 하위 옵션) | 미지정(테마 기본) | TextStyle(그룹) |
textAlign | 문단 정렬 | start | left, right, center, justify, start, end |
textDirection | 글자 진행 방향 | 미지정(상속) | ltr, rtl |
softWrap | 폭을 넘으면 자동 줄바꿈 | 켜짐(true) | 참 / 거짓 |
overflow | 넘치는 텍스트 처리 방식 | clip | clip, fade, ellipsis, visible |
textScaleFactor | 글자 크기 배율 | 1.0 | 숫자 |
maxLines | 표시할 최대 줄 수 (추가하지 않으면 제한 없음, 초과분은 overflow 적용) | 0 (속성 추가 시) | 정수(1 이상) |
locale | 로케일(언어·지역) | 미지정 | Locale |
strutStyle | 줄 높이 기준(스트럿) | 미지정 | StrutStyle |
textWidthBasis | 텍스트 폭 계산 기준 | parent | parent, longestLine |
textHeightBehavior | 첫/마지막 줄 높이 처리 | 미지정 | TextHeightBehavior |
주의 / 팁
노트
maxLines는 표시할 최대 줄 수입니다. 속성을 추가하면 초기값이 0으로 들어가므로, 원하는 최대 줄 수(1 이상)로 바꿔 사용하세요. 속성을 추가하지 않으면 줄 수 제한이 없습니다.
팁
긴 텍스트가 잘리지 않고 ...로 표시되게 하려면 maxLines를 지정하고 overflow를 ellipsis로 설정합니다.
더 알아보기
팁
이 위젯을 스크립트로 제어하는 Widget Control(Property·Method·Event) 전체는 여기에서 확인하세요: Text Widget Control