Ashton (AttributedStringHTMLTransformation) is an iOS and macOS library for fast conversion of NSAttributedStrings into HTML, and back. Ashton is battle-tested and used in MindNode, for persisting formatted strings.
The latest release is a complete rewrite in Swift focusing on improved performance and functional backwards compatibility to Ashton 1.x. The new codebase has a comprehensive test suite with a test coverage of > 90% and additional tests against the legacy 1.0 output.
Find out more about the launch of Ashton 2.0 in our Blog Post.
NSAttributedString.Key attributes are supported, when converting to
As Ashton supports only tags which are necessary to persist the attributes mentioned above, not all HTML tags are supported when converting
AttributedString. Basically, Ashton converts an AttributedString into a concatenation of
a tags with style attributes.
Supported HTML Tags:
The following style attribute keys are supported:
Colors have to be formatted as rgba like
rgba(0, 0, 0, 1.000000).
Add this line to your Cartfile.
The Swift Package Manager is a dependency manager integrated with the Swift build system. To learn how to use the Swift Package Manager for your project, please read the official documentation.
To add ZIP Foundation as a dependency, you have to add it to the
dependencies of your
Package.swift file and refer to that dependency in your
// swift-tools-version:5.1 import PackageDescription let package = Package( name: "<Your Product Name>", dependencies: [ .package(url: "https://github.com/IdeasOnCanvas/Ashton/", .upToNextMajor(from: "2.0.0")) ], targets: [ .target( name: "<Your Target Name>", dependencies: ["Ashton"]), ] )
After adding the dependency, you can fetch the library with:
$ swift package resolve
let htmlString = Ashton.encode(attributedString)
let attributedString = Ashton.decode(htmlString)
An example app can be found in the
/Example directory. It can be used to test
NSAttributedString -> HTML ->
NSAttributedString roundtrips and also to extract the HTML representation of an `NSAttributedString.