Skip to content
SwiftUI library to easily render diagrams given a tree of objects. Similar to ring chart, sunburst chart, multilevel pie chart.
Swift Ruby
Branch: master
Clone or download
Ludovic Landry
Ludovic Landry Fixes for Xcode 10.2
Latest commit 0a75502 Nov 2, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
Docs Add macOS target Oct 9, 2019
Example Fixes for Xcode 10.2 Nov 2, 2019
Sources/SunburstDiagram Update configuration with allowsSelection and make nodes editable Oct 26, 2019
Tests Add macOS target Oct 9, 2019
.gitignore Prepare for demo app settings Jun 18, 2019
LICENSE
Package.swift Add podspec and reorganize project Jun 30, 2019
README.md Update README.md Oct 26, 2019
SunburstDiagram.podspec Remove tvOS compatibility for now Oct 26, 2019

README.md

Swift Sunburst Diagram

Swift Version License Swift Package Manager compatible CocoaPods Compatible

Sunburst diagram is a library written with SwiftUI to easily render diagrams given a tree of objects. Similar to ring chart, sunburst chart, multilevel pie chart.

diagram with icons only diagram with icons and text

This library requires Swift 5.1 and Xcode 11, some features available in the public API have not been implemented yet (see below).

Requirements

  • iOS 13.0+ / macOS 10.15+ / tvOS 13.0+ / watchOS 6.0+
  • Xcode 11+
  • Swift 5.1+

Installation

Swift Package Manager

The Swift Package Manager is a tool for automating the distribution of Swift code and is integrated into the swift compiler. It is now integrated in Xcode 11.

Once you have your Swift package set up, adding SunburstDiagram as a dependency is as easy as adding it to the dependencies value of your Package.swift.

dependencies: [
    .package(url: "https://github.com/lludo/SwiftSunburstDiagram.git")
]

Cocoapods

CocoaPods is a dependency manager for Cocoa projects. For usage and installation instructions, visit their website. To integrate Alamofire into your Xcode project using CocoaPods, specify it in your Podfile:

pod 'SunburstDiagram', '~> 1.1.0'

Manually

If you prefer not to use the Swift Package Manager, you can integrate SunburstDiagram into your project manually.

Features

  • Configure with a tree of node objects
  • Nodes have an optional label displayed (image & text)
  • Reactive UI with animated updates
  • Optionally configure nodes with a value (4 different rendering modes)
  • Infinite number of layers (circles) support
  • Option to configure margin, size, sort and initial positions of arcs
  • Option to collapse arcs beyond a certain layer (to show more layers with less data)
  • Ability to select a node and focus on a node to see more details or disable selection
  • Option for maximum number of rings to display (like a window moving as you focus on nodes)

Usage

// Create your configuration model
let configuration = SunburstConfiguration(nodes: [
    Node(name: "Walking", value: 10.0, backgroundColor: .systemBlue),
    Node(name: "Restaurant", value: 30.0, backgroundColor: .systemRed, children: [
        Node(name: "Dessert", image: UIImage(named: "croissant"), value: 6.0),
        Node(name: "Dinner", image: UIImage(named: "poultry"), value: 10.0),
    ]),
    Node(name: "Transport", value: 10.0, backgroundColor: .systemPurple),
    Node(name: "Home", value: 50.0, backgroundColor: .systemTeal),
])

// Get the view controller for the SunburstView
let viewController = UIHostingController(rootView: SunburstView(configuration: configuration))

Communication

If you found a bug or want to discuss a new feature do not hesitate to message me. If you want to contribute, all pull requests are always welcome. Thank you!

Demo App

The demo app in this repo is also written with SwiftUI and allows to experience the API of this library in a grapical and reactive way.

iOS demo app first screenshot iOS demo app second screenshot iOS demo app third screenshot

macOS demo app screenshot

Todo

  • Implement option for min arc percentage (if less, show data in grouped in "other")
  • Compute arc colors if not provided by nodes
  • Add option to show un-assigned if total of arcs is less than 100%
  • Add rounded corners option for arcs with margins?

Inspirations

This project has been inspired by the DaisyDisk UI and the Apple SwiftUI Building Custom Views with SwiftUI WWDC2019 session.

You can’t perform that action at this time.