Text (텍스트) Widget Control

Text(텍스트) 위젯을 스크립트에서 제어할 때 사용하는 Widget Control(Property · Method · Event) 목록입니다. 위젯 소개와 사용법은 Text 문서를 참고하세요.

정보

예제 파일: 07_Work_with_Widgets/text_objet.lfp

정보

아래 예시의 textID는 캔버스에서 Text 위젯에 지정한 이름(ID)입니다. 스크립트에서는 위젯ID.멤버 형태로 접근합니다.

Widget Control 요약

Widget Control	종류	시그니처	설명
text	Property	string (읽기/쓰기)	표시할 텍스트 내용
orgText	Property	string (읽기 전용)	데이터 바인딩 전 원본 텍스트
color	Property	string (읽기/쓰기)	글자 색상
setText	Method	setText(s: string): void	텍스트 내용 설정
setFontSize	Method	setFontSize(size: number): void	글자 크기 설정
setTextColor	Method	setTextColor(color: string): void	글자 색상 설정
setStyledText	Method	setStyledText(styledData): void	여러 인라인 스타일이 적용된 텍스트 설정
clearStyledText	Method	clearStyledText(): void	스타일 텍스트 해제
setTextStyle	Method	setTextStyle(style): void	텍스트 스타일 일괄 설정

Property

text

표시할 텍스트 내용입니다. 읽기와 쓰기가 모두 가능합니다.

• 타입: string
• 접근: 읽기 / 쓰기

Example

// 텍스트 변경
textID.text = "안녕하세요";

// 현재 텍스트 읽기
const current = textID.text;

orgText

데이터 바인딩된 텍스트의 원본(가공 전) 값을 반환합니다. 바인딩이 없으면 text와 같은 값을 반환합니다.

• 타입: string
• 접근: 읽기 전용

Example

const original = textID.orgText;

color

글자 색상입니다. 읽기와 쓰기가 모두 가능합니다.

• 타입: string (색상 토큰 문자열, 예: Label/tertiary)
• 접근: 읽기 / 쓰기

Example

textID.color = "Label/tertiary";
const c = textID.color;

Method

setText

텍스트 내용을 설정합니다.

• Parameters
  • s (string): 표시할 텍스트
• Returns: 없음 (void)

Example

textID.setText("안녕하세요");

setFontSize

글자 크기를 설정합니다.

• Parameters
  • size (number): 글자 크기 (논리 픽셀)
• Returns: 없음 (void)

Example

textID.setFontSize(16.0);

setTextColor

글자 색상을 설정합니다.

• Parameters
  • color (string): 색상 토큰 문자열 (예: Label/tertiary)
• Returns: 없음 (void)

Example

textID.setTextColor("Label/tertiary");

setStyledText

여러 인라인 스타일이 적용된 텍스트(스타일 스팬)를 설정합니다.

• Parameters
  • styledData: 스팬 객체 배열 [{ text, color? }]. 각 스팬은 text와 선택적 색상 토큰 color를 가집니다.
• Returns: 없음 (void)
• 동작: 스타일 텍스트를 설정하면 text 속성보다 우선해 렌더링됩니다.

Example

textID.setStyledText([
  { text: "진행중 " },
  { text: `${count}`, color: "Label/highlight" },
  { text: "건" }
]);

clearStyledText

setStyledText로 적용한 스타일 텍스트를 해제합니다.

• Parameters: 없음
• Returns: 없음 (void)

Example

textID.clearStyledText();

setTextStyle

텍스트 스타일을 일괄 설정합니다.

• Parameters
  • style (string): 텍스트 스타일 토큰 (예: body1-medium)
• Returns: 없음 (void)

Example

textID.setTextStyle("body1-medium");

Event

정보

해당 없음 - Text 위젯에는 전용 Event가 없습니다.

공통 Widget Control (모든 위젯)

노트

모든 위젯은 setProperty(name, value) / getProperty(name) / setStyleProperty(styleName, styleProperty, value) 같은 공통 Widget Control(Method)도 사용할 수 있습니다. 자세한 규칙은 공통 Widget Control 레퍼런스를 참고하세요.