XMLText is a mini library that can generate SwiftUI Text from a given XML string with tags. It uses AttributedString to compose the final text output.
Text(
xmlString: "my <bold>localized</bold> and <italic>styled</italic> string",
styleGroup: myStyleDefinitions
)
The original idea comes directly from SwiftRichString library by Daniele Margutti on GitHub. Code for XML parsing, StyleProtocol, and StyleGroup are taken from this library, slight modifications are made to them in order to generate SwiftUI Text instead of NSAttributedString.
This is really useful for localising your apps for styled strings without having to know the location of the strings in the code that needs to be styled. This is a pretty fine alternative to having to use NSAttributedString with UIViewRepresentable of a UILabel in a SwiftUI app, as the layout of UIViewRepresentable for such dynamic views as UILabel doesn't always work and is prone to glitches when combined with other SwiftUI views.
Examples
iOS 15.0 / macOS 12.0 / tvOS 15.0 / watchOS 8.0
Supported Text modifiers
font(SwiftUI.Font)
foregroundColor(Color)
strikethrough(Color)
underline(Color)
kerning(CGFloat)
tracking(CGFloat)
baselineOffset(CGFloat)
Sample usage
This is an example of XML strings that would appear in your Localizable.strings files with words in different order for each different language, namely English and Swedish for this example. If you are not familiar with that approach, please note that the style information(StyleGroup keys, e.g. <italicStyle>) is also contained in the localized strings.
// This goes to English Localizable.strings
let englishXML = "%1$@ <italicStyle>%2$@</italicStyle>"
// This goes to Swedish Localizable.strings
let swedishXML = "<italicStyle>%2$@</italicStyle> %1$@"
let normalStyle = Style { style in
style.font = .subheadline
style.foregroundColor = .red
}
let italicStyle = Style { style in
style.font = Font.italic(.system(size: 20))()
style.foregroundColor = .blue
}
let styleGroup = StyleGroup(
base: normalStyle,
["italicStyle": italicStyle]
)
Text(
xmlString: String(format: englishXML, "Director", "Martin"),
styleGroup: styleGroup
)
Text(
xmlString: String(format: swedishXML, "Regissรถr", "Martin"),
styleGroup: styleGroup
)
๐
Links
You can add links inside your strings via: <a href="http://www.example.com">This is a link</a>
๐
Images (not supported)
It is currently not supported to include Image elements within AttributedString.
Custom XML Attributes (not supported)
For example: <italicStyle myAttribute="something"></italicStyle>
This is currently not supported for sake of simplicity and given the fact that the library doesn't have so many capabilities for that to make sense. If there would be some use cases regarding this, a similar approach to XMLDynamicAttributesResolver of SwiftRichString library could be considered in the future.
531 Jan 1, 2023
65 Dec 29, 2020
14 Dec 31, 2022
73 Dec 13, 2022
4 Aug 14, 2022
19 Dec 7, 2022
102 Nov 10, 2022
3 Jan 1, 2023
1.2k Dec 29, 2022
1.1k Dec 26, 2022
1.8k Dec 30, 2022
12 Oct 18, 2022
788 Jul 19, 2022
589 Sep 7, 2022
8.3k Jan 5, 2023
0 Jun 13, 2022
975 Dec 26, 2022
24 Mar 31, 2022
99 Sep 6, 2022
1.3k Jan 3, 2023
657 Dec 30, 2022
109 Jan 6, 2023
994 Jan 2, 2023
824 Dec 15, 2022
2.3k Dec 31, 2022
2.6k Dec 14, 2022