Compose의 텍스트 | Jetpack Compose | Android Developers
androidx.compose.material3 | Android Developers
@Composable
fun Text(
text: String,
modifier: Modifier = Modifier,
color: Color = Color.Unspecified,
fontSize: TextUnit = TextUnit.Unspecified,
fontStyle: FontStyle? = null,
fontWeight: FontWeight? = null,
fontFamily: FontFamily? = null,
letterSpacing: TextUnit = TextUnit.Unspecified,
textDecoration: TextDecoration? = null,
textAlign: TextAlign? = null,
lineHeight: TextUnit = TextUnit.Unspecified,
overflow: TextOverflow = TextOverflow.Clip,
softWrap: Boolean = true,
maxLines: Int = Int.MAX_VALUE,
minLines: Int = 1,
onTextLayout: ((TextLayoutResult) -> Unit)? = null,
style: TextStyle = LocalTextStyle.current
): Unit
| 속성 | 설명 |
|---|---|
| modifier | 컴포즈의 modifier |
| text | 표시할 텍스트 |
| color | 텍스트 색상 |
| fontSize | 텍스트 사이즈 설정 : TextStyle.fontSize |
| fontStyle | 텍스트 스타일 설정 : TextStyle.fontStyle |
| fontWeight | 폰트 굵기 설정 |
| fontFamily | 텍스트를 렌더링 할때 사용할 글꼴 모음 설정 |
| letterSpacing | 각 문자 사이에 추가할 공백의 양 |
| textDecoreation | 텍스트에 칠할 Decoration 설정 (예: 밑줄) |
| textAlign | 단락내의 텍스트 정렬방법 설정 |
| lineHeight | 단위의 줄 높이 설정 |
| overflow | 텍스트가 넘칠때의 처리방법 설정 |
TextOverFlow.Clip : 넘쳐나는 텍스트를 자른다.
TextOverFlow.Ellipsis : … 줄임표를 표시한다.
TextOverFlow.Visible : 공간이 충분하지 않은경우에도 모든 텍스트를 표시한다. | | softWrap | true 로 설정하면 테스트가 영역을 벗어나면 자동으로 줄바꿈을 한다. false 로 설정하면 텍스트가 영역을 벗어나도 일자로 표시한다. | | maxLines | 지정된 줄 수를 초과하면 overFlow 및 softWrap 에 따라 잘린다. | | minLines | 표시되는 최소 라인 수에 따른 최소 높이를 설정한다. | | onTextLayout | 새 텍스트 레이아웃이 계산될 때 실행되는 콜백이다.
(TextLayoutResult) → 콜백에는 단락 정보, 텍스트 크기, 기준선 및 기타 세부정보가 포함되어있다.
콜백을 사용하여 텍스트에 추가적인 Decoration 이나, 기능을 추가할수 있다. | | style | 색상, 글꼴, 줄 높이 등과 같은 텍스트 스타일을 구성한다. |