Files
letro-ios/ElementX/Sources/Other/Extensions/AttributedString.swift
2026-01-27 12:50:57 +02:00

96 lines
4.1 KiB
Swift

//
// Copyright 2025 Element Creations Ltd.
// Copyright 2023-2025 New Vector Ltd.
//
// SPDX-License-Identifier: AGPL-3.0-only OR LicenseRef-Element-Commercial.
// Please see LICENSE files in the repository root for full details.
//
import Foundation
extension AttributedString {
/// faster than doing `String(characters)`: https://forums.swift.org/t/attributedstring-to-string/61667
var string: String {
String(characters[...])
}
var formattedComponents: [AttributedStringBuilderComponent] {
var components = [AttributedStringBuilderComponent]()
for run in runs[\.blockquote, \.codeBlock] {
let isBlockquote = run.0 != nil
let isCodeBlock = run.1 != nil
var attributedString = AttributedString(self[run.2])
// Remove trailing new lines if any
if attributedString.characters.last?.isNewline ?? false,
let range = attributedString.range(of: "\n", options: .backwards, locale: nil) {
attributedString.removeSubrange(range)
}
let componentType: AttributedStringBuilderComponent.ComponentType = switch (isBlockquote, isCodeBlock) {
case (true, _):
.blockquote
case (false, true):
.codeBlock
case (false, false):
.plainText
}
components.append(AttributedStringBuilderComponent(id: String(attributedString.characters),
attributedString: attributedString,
type: componentType))
}
return components
}
/// Replaces the specified placeholder with a string that links to the specified URL.
/// - Parameters:
/// - linkPlaceholder: The text in the string that will be replaced. Make sure this is unique within the string.
/// - string: The text for the link that will be substituted into the placeholder.
/// - url: The URL that the link should open.
mutating func replace(_ linkPlaceholder: String, with string: String, asLinkTo url: URL) {
// Replace the placeholder with a link.
var replacement = AttributedString(string)
replacement.link = url
replace(linkPlaceholder, with: replacement)
}
/// Replaces the specified placeholder with the supplied attributed string.
/// - Parameters:
/// - placeholder: The text in the string that will be replaced. Make sure this is unique within the string.
/// - attributedString: The text for the link that will be substituted into the placeholder.
mutating func replace(_ placeholder: String, with replacement: AttributedString) {
guard let range = range(of: placeholder) else {
MXLog.failure("Failed to find the placeholder to be replaced.")
return
}
// Replace the placeholder.
replaceSubrange(range, with: replacement)
}
/// Returns a new attributed string, created by replacing any hard coded `UIFont` with
/// a simple presentation intent. This allows simple formatting to respond to Dynamic Type.
///
/// Currently only supports regular and bold weights.
func replacingFontWithPresentationIntent() -> AttributedString {
var newValue = self
for run in newValue.runs {
guard let font = run.uiKit.font else { continue }
newValue[run.range].inlinePresentationIntent = font.fontDescriptor.symbolicTraits.contains(.traitBold) ? .stronglyEmphasized : nil
newValue[run.range].uiKit.font = nil
}
return newValue
}
/// Makes the entire string bold by setting the presentation intent to strongly emphasized.
///
/// In practice, this is rendered as semibold for smaller font sizes and just so happens to nicely
/// line up with the semibold bold font switch used by compound.
mutating func bold() {
self[startIndex..<endIndex].inlinePresentationIntent = .stronglyEmphasized
}
}