Plugin.PickerViews 1.0.0

Plugin.PickerViews

A small set of .NET MAUI picker controls:

Targets net10.0 for Android, iOS, and Mac Catalyst (and Windows on Windows hosts). Material 3 and live light/dark theming are supported.

Install

dotnet add package Plugin.PickerViews

Setup

Register the plugin in MauiProgram.cs:

using Plugin.PickerViews;

builder
    .UseMauiApp<App>()
    .UsePickerViews();          // Material 3 on by default; pass useMaterial3: false to opt out

Material 3 on Android must be applied before base.OnCreate, so add one line to your Android MainActivity:

protected override void OnCreate(Bundle? savedInstanceState)
{
    this.ApplyPickerViewsTheme();   // no-op when Material 3 is disabled
    base.OnCreate(savedInstanceState);
}

DateTimePicker

A self-contained view. It does not hide itself — it raises Dismissed so the host decides how it was presented (overlay, popup, modal, …).

<pv:DateTimePicker x:Name="Picker"
                   IsEditable="True"
                   Accepted="OnAccepted"
                   Dismissed="OnDismissed" />

private void OnAccepted(object? sender, DateTimeSelectedEventArgs e)
{
    (DateTime start, DateTime? end) = e.SelectedRange;   // end is null for a single day
}

private void OnDismissed(object? sender, DateTimePickerDismissedEventArgs e)
    => Overlay.IsVisible = false;                        // host owns presentation

Interaction

• Drop-down year selector (1900–2200) and ‹ › month arrows.
• Tap a day to set the start (an opaque circle marks it).
• Long-press another day to set the range end — the span is coloured and may cross months/years.
• 24-hour time via ▲/▼ arrows, or type it directly when IsEditable is true.

Bindable properties

Events: Accepted (DateTimeSelectedEventArgs — SelectedDateTime, EndDateTime, SelectedRange tuple), Cancelled, Dismissed.

WritablePickerView

Inherits Picker (so ItemsSource, SelectedItem, SelectedIndex, Title all work). Tapping the field opens a search/add popup.

<pv:WritablePickerView Title="Choose or add a fruit"
                       ItemsSource="{Binding Fruit}"
                       SelectedIndexChanged="OnSelectionChanged"
                       ItemAdded="OnItemAdded" />

• Typing filters the list live (the magnifier turns blue).
• Pressing return adds the text, inserting it alphabetically, selects it, and closes.
• Picking a row selects it and closes.

Events: ItemAdded(string), SearchRequested(string), plus the inherited SelectedIndexChanged.

ImagePickerView

Inherits Picker. Items are ImagePickerItems.

Picker.ItemsSource = new ObservableCollection<ImagePickerItem>
{
    ImagePickerItem.FromUrl("https://example.com/tile.png", "From a URL"),   // lazy-loaded with a spinner
    ImagePickerItem.FromResource("dotnet_bot.png", "From a resource"),
    ImagePickerItem.FromStream(() => new MemoryStream(bytes), "From a stream"),
    ImagePickerItem.TextOnly("No image"),                                     // text left-aligns
};

The closed field shows the selected item's text; the popup shows image + text rows. SelectedItem returns the chosen ImagePickerItem.

Theming

• Material 3 — enabled by default via UsePickerViews() + ApplyPickerViewsTheme() (Android). Pass useMaterial3: false to keep the platform default.
• Light / dark — all custom surfaces (cards, text, borders, dividers, image placeholders) use AppThemeBinding, so they follow the system theme and switch live.

License

DILLIGAF © 2026 Paul F. Johnson.