mirror of https://github.com/oxen-io/session-ios
refactor localized string with style
Ryan ZHAO
1 year ago
parent
2ef2d5c95f
commit
0413baa06e
@ -0,0 +1,235 @@
|
|||||||
|
// Copyright © 2024 Rangeproof Pty Ltd. All rights reserved.
|
||||||
|
|
||||||
|
// stringlint:disable
|
||||||
|
|
||||||
|
import UIKit
|
||||||
|
import SessionUtilitiesKit
|
||||||
|
|
||||||
|
public extension NSAttributedString {
|
||||||
|
/// These are the tags we current support formatting for
|
||||||
|
enum HTMLTag: String {
|
||||||
|
/// The regex to recognize an open or close tag
|
||||||
|
///
|
||||||
|
/// **Note:** The `{1,X}` defines a minimum and maximum tag length and may need to be updated if we add support
|
||||||
|
/// for longer tags that are currently supported
|
||||||
|
static let regexPattern: String = #"<(?<closeTag>\/)?(?<tagName>[A-Za-z0-9]{1,1})>"#
|
||||||
|
|
||||||
|
case bold = "b"
|
||||||
|
case italic = "i"
|
||||||
|
case underline = "u"
|
||||||
|
case strikethrough = "s"
|
||||||
|
case primaryTheme = "span"
|
||||||
|
|
||||||
|
// MARK: - Functions
|
||||||
|
|
||||||
|
static func from(_ stringValue: String) -> (tag: HTMLTag, closeTag: Bool)? {
|
||||||
|
let isCloseTag: Bool = stringValue.starts(with: "</")
|
||||||
|
|
||||||
|
return HTMLTag(
|
||||||
|
rawValue: stringValue
|
||||||
|
.replacingOccurrences(of: "</", with: "")
|
||||||
|
.replacingOccurrences(of: "<", with: "")
|
||||||
|
.replacingOccurrences(of: ">", with: "")
|
||||||
|
).map { ($0, isCloseTag) }
|
||||||
|
}
|
||||||
|
|
||||||
|
func format(with font: UIFont) -> [NSAttributedString.Key: Any] {
|
||||||
|
/// **Note:** Constructing a `UIFont` with a `size`of `0` will preserve the textSize
|
||||||
|
switch self {
|
||||||
|
case .bold: return [
|
||||||
|
.font: UIFont(
|
||||||
|
descriptor: (font.fontDescriptor.withSymbolicTraits(.traitBold) ?? font.fontDescriptor),
|
||||||
|
size: 0
|
||||||
|
)
|
||||||
|
]
|
||||||
|
case .italic: return [
|
||||||
|
.font: UIFont(
|
||||||
|
descriptor: (font.fontDescriptor.withSymbolicTraits(.traitItalic) ?? font.fontDescriptor),
|
||||||
|
size: 0
|
||||||
|
)
|
||||||
|
]
|
||||||
|
case .underline: return [.underlineStyle: NSUnderlineStyle.single.rawValue]
|
||||||
|
case .strikethrough: return [.strikethroughStyle: NSUnderlineStyle.single.rawValue]
|
||||||
|
case .primaryTheme: return [.foregroundColor: ThemeManager.primaryColor.color]
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
convenience init(stringWithHTMLTags: String?, font: UIFont) {
|
||||||
|
guard
|
||||||
|
let targetString: String = stringWithHTMLTags,
|
||||||
|
let expression: NSRegularExpression = try? NSRegularExpression(
|
||||||
|
pattern: HTMLTag.regexPattern,
|
||||||
|
options: [.caseInsensitive, .dotMatchesLineSeparators]
|
||||||
|
)
|
||||||
|
else {
|
||||||
|
self.init(string: (stringWithHTMLTags ?? ""))
|
||||||
|
return
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Construct the needed types
|
||||||
|
///
|
||||||
|
/// **Note:** We use an `NSAttributedString` for retrieving string ranges because if we don't then emoji characters
|
||||||
|
/// can cause odd behaviours with accessing ranges so this simplifies the logic
|
||||||
|
let attrString: NSAttributedString = NSAttributedString(string: targetString)
|
||||||
|
let stringLength: Int = targetString.utf16.count
|
||||||
|
var partsAndTags: [(part: String, tags: [HTMLTag])] = []
|
||||||
|
var openTags: [HTMLTag: Int] = [:]
|
||||||
|
var lastMatch: NSTextCheckingResult?
|
||||||
|
|
||||||
|
/// Enumerate through the HTMLTag matches and build up a list of formats to apply
|
||||||
|
expression.enumerateMatches(in: targetString, range: NSMakeRange(0, stringLength)) { match, _, _ in
|
||||||
|
guard let currentMatch: NSTextCheckingResult = match else { return }
|
||||||
|
|
||||||
|
/// Store the positions for readability
|
||||||
|
let lastMatchEnd: Int = (lastMatch?.range.upperBound ?? 0)
|
||||||
|
let currentMatchStart: Int = currentMatch.range.lowerBound
|
||||||
|
let currentMatchEnd: Int = currentMatch.range.upperBound
|
||||||
|
|
||||||
|
/// Ignore invalid ranges
|
||||||
|
guard (currentMatchStart > lastMatchEnd) || (currentMatchStart == lastMatchEnd && currentMatchStart == 0) else { return }
|
||||||
|
|
||||||
|
/// Retrieve the tag and content values, store the content and any tags which are currently applied so we can construct the
|
||||||
|
/// formatted string at the end
|
||||||
|
let tagMatch: String = attrString[currentMatchStart..<currentMatchEnd]
|
||||||
|
let rawStringBetweenMatch: String = attrString[lastMatchEnd..<currentMatchStart]
|
||||||
|
partsAndTags.append((rawStringBetweenMatch, Array(openTags.keys)))
|
||||||
|
|
||||||
|
/// If it's a valid tag then store the location information so we can apply styling later
|
||||||
|
if let tagInfo: (tag: HTMLTag, closeTag: Bool) = HTMLTag.from(tagMatch) {
|
||||||
|
switch (tagInfo.closeTag, openTags[tagInfo.tag]) {
|
||||||
|
/// Add the new opening tag
|
||||||
|
case (false, .none): openTags[tagInfo.tag] = 1
|
||||||
|
|
||||||
|
/// Increment the number of opening tags for the pending format so we can be sure to close them correctly
|
||||||
|
case (false, .some(let openCount)): openTags[tagInfo.tag] = (openCount + 1)
|
||||||
|
|
||||||
|
/// If we had multiple open tags then just decrement the value
|
||||||
|
case (true, .some(let openCount)) where openCount > 1: openTags[tagInfo.tag] = (openCount - 1)
|
||||||
|
|
||||||
|
/// Otherwise we have a valid format chunk so should collapse it
|
||||||
|
case (true, .some): openTags[tagInfo.tag] = nil
|
||||||
|
|
||||||
|
/// Ignore close tags with no corresponding open tags
|
||||||
|
case (true, .none): break
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Store the the `lastMatch` value for appending the final part of the content
|
||||||
|
lastMatch = currentMatch
|
||||||
|
}
|
||||||
|
|
||||||
|
/// If we don't have a `lastMatch` value then we weren't able to get a single valid tag match so just stop here are return the `targetString`
|
||||||
|
guard let finalMatch: NSTextCheckingResult = lastMatch else {
|
||||||
|
self.init(string: targetString)
|
||||||
|
return
|
||||||
|
}
|
||||||
|
|
||||||
|
/// If the final regex match isn't at the end of the string then we need to append the final part of the string to avoid it getting truncated
|
||||||
|
///
|
||||||
|
/// **Note:** When there is an opening tag but no closing tag browsers seem to apply the style from the opening tag to the end of
|
||||||
|
/// the string so we should do the same here
|
||||||
|
if stringLength > finalMatch.range.upperBound {
|
||||||
|
partsAndTags.append((attrString[finalMatch.range.upperBound...], Array(openTags.keys)))
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Lastly we should construct the attributed string, applying the desired formatting
|
||||||
|
self.init(
|
||||||
|
attributedString: partsAndTags.reduce(into: NSMutableAttributedString()) { result, next in
|
||||||
|
result.append(NSAttributedString(string: next.part, attributes: next.tags.format(with: font)))
|
||||||
|
}
|
||||||
|
)
|
||||||
|
}
|
||||||
|
|
||||||
|
private subscript(range: Range<Int>) -> String {
|
||||||
|
attributedSubstring(from: NSMakeRange(range.lowerBound, (range.upperBound - range.lowerBound))).string
|
||||||
|
}
|
||||||
|
|
||||||
|
private subscript(range: PartialRangeFrom<Int>) -> String {
|
||||||
|
let upperBound: Int = self.string.utf16.count
|
||||||
|
return attributedSubstring(from: NSMakeRange(range.lowerBound, (upperBound - range.lowerBound))).string
|
||||||
|
}
|
||||||
|
|
||||||
|
private subscript(range: PartialRangeThrough<Int>) -> String {
|
||||||
|
attributedSubstring(from: NSMakeRange(0, range.upperBound)).string
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
private extension Collection where Element == NSAttributedString.HTMLTag {
|
||||||
|
func format(with font: UIFont) -> [NSAttributedString.Key: Any] {
|
||||||
|
func fontWith(_ font: UIFont, traits: UIFontDescriptor.SymbolicTraits) -> UIFont {
|
||||||
|
/// **Note:** Constructing a `UIFont` with a `size`of `0` will preserve the textSize
|
||||||
|
return UIFont(
|
||||||
|
descriptor: (font.fontDescriptor.withSymbolicTraits(traits) ?? font.fontDescriptor),
|
||||||
|
size: 0
|
||||||
|
)
|
||||||
|
}
|
||||||
|
|
||||||
|
return self.reduce(into: [NSAttributedString.Key: Any]()) { result, tag in
|
||||||
|
switch tag {
|
||||||
|
case .bold where self.contains(.italic), .italic where self.contains(.bold):
|
||||||
|
result[.font] = fontWith(font, traits: [.traitBold, .traitItalic])
|
||||||
|
|
||||||
|
case .bold: result[.font] = fontWith(font, traits: [.traitBold])
|
||||||
|
case .italic: result[.font] = fontWith(font, traits: [.traitItalic])
|
||||||
|
case .underline: result[.underlineStyle] = NSUnderlineStyle.single.rawValue
|
||||||
|
case .strikethrough: result[.strikethroughStyle] = NSUnderlineStyle.single.rawValue
|
||||||
|
case .primaryTheme: result[.foregroundColor] = ThemeManager.primaryColor.color
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
public extension LocalizationHelper {
|
||||||
|
func localizedFormatted(in view: FontAccessible) -> NSAttributedString {
|
||||||
|
return localizedFormatted(baseFont: (view.fontValue ?? .systemFont(ofSize: 14)))
|
||||||
|
}
|
||||||
|
|
||||||
|
func localizedFormatted(baseFont: UIFont) -> NSAttributedString {
|
||||||
|
return NSAttributedString(stringWithHTMLTags: localized(), font: baseFont)
|
||||||
|
}
|
||||||
|
|
||||||
|
func localizedDeformatted() -> String {
|
||||||
|
return NSAttributedString(stringWithHTMLTags: localized(), font: .systemFont(ofSize: 14)).string
|
||||||
|
}
|
||||||
|
|
||||||
|
}
|
||||||
|
|
||||||
|
public protocol FontAccessible {
|
||||||
|
var fontValue: UIFont? { get }
|
||||||
|
}
|
||||||
|
|
||||||
|
public protocol DirectFontAccessible: FontAccessible {
|
||||||
|
var font: UIFont? { get }
|
||||||
|
}
|
||||||
|
|
||||||
|
extension DirectFontAccessible {
|
||||||
|
public var fontValue: UIFont? { font }
|
||||||
|
}
|
||||||
|
|
||||||
|
// UILabel has a `font!` value so we need to conform to a different protocol
|
||||||
|
extension UILabel: FontAccessible {
|
||||||
|
public var fontValue: UIFont? {
|
||||||
|
get { self.font }
|
||||||
|
}
|
||||||
|
}
|
||||||
|
extension UITextField: DirectFontAccessible {}
|
||||||
|
extension UITextView: DirectFontAccessible {}
|
||||||
|
|
||||||
|
public extension String {
|
||||||
|
func localizedFormatted(in view: FontAccessible) -> NSAttributedString {
|
||||||
|
return LocalizationHelper(template: self).localizedFormatted(in: view)
|
||||||
|
}
|
||||||
|
|
||||||
|
func formatted(in view: FontAccessible) -> NSAttributedString {
|
||||||
|
return NSAttributedString(stringWithHTMLTags: self, font: (view.fontValue ?? .systemFont(ofSize: 14)))
|
||||||
|
}
|
||||||
|
|
||||||
|
func formatted(baseFont: UIFont) -> NSAttributedString {
|
||||||
|
return NSAttributedString(stringWithHTMLTags: self, font: baseFont)
|
||||||
|
}
|
||||||
|
|
||||||
|
func deformatted() -> String {
|
||||||
|
return NSAttributedString(stringWithHTMLTags: self, font: .systemFont(ofSize: 14)).string
|
||||||
|
}
|
||||||
|
}
|
||||||
Loading…
Reference in New Issue