Close Menu

stpickerview

Introduction

The STPickerView is a customizable UIPickerView alternative written in Swift.

Features

  • Customizable appearance
  • Support for custom data sources
  • Delegate methods for handling pickerView events
  • Smooth scrolling and selection animation

Installation

You can install STPickerView through CocoaPods or manually.

CocoaPods

  1. Add pod 'STPickerView' to your Podfile.
  2. Run pod install in Terminal.
  3. Import STPickerView in your Swift file.

Manual Installation

  1. Download the latest release from the GitHub repository.
  2. Drag and drop the STPickerView.swift file into your Xcode project.
  3. Make sure the file is added to your target.

Usage

Note: This example assumes you have installed STPickerView using CocoaPods.

To use STPickerView, follow these steps:

Step 1: Import the framework

In your Swift file, import the STPickerView framework:

import STPickerView

Step 2: Create an instance

Create an instance of STPickerView either programmatically or through the storyboard.

Step 3: Set the data source

Set the data source for the pickerView by implementing the STPickerViewDataSource protocol.

Step 4: Set the delegate

Set the delegate for the pickerView by implementing the STPickerViewDelegate protocol.

Step 5: Implement data source methods

Implement the required data source methods:

  • numberOfComponents(in pickerView: STPickerView) -> Int: returns the number of components in the pickerView.
  • pickerView(_ pickerView: STPickerView, numberOfRowsInComponent component: Int) -> Int: returns the number of rows in the specified component.
  • pickerView(_ pickerView: STPickerView, titleForRow row: Int, forComponent component: Int) -> String?: returns the title for a specific row in the component.

Step 6: Implement delegate methods

Implement the delegate methods as per your requirements:

  • pickerView(_ pickerView: STPickerView, didSelectRow row: Int, inComponent component: Int): handles the selection of a row in the component.
  • pickerView(_ pickerView: STPickerView, viewForRow row: Int, forComponent component: Int, reusing view: UIView?): returns a custom view for a specified row and component.
  • pickerView(_ pickerView: STPickerView, widthForComponent component: Int) -> CGFloat: returns the desired width for the specified component.
  • pickerView(_ pickerView: STPickerView, rowHeightForComponent component: Int) -> CGFloat: returns the desired height for the specified component.
  • pickerView(_ pickerView: STPickerView, attributedTitleForRow row: Int, forComponent component: Int) -> NSAttributedString?: returns the attributed title for a specific row in the component.

Step 7: Customize appearance

Customize the appearance of the STPickerView by accessing its properties and methods:

  • pickerBackgroundColor: color of the picker view background
  • selectionBackgroundColor: color of the selected row background
  • textColor: color of the text in the picker view
  • font: font of the text in the picker view
  • setPickerViewStyle(_ style: STPickerView.Style): sets the style of the picker view
  • reloadAllComponents(): reloads all components in the picker view

Example

Here’s an example of using STPickerView to display a list of countries:

import STPickerView

class ViewController: UIViewController, STPickerViewDataSource, STPickerViewDelegate {

    @IBOutlet weak var pickerView: STPickerView!
    
    let countries = ["USA", "Canada", "UK", "Australia"]
    
    override func viewDidLoad() {
        super.viewDidLoad()
        
        pickerView.dataSource = self
        pickerView.delegate = self
        
        pickerView.reloadAllComponents()
    }

    func numberOfComponents(in pickerView: STPickerView) -> Int {
        return 1
    }
    
    func pickerView(_ pickerView: STPickerView, numberOfRowsInComponent component: Int) -> Int {
        return countries.count
    }
    
    func pickerView(_ pickerView: STPickerView, titleForRow row: Int, forComponent component: Int) -> String? {
        return countries[row]
    }
    
    func pickerView(_ pickerView: STPickerView, didSelectRow row: Int, inComponent component: Int) {
        let selectedCountry = countries[row]
        print("Selected country: \(selectedCountry)")
    }
}

Conclusion

STPickerView provides a customizable and convenient alternative to UIPickerView. By following the steps mentioned in this documentation, you should be able to integrate and use STPickerView in your Swift projects with ease.