Close Menu

btnavigationdropdownmenu


Introduction

The ButtonNavigationDropdownMenu is a customizable dropdown menu component for iOS, designed to be used in conjunction with a navigation bar. It provides a clean and user-friendly way to present a list of options or actions to the user.

Features

  • Customizable appearance
  • Support for both text and image-based menu items
  • Option to display selected item permanently or toggle display
  • Support for dropdown menu alignment (left, center, right)
  • Easy integration with navigation bar

Requirements

The ButtonNavigationDropdownMenu component requires:

  • iOS 10.0 or later
  • Xcode 10.0 or later
  • Swift 4.2 or later

Installation

CocoaPods

To install ButtonNavigationDropdownMenu using CocoaPods, add the following line to your Podfile:

pod 'ButtonNavigationDropdownMenu'

Carthage

To install ButtonNavigationDropdownMenu using Carthage, add the following line to your Cartfile:

github "ButtonNavigationDropdownMenu/ButtonNavigationDropdownMenu"

Manual

If you prefer not to use dependency managers, you can directly download the source code from the GitHub repository and manually integrate it into your Xcode project.

Usage

Import

In your Swift file, import the ButtonNavigationDropdownMenu module:

import ButtonNavigationDropdownMenu

Initialization

Create an instance of ButtonNavigationDropdownMenu by specifying the parent view controller, the array of menu items, and optionally the appearance settings:

let menuItems = ["Item 1", "Item 2", "Item 3"]
let dropdownMenu = ButtonNavigationDropdownMenu(navigationController: self.navigationController, items: menuItems)

Displaying the Dropdown Menu

To present the dropdown menu, simply call the show() method:

dropdownMenu.show()

Customization

Appearance

The appearance of the dropdown menu can be customized using the following properties:

  • cellBackgroundColor: The background color of the menu cells
  • cellTextColor: The text color of the menu cells
  • cellFont: The font of the menu cells
  • cellHeight: The height of the menu cells
  • menuBackgroundColor: The background color of the menu view
  • menuSeparatorColor: The color of the menu separators
  • arrowTintColor: The tint color of the arrow icon

Example

To customize the appearance, set the desired values before calling the show() method:

dropdownMenu.cellBackgroundColor = .white
dropdownMenu.cellTextColor = .black
dropdownMenu.cellFont = UIFont.systemFont(ofSize: 14)
dropdownMenu.cellHeight = 40
dropdownMenu.menuBackgroundColor = .lightGray
dropdownMenu.menuSeparatorColor = .gray
dropdownMenu.arrowTintColor = .black
dropdownMenu.show()

Delegate

To handle selection events and receive callbacks, you can conform to the ButtonNavigationDropdownMenuDelegate protocol:

class ViewController: UIViewController, ButtonNavigationDropdownMenuDelegate {
    override func viewDidLoad() {
        super.viewDidLoad()
        dropdownMenu.delegate = self
    }
    
    func didSelectItem(at index: Int) {
        // Handle selection events
    }
}

Further Customization

Selected Item Display

You can choose whether to display the selected item permanently or toggle between the selected item and the dropdown arrow:

  • showSelectedItem: Set to true to display the selected item at all times, or false to toggle between the item and arrow

Example

To show the selected item at all times, set the showSelectedItem property to true:

dropdownMenu.showSelectedItem = true

Dropdown Alignment

You can align the dropdown menu to the left, center, or right of the navigation bar:

  • dropdownAlignment: Set to .left, .center, or .right to align the dropdown menu

Example

To align the dropdown menu to the center, set the dropdownAlignment property to .center:

dropdownMenu.dropdownAlignment = .center

Conclusion

The ButtonNavigationDropdownMenu provides a convenient way to integrate customizable dropdown menus within your iOS application. With its easy integration and extensive customization options, it enhances the user experience by offering intuitive and visually appealing navigation.