https://github.com/toastersocks/multipicker

A Picker for iOS that can be used to choose from one, one or none, or multiple options.
https://github.com/toastersocks/multipicker

multipicker picker swift swiftui

Last synced: 3 months ago
JSON representation

A Picker for iOS that can be used to choose from one, one or none, or multiple options.

• Host: GitHub
• URL: https://github.com/toastersocks/multipicker
• Owner: toastersocks
• License: mit
• Created: 2023-03-08T22:20:04.000Z (almost 2 years ago)
• Default Branch: main
• Last Pushed: 2024-08-14T01:53:26.000Z (5 months ago)
• Last Synced: 2024-10-10T22:42:15.511Z (3 months ago)
• Topics: multipicker, picker, swift, swiftui
• Language: Swift
• Homepage:
• Size: 826 KB
• Stars: 30
• Watchers: 3
• Forks: 6
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# MultiPicker

[![](https://img.shields.io/endpoint?url=https%3A%2F%2Fswiftpackageindex.com%2Fapi%2Fpackages%2Ftoastersocks%2FMultiPicker%2Fbadge%3Ftype%3Dswift-versions)](https://swiftpackageindex.com/toastersocks/MultiPicker)

[![](https://img.shields.io/endpoint?url=https%3A%2F%2Fswiftpackageindex.com%2Fapi%2Fpackages%2Ftoastersocks%2FMultiPicker%2Fbadge%3Ftype%3Dplatforms)](https://swiftpackageindex.com/toastersocks/MultiPicker)

![](https://img.shields.io/badge/iOS-16+-blue)

![](https://img.shields.io/badge/visionOS-17+-blue)

---

## A picker for selecting from multiple options. Or no options

SwiftUI's `Picker` on iOS only allows choosing exactly one option. If you need a picker that allows selecting one optional value, or multiple values from a set, you're outta luck. MultiPicker can do all three!

![Navigation link style, plain text choice style, light mode, English](img/nav-plain-light-en.png)

![Navigation link style, rich choice style, dark mode, English](img/nav-rich-dark-en.png)

![Navigation link style, rich choice style, dark mode, Portuguese](img/nav-plain-dark-pt.png)

![Navigation link style, rich choice style, dark mode, Arabic](img/nav-rich-dark-ar.png)

![Inline style, leading and trailing selection indicator, light mode, English](img/list-light-leading-trailing-en.png)

![Inline style, leading and trailing selection indicator, dark mode, Arabic](img/list-dark-leading-trailing-ar.png)

MultiPicker tries to make its API as close to the SwiftUI `Picker`'s as possible.

MultiPicker supports localization and accessibility and has better default accessibility than `Picker`.

MultiPicker supports string initializers as well as custom label views.

MultiPicker has a few additions and deviations from `Picker`:

- Supports putting the selection indicator (checkmark) on either the leading or trailing side of options via the `selectionIndicatorPosition(_:)` modifier.

- Currently only supports inline and navigationLink style pickers.

- The picker style is set using the `mpPickerStyle(_:)` instead of `pickerStyle(_:)` modifier.

- Views are tagged using the `mpTag(_:)` modifier instead of `tag(_:)`

- The pushed picker list is inset grouped instead of grouped because I think that looks nicer.

## Usage

Usage of `MultiPicker` is very similar to `Picker`:

```swift

struct MyView: View {

    @State private var selection: Set = []

    @State private var options: [Model]

    var body: some View {

        Form {

            MultiPicker("Choose something", selection: $selection) {

                ForEach(options) { option in

                    ModelCell(model: option)

                        .mpTag(option)

                }

            }

            .mpPickerStyle(.navigationLink)

        }

    }

}

```

Check the [documentation](https://swiftpackageindex.com/toastersocks/MultiPicker/documentation/multipicker) for more in-depth usage.

## Installing

### Swift Package Manager

#### Via Xcode

- Select your `.xcproject` file

- Select the project under `PROJECT`

- Select `Swift Package`

- Tap the `+` sign

- Paste this repo's address `https://github.com/toastersocks/MultiPicker` into the text field and hit 'Next'

- Choose your version/branch on the next screen

- Choose your targets and hit 'Finish'