Interactive previews iPhone

Range Photo Picker

Presents a Photos picker that selects a collection of PhotosPickerItem, constrained to a range of selection counts.

Range Photo Picker - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview

Platform Compatibility

iOS 27.3+ iPadOS 27.3+ macOS 27.3+ visionOS 27.3+

Tags

SwiftUI Code

Docs
@State private var selectedPhotos: [PhotosPickerItem] = []

var body: some View {
    PhotosPicker(
        "FooBar",
        selection: $selectedPhotos,
        selectionRange: 2 ... 5
    )
}

Found an issue or have a suggestion?

Created: November 17, 2026Updated: November 17, 2026

More PhotosPicker Components

View all
Photos Picker - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview
initializer

Photos Picker

Creates a picker with a title key and selection, and optionally configures the types of items to show and item encoding behavior.

Photos Picker Title - iPadOS - Landscape - Liquid Glass - Light Mode - Preview
modifier

Photos Picker Title

Overrides the title of the Photos picker. The title is not visible on small screens, like the iPhone.

Photos Picker Prompt - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview
modifier

Photos Picker Prompt

Sets the prompt of the Photos picker.

On Secondary Photos Picker Action - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview
modifier

On Secondary Photos Picker Action

Sets the secondary action handler for the Photos picker.

On Primary Photos Picker Action - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview
modifier

On Primary Photos Picker Action

Sets the primary action handler for the Photos picker.

Container Photo Picker - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview
modifier

Container Photo Picker

Limits the Photos picker to only show items in the specified container. In this case, to the user-created album "CustomAlbum".

Custom Photo Picker Buttons - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview
modifier

Custom Photo Picker Buttons

Sets the primary and secondary button types of the Photos picker.

Disable Automatic Photos Picker Dismissal - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview
modifier

Disable Automatic Photos Picker Dismissal

Prevents the Photos picker from dismissing automatically. Without this modifier, the Photos picker would automatically dismiss when an image is tapped.

Explore Other Components

Browse all
Hide Sidebar Toggle - iOS on iPhone Duo - Landscape - Fully Open - Liquid Glass - Light Mode - Preview
modifier

Hide Sidebar Toggle

Removes the sidebar toggle toolbar item a NavigationSplitView adds by default.

Disabled Toolbar Vertical Behavior - iOS on iPhone Duo - Landscape - Fully Open - Liquid Glass - Light Mode - Preview
modifier

Disabled Toolbar Vertical Behavior

Disables the vertical bar.

Search Tab Role - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview
initializer

Search Tab Role

On Liquid Glass, this tab is placed in its own group. In left-to-right (LTR) layouts, it will always appear on the right side of the TabView.

ControlGroup - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview
initializer

ControlGroup

Creates a new ControlGroup with the specified children

ShareLink - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview
initializer

ShareLink

A view that controls a sharing presentation

Scroll Gesture Axis Lock - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview
modifier

Scroll Gesture Axis Lock

Sets whether scrollable views within this view lock each scroll gesture to its predominant axis. On macOS, scroll gestures lock to their predominant axis by default. On iOS, iPadOS, Mac Catalyst, visionOS, and watchOS, scroll gestures move along both axes at once.

UIKit Text Colors - iOS on iPhone - Portrait - Flat Design - Light Mode - Preview
type

UIKit Text Colors

The UIKit text colors that are also used in other components, such as the TextField

Tab View Side Bar Header - iPadOS - Landscape - Liquid Glass - Light Mode - Preview
modifier

Tab View Side Bar Header

Adds a custom header to the sidebar of a tab view.