Home

Awesome

<p align="center"> <img src="https://raw.githubusercontent.com/amerhukic/AHDownloadButton/master/Logo.png" width="420" max-width="80%" alt="Logo" /> </p> <p align="center"> <img src="https://img.shields.io/badge/Swift-5.0-orange.svg" /> <a href="https://cocoapods.org/pods/AHDownloadButton"> <img src="https://img.shields.io/cocoapods/v/AHDownloadButton.svg?style=flat" alt="Pod Version"> </a> <a href="https://img.shields.io/badge/Swift_Package_Manager-compatible-orange"> <img src="https://img.shields.io/badge/Swift_Package_Manager-compatible-orange" alt="SPM compatible"> </a> <a href="https://github.com/Carthage/Carthage"> <img src="https://img.shields.io/badge/Carthage-compatible-4BC51D.svg?style=flat" alt="Carthage compatible"> </a> <a href=""> <img src="https://img.shields.io/badge/Licence-MIT-green.svg" alt="License"> </a> <a href="https://twitter.com/hukicamer"> <img src="https://img.shields.io/badge/contact-%40hukicamer-blue.svg?style=flat" alt="Twitter: @hukicamer" /> </a> </p>

AHDownloadButton is a customizable download button similar to the download button in the latest version of Apple's App Store app (since iOS 11). It features download progress animation as well as animated transitions between download states: start download, pending, downloading and downloaded. You can find more details about the implementation on my blog.

<p align="center"><img src="https://raw.githubusercontent.com/amerhukic/AHDownloadButton/master/Demo.gif"/> </p>

Requirements

Usage

Code

To use AHDownloadButton in code, you simply create a new instance and add it as a subview to your desired view:

  let downloadButton = AHDownloadButton()
  downloadButton.frame = CGRect(origin: origin, size: size)
  view.addSubview(downloadButton)

The button can have 4 different states:

The state of the button can be changed through its state property.

Delegate

You can use the AHDownloadButtonDelegate to monitor taps on the button and update button's state if needed. To update the current download progress, use the progress property. Here is an example how it could be implemented:

extension DownloadViewController: AHDownloadButtonDelegate {

    func downloadButton(_ downloadButton: AHDownloadButton, tappedWithState state: AHDownloadButton.State)
        switch state {
        case .startDownload:

            // set the download progress to 0
            downloadButton.progress = 0

            // change state to pending and wait for download to start
            downloadButton.state = .pending

            // initiate download and update state to .downloading
            startDownloadingFile()

        case .pending:

            // button tapped while in pending state
            break

        case .downloading:

            // button tapped while in downloading state - stop downloading
            downloadButton.progress = 0
            downloadButton.state = .startDownload

        case .downloaded:

            // file is downloaded and can be opened
            openDownloadedFile()

        }
    }
}

You can also use closures instead of the AHDownloadButtonDelegate by setting the didTapDownloadButtonAction and downloadButtonStateChangedAction properties.

Customisation

AHDownloadButton can be customized. These are the properties that can be used for customizing the button:

  1. Use the custom initializer init(alignment: HorizontalAlignment) to set the horizontal alignment property. HorizontalAlignment determines the position of the pending and downloading circles. The position can either be center , left or right. The default value is center.

  2. Customization properties when button is in startDownload state:

  1. Customization properties when button is in pending state:
  1. Customization properties when button is in downloading state:
  1. Customization properties when button is in downloaded state:
  1. transitionAnimationDuration - animation duration between the different states of the button

Special note

AHDownloadButton in startDownload and downloaded states calculates its width based on button title. Use the startDownloadButtonTitleSidePadding and downloadedButtonTitleSidePadding properties to customise the width when the button is in the aforementioned states.

Example

To run the example project, clone the repo, and run pod install from the Example directory first.

Installation

CocoaPods

CocoaPods is a dependency manager for Cocoa projects. You can install it with the following command:

$ gem install cocoapods

To integrate AHDownloadButton into your Xcode project using CocoaPods, specify it in your Podfile:

source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '8.0'
use_frameworks!

target '<Your Target Name>' do
    pod 'AHDownloadButton'
end

Then, run the following command:

$ pod install

Carthage

Carthage is a decentralized dependency manager that builds your dependencies and provides you with binary frameworks. To integrate AHDownloadButton into your Xcode project using Carthage, specify it in your Cartfile:

github "amerhukic/AHDownloadButton" ~> 1.3.0

Swift Package Manager

The Swift Package Manager is a tool for automating the distribution of Swift code and is integrated into the swift compiler.

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

dependencies: [
    .package(url: "https://github.com/amerhukic/AHDownloadButton", .upToNextMajor(from: "1.3.0"))
]

Author

Amer Hukić

License

AHDownloadButton is licensed under the MIT license. Check the LICENSE file for details.