본문으로 건너뛰기

ZSText

애플리케이션에서 타이포그래피를 간단하고 일관되게 관리할 수 있도록 설계된 컴포넌트입니다.

기본 사용법

import React from 'react';
import { ZSText } from '@0610studio/zs-ui';

export default function App() {
return <ZSText typo="body.1" color="primary">안녕하세요, ZSText!</ZSText>;
}
import React from 'react';
import { ZSText } from '@0610studio/zs-ui';

export default function App() {
return (
<ZSText
typo="heading.2"
color="secondary"
style={{ margin: 10, textAlign: 'center' }}
>
ZSText 컴포넌트에 오신 것을 환영합니다
</ZSText>
);
}

Props

이름타입기본값설명
typoTypoOptionsbody.2테마 설정에 따른 타이포그래피 스타일 선택.
colorTextColorOptionsprimary테마 팔레트에 따른 텍스트 색상 지정.
...propsReact Native의 TextPropsN/ATextAtom 컴포넌트로 전달되는 추가 props.

TypoStyle

TypoStyle은 타이포그래피의 메인 스타일 그룹을 나타냅니다. 주로 텍스트의 목적(예: 제목, 본문, 캡션 등)에 따라 분류됩니다.

export type TypoStyle = 'heading' | 'title' | 'subTitle' | 'label' | 'body' | 'caption';
스타일 이름설명
heading가장 크고 두드러진 제목 스타일.
title페이지나 섹션 제목 스타일.
subTitle부제목이나 설명 텍스트 스타일.
label버튼이나 입력 필드 레이블에 적합.
body일반 본문 텍스트 스타일.
caption작은 부가 텍스트 스타일.

TypoOptions

타이포그래피 옵션은 스타일.서브스타일 형식으로 구성됩니다.

  • heading: heading.1 ~ heading.6
  • title: title.1 ~ title.6
  • subTitle: subTitle.1 ~ subTitle.6
  • body: body.1 ~ body.6
  • label: label.1 ~ label.6
  • caption: caption.1 ~ caption.6

TextColorOptions

색상 옵션설명
primary테마에서 정의된 기본 텍스트 색상.
secondary부가 텍스트 색상.
disabled비활성화된 텍스트 색상.
danger오류 또는 경고용 텍스트 색상.
warning경고 메시지 텍스트 색상.
success성공 메시지 텍스트 색상.
information정보 제공용 텍스트 색상.
white흰색.
black검은색.