[Docs] Custom Font Extension을 사용하는 방법

[doyeonjeong]

SwiftUI 커스텀 폰트 사용 가이드

이 가이드는 SwiftUI에서 커스텀 폰트 시스템을 사용하는 방법을 설명합니다. 기본적으로 한글에는 IBM Plex Sans KR 폰트를, 영어에는 Work Sans 폰트를 사용합니다.

기본 사용법

1. 기본 텍스트 스타일

한글 텍스트에 기본 body 스타일 적용 (기본값):

Text("안녕하세요!")
    .font(.body())

영어 텍스트에 body 스타일 적용:

Text("Hello, World!")
    .font(.body(english: true))

2. 커스텀 폰트 적용

한글 텍스트에 커스텀 폰트 직접 적용:

Text("커스텀 텍스트")
    .font(.app(.ibmPlexSansKR, size: 20, weight: .bold))

영어 텍스트에 커스텀 폰트 직접 적용:

Text("Custom Text")
    .font(.app(.workSans, size: 20, weight: .bold))

3. 사전 정의된 텍스트 스타일 사용

한글 텍스트에 사전 정의된 스타일 적용 (기본값):

Text("스타일 텍스트")
    .appFont(.title)

영어 텍스트에 사전 정의된 스타일 적용:

Text("Styled Text")
    .appFont(.title, english: true)

주요 기능

• .font() 수정자를 사용하여 기본 텍스트 스타일 적용
• .app() 메서드로 폰트 패밀리, 크기, 굵기를 직접 지정
• .appFont() 수정자로 사전 정의된 스타일과 행간 적용
• english: true 매개변수로 영어 폰트 지정 (지정하지 않으면 기본적으로 한글 폰트 사용)

팁

• 일관된 디자인을 위해 가능한 사전 정의된 스타일을 사용하세요.
• 특별한 경우에만 .app() 메서드로 커스텀 폰트를 직접 지정하세요.
• 영어 텍스트에는 english: true를 명시적으로 지정하여 Work Sans 폰트를 사용하세요.
• 한글 텍스트에는 별도의 지정 없이 기본값으로 IBM Plex Sans KR 폰트가 적용됩니다.

이 커스텀 폰트 시스템을 사용하면 한글과 영어를 적절히 구분하여 일관된 타이포그래피를 쉽게 유지할 수 있습니다. 기본값이 한글 폰트로 설정되어 있어 한국어 중심의 앱 개발에 특히 유용합니다.

[doyeonjeong]

스크린샷