Litext

Features

Supported Platforms

Getting Started

dependencies: [
 .package(url: "https://github.com/Helixform/Litext.git", branch: "main")
]

Basic Usage

import Litext
let label = LTXLabel()
view.addSubview(label)
// Create attributed string with styling.
let attributedString = NSMutableAttributedString(
 string: "Hello, Litext!",
 attributes: [
 .font: NSFont.systemFont(ofSize: 16),
 .foregroundColor: NSColor.labelColor
 ]
)
// Set the attributed text to display.
label.attributedText = attributedString

Handling Link Actions

let linkString = NSAttributedString(
 string: "Visit our website",
 attributes: [
 .font: NSFont.systemFont(ofSize: 14),
 .link: URL(string: "https://example.com")!,
 .foregroundColor: NSColor.linkColor
 ]
)
attributedString.append(linkString)
// Handle link taps.
label.tapHandler = { highlightRegion in
 if let url = highlightRegion.attributes[.link] as? URL {
 NSWorkspace.shared.open(url)
 }
}

Adding Native Views

// Create and configure attachment.
let attachment = LTXAttachment()
let switchView = NSSwitch()
attachment.view = switchView
attachment.size = switchView.intrinsicContentSize
// Add attachment to text.
//
// `kCTRunDelegateAttributeName` must be included to ensure the
// attachment is rendered correctly.
attributedString.append(
 NSAttributedString(
 string: LTXReplacementText,
 attributes: [
 .LTXAttachmentAttributeName: attachment,
 kCTRunDelegateAttributeName as NSAttributedString.Key: attachment.runDelegate
 ]
 )
)

License