How do I add a text field to a CDAlertView?

Set the `isTextFieldHidden` property to false and configure related properties like `textFieldPlaceholderText` and `textFieldIsSecureTextEntry`. You can also set a delegate for advanced handling, but note that default delegation is managed by CDAlertView.

CDAlertView vs UIAlertController: which should I use?

Use CDAlertView for deep customization, text fields, or unique animations beyond Apple's defaults. Stick with UIAlertController for simplicity, adherence to iOS standards, and avoiding third-party dependencies. CDAlertView is better for branded or feature-rich alerts.

Can CDAlertView show alerts without any buttons?

Yes, alerts can be displayed without buttons; touching outside or moving the alert will dismiss it. If buttons are added, only button presses will dismiss it, as explained in the basic usage note.

How do I change the icon in CDAlertView?

Use the `.custom(image:)` type during initialization with a custom UIImage, or adjust `circleFillColor` and `isHeaderIconFilled` for predefined types. This allows full control over icon appearance and background colors.

Is CDAlertView compatible with SwiftUI projects?

CDAlertView is built with UIKit, so it can be used in SwiftUI via UIViewRepresentable, but it's not native and requires bridging code. For pure SwiftUI projects, consider SwiftUI-based alert solutions instead.

How do I make a CDAlertView auto-dismiss after a few seconds?

Set the `autoHideTime` property to the desired time interval in seconds, and the alert will hide automatically after that duration. You can combine this with custom animations for smoother transitions.

What happens if I use more than three horizontal buttons?

The README explicitly states that using more than three buttons in horizontal placement is not possible, so the layout will likely break or default to vertical alignment. Plan button arrangements accordingly to avoid UI issues.

Open-Awesome

CDAlertView

MITSwift0.11.0

A highly customizable iOS alert/notification popup library written in Swift, similar to UIAlertController.

Visit Website GitHub

1.1k stars85 forks0 contributors

What is CDAlertView?

CDAlertView is a Swift library for creating highly customizable alert and notification popups on iOS. It solves the limitation of native UIAlertController by offering extensive styling options, multiple alert types, and support for custom views and animations.

Target Audience

iOS developers who need more design flexibility than UIAlertController provides, especially those building apps with custom UI/UX requirements.

Value Proposition

Developers choose CDAlertView for its deep customization capabilities, familiar API similar to UIAlertController, and support for features like text fields, custom animations, and multiple button layouts.

Overview

Highly customizable alertview and alert/notification/success/error/alarm popup written in Swift

Use Cases

Best For

Displaying styled success/error notifications in iOS apps
Creating custom alert dialogs with unique branding
Adding interactive text fields within alerts
Implementing auto-dismissing notification popups
Showing alerts with custom icons and animations
Building alerts with vertical or horizontal button arrangements

Not Ideal For

Applications requiring more than three action buttons in a horizontal layout
Projects where automatic layout management for embedded custom views is essential
Teams strictly adhering to Apple's Human Interface Guidelines without third-party modifications
Apps targeting iOS versions below 9.0

Pros & Cons

Pros

Extensive Styling Options

Allows full control over colors, fonts, rounded corners, and shadows, making it easy to match alerts precisely to app branding, as shown by properties like `titleTextColor` and `hasRoundedCorners`.

Predefined Alert Types

Includes error, success, warning, and other types with appropriate icons, saving design time and ensuring consistency across common use cases without custom image creation.

Flexible Button Arrangements

Supports both vertical and horizontal button layouts with customizable fonts and colors, adapting to different dialog complexities, though horizontal is limited to three buttons.

Text Field Integration

Enables input fields within alerts with configurable properties like secure entry and placeholders, extending functionality beyond native UIAlertController's basic support.

Custom Animation Support

Provides hooks for custom hide animations and auto-dismiss timers via `hideAnimations` and `autoHideTime`, allowing for enhanced interactive feedback and user experience.

Cons

Horizontal Button Limit

Restricts to a maximum of three buttons in horizontal layout, as noted in the README, which can be insufficient for complex dialogs requiring multiple actions.

Manual Custom View Height

Requires developers to manually manage the height of embedded custom views, leading to potential layout issues and added complexity, as warned in the custom view section.

Swift Version Fragmentation

Different library versions are needed for various Swift versions (e.g., 0.9.1 for Swift 4.2), complicating dependency management and upgrades, as indicated in the installation notes.

Frequently Asked Questions

Related Projects

SwiftMessages

A very flexible message bar for UIKit and SwiftUI.

Stars7,558

Forks765

Last commit3 months ago

SwiftEntryKit

SwiftEntryKit is a presentation library for iOS. It can be used to easily display overlays within your iOS apps.

Stars6,758

Forks621

Last commit1 year ago

Alerts & Pickers

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

Stars5,763

Forks708

Last commit2 years ago

BulletinBoard

General-purpose contextual cards for iOS

Stars5,350

Forks302

Last commit4 years ago

Community-curated · Updated weekly · 100% open source

Found a gem we're missing?

Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.

Submit a project Star on GitHub