LiquidFloatingActionButton is a custom floating action button (FAB) implementation for iOS, which provides a unique and visually appealing liquid-like animation when the button is pressed or released. This library allows developers to easily integrate a dynamic and engaging FAB into their iOS applications.

Pros

• Unique Animation: The liquid-like animation of the FAB creates a visually striking and engaging user experience.
• Customizable: The library offers various customization options, allowing developers to adjust the button's appearance and behavior to fit their app's design.
• Easy Integration: The library is well-documented and provides a straightforward integration process, making it easy for developers to incorporate the FAB into their projects.
• Smooth Transitions: The liquid animation transitions smoothly between the button's expanded and collapsed states, providing a polished and professional look.

Cons

• Limited Functionality: The library is primarily focused on the FAB's animation and appearance, and may not provide advanced functionality or integration with other UI elements.
• Performance Considerations: The liquid animation may have a higher performance impact compared to a standard FAB, especially on older or less powerful devices.
• Dependency on External Library: The project relies on the Lottie library for the animation, which adds an additional dependency to the project.
• Potential Compatibility Issues: As with any third-party library, there may be potential compatibility issues with newer versions of iOS or other dependencies.

Code Examples

Initializing the FAB

let liquidButton = LiquidFloatingActionButton(
    image: UIImage(named: "your_fab_icon"),
    highlightedImage: UIImage(named: "your_fab_icon_highlighted")
)

This code initializes a new LiquidFloatingActionButton instance with the provided icon images.

Configuring the FAB

liquidButton.buttonColor = .systemBlue
liquidButton.buttonHighlightedColor = .systemIndigo
liquidButton.buttonShadowColor = .black
liquidButton.buttonShadowOffset = CGSize(width: 0, height: 2)
liquidButton.buttonShadowOpacity = 0.4
liquidButton.buttonShadowRadius = 4

This code sets various properties of the FAB, such as the button color, highlighted color, shadow color, offset, opacity, and radius.

Adding the FAB to the View

view.addSubview(liquidButton)
liquidButton.translatesAutoresizingMaskIntoConstraints = false
NSLayoutConstraint.activate([
    liquidButton.trailingAnchor.constraint(equalTo: view.trailingAnchor, constant: -16),
    liquidButton.bottomAnchor.constraint(equalTo: view.bottomAnchor, constant: -16)
])

This code adds the FAB to the view and sets its position using Auto Layout constraints.

Getting Started

To get started with the LiquidFloatingActionButton library, follow these steps:

1. Add the library to your project using a dependency manager like CocoaPods or Carthage.

   # CocoaPods
   pod 'LiquidFloatingActionButton'
   

2. Import the library in your Swift file:

   import LiquidFloatingActionButton
   

3. Create an instance of the LiquidFloatingActionButton and configure it as needed:

   let liquidButton = LiquidFloatingActionButton(
       image: UIImage(named: "your_fab_icon"),
       highlightedImage: UIImage(named: "your_fab_icon_highlighted")
   )
   liquidButton.buttonColor = .systemBlue
   liquidButton.buttonHighlightedColor = .systemIndigo
   

4. Add the FAB to your view hierarchy:

   view.addSubview(liquidButton)
   liquidButton.translatesAutoresizingMaskIntoConstraints = false
   NSLayoutConstraint.activate([
       liquidButton.trailingAnchor.constraint(equalTo: view.trailingAnchor, constant: -16),
       liquidButton.bottomAnchor.constraint(equalTo: view.bottomAnchor