음, 그거 아십니까? SwiftUI에서 마크다운 문법을 지원합니다. 전 몰랐어요:) 어쩌다가 우연히 알게 됐는데, 꽤나 신기해서 글로 남겨봅니다.
사용할 수 있는 것은 iOS15부터 인데요. iOS15 릴리즈 노트에 아래와 같이 추가되어 있습니다.
SwiftUI
New Features
LocalizedStringKey can now contain Markdown syntax. The system parses Markdown strings when you create a Text view from a LocalizedStringKey, including Text views created with a string literal. The system styles Text according to Markdown constructs. (74515884)
하나씩 차근차근 설명해볼게요. 일단 해석해보면, LocalizedStringKey가 마크다운 문법을 포함할 수 있다고 되어있죠? 여기서 LocalizedStringKey 부터 알아볼게요.
공식문서는 여기있습니다. iOS13부터 사용되었고, 얘는 이름도 현지화문자열키이긴 하지만 밑에 오버뷰를 보면 바로 의미를 이해할 수 있어요.
Initializers for several SwiftUI types – such as Text, Toggle, Picker and others – implicitly look up a localized string when you provide a string literal.
즉, 우리가 SwiftUI에서 가장 흔하게 쓰는 타입들 Text, Toggle, Picker들이 암시적으로 현지화된 문자열을 조회한다는 거죠. 이게 무슨 말이냐 ?
일단 우리가 Text("Hello")라는 뷰를 SwiftUI에서 만들다고 하면, 그건 실제로는 이 생성자를 사용하고 있는 겁니다.
즉, 우리는 그냥 string을 넣는다고 생각하고 있지만 실제로는 아래와 같이 LocalizedStringKey를 생성해서 넣어주고 있는 거에요.
@available(iOS13.0, macOS10.15, tvOS13.0, watchOS6.0, *)@frozenpublicstructLocalizedStringKey:Equatable, ExpressibleByStringInterpolation{ /// Creates a localized string key from the given string value. /// /// - Parameter value: The string to use as a localization key.publicinit(_value: String) ///...}
그리고 아까 암시적으로 현지화된 문자열을 조회한다고 했죠? 그러면 저 LocalizedStringKey은 Text.init()의 예시대로 저 키값에 맞는 LocalizedStringKey가 있는지 확인을 해보는 겁니다. 그리고 키값이 있다면 현지화해서 뷰를 그려주는 거죠.
더 구체화해서 설명하면, 아래와 같습니다. 😄
현지화를 위해 Localizable.strings(English) 파일을 만든다.
"안녕" = "Hello"; 를 입력해놓는다.
SwiftUI에서 뷰를 그린다. Text("Hello")
"Hello"는 LocalizedStringKey를 통해 현지화키값을 생성하고, 해당 키값에 맞는 value가 있는지 확인한다.
있다. Hello -> 안녕
SwiftUI는 안녕이라는 Text 뷰를 그린다.
그래서 그게 어쨌다는..?
아, 약간 좀 돌아왔죠? ^^; LocalizedStringKey를 이해하기 위해서 약간 설명을 좀 하느라 돌아왔네요.
그래서 결론은, 이 _LocalizedStringKey가 실제로 우리가 SwiftUI에서 Text, Toggle, Picker 등을 만들 때 사용된다는 것이고 iOS 15부터는 이 LocalizedStringKey에 마크다운 문법이 적용된다는 것_이죠.
그리고 또 다른 예외로 이런 것도 있는데요. 아래와 같은 코드가 있고, Localizable.strings의 일본어 현지화 파일도 있다고 해볼게요.
그럼 뷰는 어떻게 그려질까요 ? 아래와 같이 그려집니다.
이유는 위에서 설명한 것과 같아요. Text("Today")는 LocalizedStringKey값을 생성해서 로컬라이징키에 따른 아웃풋이 있는지 암시적으로 조회하지만, ForEach 문을 통해 생성되는 Text(message.title)은 변수 이므로 뷰는 문자열 값을 그대로 사용하기 때문입니다. 이 내용도 공식문서에 있는 내용이니 읽어보셔도 좋겠네요.
import SwiftUI
struct MarkDownSwiftVIew: View {
var body: some View {
Text("""
# Hello, world
**This is bold text**
*This text is italicized*
~~This was mistaken text~~
**This text is _extremely_ important**
***All this text is important***
[apple.com](https://www.apple.com)
"""
)
}
}
struct MarkDownSwiftVIew_Previews: PreviewProvider {
static var previews: some View {
MarkDownSwiftVIew()
}
}
Text(verbatim: "pencil") // Displays the string "pencil" in any locale.
"Today" = "今日";
List {
Section(header: Text("Today")) {
ForEach(messageStore.today) { message in
Text(message.title)
}
}
}
