How to customize Hokusai action sheet colors?

Use the built-in color schemes like HOKColorScheme.Enshu or define custom colors with HOKColors, specifying background, button, and font colors via UIColor properties as shown in the README.

Hokusai vs standard iOS action sheet: which is better?

Hokusai offers more visual appeal with bouncy animations and easy customization, but standard UIAlertController is more native, lightweight, and adheres to iOS guidelines without extra dependencies. Choose based on design needs.

How to add buttons with actions in Hokusai?

Use the addButton method with a closure for inline code or a selector for target-action patterns, as demonstrated in the usage code. This allows flexible handling of user taps without complex setup.

Is Hokusai compatible with Swift 5?

The README specifies Swift3, so compatibility with Swift 5 isn't guaranteed. You may need to check for updates, fork the repository, or test it in your project to ensure it works with newer Swift versions.

Can I use Hokusai in a Carthage project?

Yes, add 'github "ytakzk/Hokusai"' to your Cartfile and run carthage update. The README confirms Carthage compatibility, making integration straightforward for iOS projects using this dependency manager.

How to change the font in Hokusai action sheet?

Set the fontName property to a valid font string, such as 'Verdana-Bold', with AvenirNext-DemiBold as the default. This allows quick font adjustments to match your app's typography.

Open-Awesome

Hokusai

MITSwift

A Swift library providing a bouncy action sheet with customizable animations and color schemes.

GitHub

431 stars33 forks0 contributors

What is Hokusai?

Hokusai is a Swift library that provides a bouncy action sheet for iOS applications. It solves the problem of implementing complex animations for action sheets by offering a pre-built, customizable component that delivers a smooth and engaging user experience. The library is compatible with Swift 3 and integrates easily with dependency managers like CocoaPods and Carthage.

Target Audience

iOS developers looking to enhance their apps with animated UI components without writing extensive animation code. It's particularly useful for those building consumer-facing apps where user experience and visual appeal are priorities.

Value Proposition

Developers choose Hokusai because it simplifies the creation of visually striking action sheets with minimal code, offers multiple customization options for colors and fonts, and is easy to integrate into existing projects. Its bouncy animation provides a modern, polished feel that stands out compared to standard iOS action sheets.

Overview

A Swift library to provide a bouncy action sheet

Use Cases

Best For

Adding animated action sheets to iOS apps
Enhancing user experience with bouncy UI components
Customizing action sheet colors and fonts quickly
Implementing action sheets with closure-based button actions
Building apps that require visually engaging dialogs
Simplifying animation coding for iOS developers

Not Ideal For

Projects requiring strict adherence to native iOS UI guidelines without custom animations
Applications needing action sheets with advanced features like image attachments or dynamic content
Cross-platform development targeting both iOS and Android
Teams needing fine-grained control over animation physics or server-side rendering

Pros & Cons

Pros

Engaging Bouncy Animations

Provides smooth, visually appealing action sheets that enhance user experience, as demonstrated in the demo GIF, without requiring custom animation code.

Easy Color Customization

Offers multiple built-in color schemes (e.g., Asagi, Matcha) and allows custom color definitions via HOKColors, making it flexible for different app themes.

Flexible Button Actions

Supports adding buttons with closures or selectors, giving developers options for handling user interactions simply, as shown in the usage examples.

Simple Integration

Compatible with CocoaPods and Carthage, enabling quick setup without manual file management, as per the installation instructions.

Cons

Outdated Swift Compatibility

The README only mentions Swift3, with no clear support for newer Swift versions, which could lead to integration issues in modern projects.

Limited Feature Set

Focuses on basic action sheet functionality without native support for images, accessibility features, or dynamic content updates, limiting its use for complex UIs.

Fixed Animation Style

The bouncy animation is hardcoded and not customizable, so if a different animation type is needed, developers must look elsewhere or modify the library.

Frequently Asked Questions

Related Projects

SwiftMessages

A very flexible message bar for UIKit and SwiftUI.

Stars7,548

Forks765

Last commit7 months ago

Alerts & Pickers

Advanced usage of UIAlertController and pickers based on it: Telegram, Contacts, Location, PhotoLibrary, Country, Phone Code, Currency, Date...

Stars5,761

Forks701

Last commit2 years ago

BulletinBoard

General-purpose contextual cards for iOS

Stars5,337

Forks301

Last commit4 years ago

SCLAlertView-Swift

Beautiful animated Alert View. Written in Swift

Stars5,307

Forks749