Swiftpack.co -  IdeasOnCanvas/Ashton as Swift Package
Swiftpack.co is a collection of thousands of indexed Swift packages. Search packages.
IdeasOnCanvas/Ashton
Converts NSAttributedStrings into HTML (and back)
.package(url: "https://github.com/IdeasOnCanvas/Ashton.git", from: "v1.0.4")

Ashton

Carthage Compatible Platforms iOS, macOS Language Swift License Build status Twitter: @mschwarz

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.

2.0 Release

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.

Supported Attributes

The following NSAttributedString.Key attributes are supported, when converting to HTML:

  • ☑ .backgroundColor (persisted as RGBA)
  • ☑ .foregroundColor (persisted as RGBA)
  • ☑ .underlineStyle (single, double, thick)
  • ☑ .underlineColor (persisted as RGBA)
  • ☑ .strikethroughColor (persisted as RGBA)
  • ☑ .strikethroughStyle (single, double, thick)
  • ☑ .font
  • ☑ .paragraphStyle (text alignment)
  • ☑ .baselineOffset
  • ☑ NSSuperScript
  • ☑ .link

Supported HTML Tags & Attributes

As Ashton supports only tags which are necessary to persist the attributes mentioned above, not all HTML tags are supported when converting HTML --> AttributedString. Basically, Ashton converts an AttributedString into a concatenation of span, p and a tags with style attributes.

Supported HTML Tags:

  • ☑ span
  • ☑ p
  • ☑ a
  • ☑ em
  • ☑ strong

The following style attribute keys are supported:

  • ☑ background-color
  • ☑ color
  • ☑ text-decoration
  • ☑ font
  • ☑ text-align
  • ☑ vertical-align
  • ☑ Additional custom attributes (-cocoa-strikethrough-color, -cocoa-underline-color, -cocoa-baseline-offset, -cocoa-vertical-align, -cocoa-font-postscriptname, -cocoa-underline, -cocoa-strikethrough, -cocoa-fontFeatures)

Colors have to be formatted as rgba like rgba(0, 0, 0, 1.000000).

Integration

Carthage

Add this line to your Cartfile.

github "IdeasOnCanvas/Ashton"

Integration with the Swift Package Manager

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 target.

// 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

Usage

Encode HTML

let htmlString = Ashton.encode(attributedString)

Decode NSAttributedString

let attributedString = Ashton.decode(htmlString)

Example App

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.

Credits

Ashton is brought to you by IdeasOnCanvas GmbH, the creator of MindNode for iOS, macOS & watchOS.

GitHub

link
Stars: 436
Last commit: 2 weeks ago

Ad: Job Offers

iOS Software Engineer @ Perry Street Software
Perry Street Software is Jack’d and SCRUFF. We are two of the world’s largest gay, bi, trans and queer social dating apps on iOS and Android. Our brands reach more than 20 million members worldwide so members can connect, meet and express themselves on a platform that prioritizes privacy and security. We invest heavily into SwiftUI and using Swift Packages to modularize the codebase.

Release Notes

2.0.8
2 weeks ago

Changes

[Chore] Fix a Xcode 12.5 deprecation warning (AnyObject instead of class keyword)

Swiftpack is being maintained by Petr Pavlik | @ptrpavlik | @swiftpackco | API