# YNDropDownMenu

[![Swift Package Manager](https://img.shields.io/badge/Swift%20Package%20Manager-compatible-brightgreen.svg?style=flat)](https://www.swift.org/package-manager/)
[![Version](https://img.shields.io/cocoapods/v/YNDropDownMenu.svg?style=flat)](http://cocoapods.org/pods/YNDropDownMenu)
[![Platform](https://img.shields.io/badge/platform-iOS%2013.0%2B-lightgrey.svg?style=flat)](https://developer.apple.com/ios/)
[![Swift 6.0](https://img.shields.io/badge/Swift-6.0-orange.svg?style=flat)](https://developer.apple.com/swift/)
[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg?style=flat)](https://github.com/younatics/YNDropDownMenu/blob/master/LICENSE)

## Updates
See [CHANGELOG](https://github.com/younatics/YNDropDownMenu/blob/master/CHANGELOG.md) for details

## Introduction
The eligible dropdown menu for iOS, written in Swift 6, appears dropdown menu to display a view of related items when a user click on the dropdown menu. You can customize dropdown view whatever you like (e.g. UITableView, UICollectionView... etc)

![demo](https://github.com/younatics/YNDropDownMenu/blob/master/Images/YNDropDownMenu.gif?raw=true)
![demo2](https://github.com/younatics/YNDropDownMenu/blob/master/Images/YNDropDownMenu2.gif?raw=true)

## Requirements

`YNDropDownMenu` is written in Swift 6.0 and requires iOS 15.0 or later. The package manifest uses Swift tools 6.0, and the CocoaPods deployment target is iOS 15.0.

## Installation

### Swift Package Manager

In Xcode, choose **File ▸ Add Package Dependencies…** and enter:

```
https://github.com/younatics/YNDropDownMenu.git
```

Or add it to your `Package.swift`:

```swift
dependencies: [
    .package(url: "https://github.com/younatics/YNDropDownMenu.git", from: "4.0.0")
]
```

### CocoaPods

YNDropDownMenu is available through [CocoaPods](http://cocoapods.org). To install
it, simply add the following line to your Podfile:

```ruby
pod 'YNDropDownMenu', '~> 4.0.0'
```

## Usage

```swift
import YNDropDownMenu
```

Init view with a frame `CGRect`, views `[UIView]`, and titles `[String]`

```swift
let dropDownMenu = YNDropDownMenu(
    frame: CGRect(x: 0, y: 64, width: view.bounds.width, height: 38),
    dropDownViews: dropDownViews,
    dropDownViewTitles: ["Apple", "Banana", "Kiwi", "Pear"]
)
view.addSubview(dropDownMenu)
```
done!

### Inherit YNDropDownView (If you need)
```swift
class DropDownView: YNDropDownView {
    // Override methods called when the menu opens and closes.
    override func dropDownViewOpened() {
        print("dropDownViewOpened")
    }
    
    override func dropDownViewClosed() {
        print("dropDownViewClosed")
    }

    func updateMenu() {
        // Hide Menu
        hideMenu()

        // Change Menu Title At Index
        changeMenu(title: "Changed", at: 1)
        changeMenu(title: "Changed", status: .selected, at: 1)

        // Change View At Index
        changeView(view: UIView(), at: 3)

        // Always Selected Menu
        alwaysSelected(at: 0)
        normalSelected(at: 0)
    }
}
```

### Customize

Show & Hide Menu 
```swift
dropDownMenu.showAndHideMenu(at: 1)

// When view is already opened
dropDownMenu.hideMenu()
```

Disable & Enable Menu 
```swift
dropDownMenu.disabledMenu(at: 2)
dropDownMenu.enabledMenu(at: 3)
```

Always/Normal selected button label
```swift
dropDownMenu.alwaysSelected(at: 0)
dropDownMenu.normalSelected(at: 0)
```

Button Images with 3 situations (normal, selected, disabled)

Provide one image for each menu item in every array.

```swift
let normalImages = Array(repeating: UIImage(named: "arrow_nor"), count: 4)
let selectedImages = Array(repeating: UIImage(named: "arrow_sel"), count: 4)
let disabledImages = Array(repeating: UIImage(named: "arrow_dim"), count: 4)

dropDownMenu.setStatesImages(
    normalImages: normalImages,
    selectedImages: selectedImages,
    disabledImages: disabledImages
)
```

Label color with 3 situations
```swift
dropDownMenu.setLabelColorWhen(normal: .black, selected: .blue, disabled: .gray)
```

Label font with 3 situations
```swift
dropDownMenu.setLabelFontWhen(
    normal: .systemFont(ofSize: 12),
    selected: .boldSystemFont(ofSize: 12),
    disabled: .systemFont(ofSize: 12)
)
```

BlurEffectView
```swift
// Enadbled or Disabled first (Default true)
dropDownMenu.backgroundBlurEnabled = false

// Use this line if you want to change UIBlurEffectStyle
dropDownMenu.blurEffectStyle = .light

// Or customize blurEffectView(UIView)
let backgroundView = UIView()
backgroundView.backgroundColor = UIColor.black
dropDownMenu.blurEffectView = backgroundView

// Animation end alpha
dropDownMenu.blurEffectViewAlpha = 0.7
```

Animation duration
```swift
dropDownMenu.showMenuDuration = 0.5
dropDownMenu.hideMenuDuration = 0.3
```

Animation velocity, damping
```swift
dropDownMenu.showMenuSpringVelocity = 0.5
dropDownMenu.showMenuSpringWithDamping = 0.8

dropDownMenu.hideMenuSpringVelocity = 0.9
dropDownMenu.hideMenuSpringWithDamping = 0.8
```

Change Menu Title At Index
```swift
dropDownMenu.changeMenu(title: "Changed", at: 1)
dropDownMenu.changeMenu(title: "Changed", status: .selected, at: 1)

```

Change View At Index 
```swift
dropDownMenu.changeView(view: UIView(), at: 3)
```

Change Bottom Line
```swift
dropDownMenu.bottomLine.backgroundColor = .black
dropDownMenu.bottomLine.isHidden = false
```


### Deprecated

The following APIs remain available for source compatibility. Use their replacements in new code.

```swift
// Use alwaysSelected(at:) instead.
dropDownMenu.alwaysSelectedAt(index: 0)

// Use disabledMenu(at:) and enabledMenu(at:) instead.
dropDownMenu.disabledMenuAt(index: 1)
dropDownMenu.enabledMenuAt(index: 1)

// Use showAndHideMenu(at:) instead.
dropDownMenu.showAndHideMenuAt(index: 2)

// In a YNDropDownView subclass, use changeMenu(title:at:) instead.
changeMenuTitleAt(index: 0, title: "Changed")
```
## References
#### Please tell me or make pull request if you use this library in your application :) 
#### [@zigbang](https://github.com/zigbang)
#### [MotionBook](https://github.com/younatics/MotionBook)

## Author
[younatics](https://twitter.com/younatics)
<a href="http://twitter.com/younatics" target="_blank"><img alt="Twitter" src="https://img.shields.io/twitter/follow/younatics.svg?style=social&label=Follow"></a>

## Thanks to
[jegumhon](https://github.com/jegumhon)

## License
YNDropDownMenu is available under the MIT license. See the LICENSE file for more info.