# Picker

**Path:** Components/Popover

[Back to Documentation Index](http://rubicblazor.skyconis.com/docs.md)

---

Picker

 RbPicker documents the shared service-driven picker flows built on top of RbDialogService .
 These examples cover date, time, list, text, and numeric picking scenarios.

 Date Picker

 You can open the shared picker layout via RbDialogService.ShowDatePickerAsync(...) .
 This example mirrors the Date picker flow (basic and constrained) with callback-based value updates.
 For optional values, pass AllowClear: true to show the middle clear action and submit null .

 Show code

 Date Picker

 Pick a Date

 With Min/Max

 Allow Clear

 Selected Date

 Date: - 

 Time Picker

 You can open time selection with ShowTimePickerAsync(...) and ShowTimeOnlyPickerAsync(...) .
 This example covers both TimeSpan and TimeOnly overloads.

 Show code

 Time Picker

 TimeSpan (12h)

 TimeSpan (24h)

 TimeOnly + Clear

 Allowed 00 / 30

 15 / 30 / 45 + Range

 Selected Time

 TimeSpan: 09:30 

 TimeOnly: - 

 Allowed 00 / 30: 10:30 

 15 / 30 / 45 + Range: 13:30 

 List Picker

 You can open list selection with ShowListPickerAsync(...) using the shared picker layout.
 This example covers auto-commit, confirm flow, and searchable list options.

 Show code

 List Picker

 Blood Type (Auto + Clear)

 Language (Confirm)

 Country (Search)

 Selected Values

 Blood Type: - 

 Language: - 

 Country: - 

 List Picker Multi

 You can open multi selection with ShowListPickerMultiAsync(...) using the shared picker layout.
 This example covers searchable multi-select and changed-value callback flow.

 Show code

 List Picker Multi

 Languages (Multi)

 Selected Values

 Languages: English, Turkish 

 Text Picker

 You can open text input with ShowTextPickerAsync(...) using the shared picker layout.
 This example covers regular text and password input options.

 Show code

 Text Picker

 Enter Name (Clearable)

 Enter Password

 Selected Values

 Name: - 

 Password: - 

 TextArea Picker

 You can open multiline text input with ShowTextAreaPickerAsync(...) using the shared picker layout.
 This example covers notes and comment scenarios.

 Show code

 TextArea Picker

 Enter Notes (Clearable)

 Add Comment

 Selected Values

 Notes: - 

 Comment: - 

 Numeric Picker

 You can open numeric input with ShowNumericPickerAsync<T>(...) using the shared picker layout.
 This example covers integer and decimal scenarios.

 Show code

 Numeric Input Picker

 Enter Age

 Enter Weight (Clearable)

 Enter Quantity

 Selected Values

 Age: 0 

 Weight: - kg 

 Quantity: - 

 RTL Support

 Shared picker dialogs can be opened from a local RTL container. Date flow can also receive a matching culture for RTL calendar rendering.

 Show code

 تاريخ الزيارة 

 الحالة 

 اسم المسؤول 

 التاريخ: 19 أغسطس 2026 

 الحالة: - 

 الاسم: - 

 API

 ShowDatePickerAsync

 Opens a date picker for DateTime or DateOnly values, with optional clear support on nullable overloads.

 Parameters

 string Title 

 Dialog title shown at the top of the picker.

 DateTime? / DateTime / DateOnly? / DateOnly Value 

 Current selected value passed into the picker.

 Action<...> ValueChanged 

 Callback invoked when the picked value changes.

 DateTime? / DateOnly? MinDate = null

 Optional lower bound for selectable dates.

 DateTime? / DateOnly? MaxDate = null

 Optional upper bound for selectable dates.

 int FixYear = 0

 Locks the year part when non-zero.

 int FixMonth = 0

 Locks the month part when non-zero.

 int FixDay = 0

 Locks the day part when non-zero.

 CultureInfo Culture = null

 Optional culture used for date formatting.

 string CancelText = null

 Optional cancel button text.

 string OkText = null

 Optional confirm button text.

 bool AllowClear = false

 Nullable overload only. Enables clearing the value to null.

 Return

 Task<bool> 

 Returns true when the user confirms a changed value; otherwise false.

 ShowTimePickerAsync / ShowTimeOnlyPickerAsync

 Opens a time picker for TimeSpan or TimeOnly values, with optional minute constraints and clear support on nullable overloads.

 Parameters

 string Title 

 Dialog title shown at the top of the picker.

 TimeSpan? / TimeSpan / TimeOnly? / TimeOnly Value 

 Current selected time value.

 Action<...> ValueChanged 

 Callback invoked when the picked time changes.

 bool Use24 = true

 Uses 24-hour display when true.

 CultureInfo Culture = null

 Optional culture used for time formatting.

 IEnumerable<int> AllowedMinutes = null

 Optional minute whitelist such as 0, 15, 30, 45.

 TimeSpan? MinTime = null

 Optional lower selectable time bound.

 TimeSpan? MaxTime = null

 Optional upper selectable time bound.

 string CancelText = null

 Optional cancel button text.

 string OkText = null

 Optional confirm button text.

 bool AllowClear = false

 Nullable overload only. Enables clearing the value to null.

 Return

 Task<bool> 

 Returns true when the user confirms a changed value; otherwise false.

 ShowListPickerAsync<TKey>

 Opens a single-select list picker with optional auto-commit, search, and clear behavior.

 Parameters

 string Title 

 Dialog title shown at the top of the picker.

 Dictionary<TKey, string> Items 

 Key-text pairs displayed in the list.

 TKey Value = default

 Current selected key.

 Action<TKey> ValueChanged = null

 Callback invoked when the selected key changes.

 bool AutoCommit = true

 Submits immediately after selection when true.

 bool Searchable = false

 Enables built-in search UI.

 string SearchPlaceholder = null

 Optional search box placeholder text.

 string NoResultsText = null

 Optional empty-result message.

 string CancelText = null

 Optional cancel button text.

 string OkText = null

 Optional confirm button text.

 bool AllowClear = false

 Enables clearing the selected key.

 Return

 Task<bool> 

 Returns true when the selected value changed and was confirmed.

 ShowListPickerMultiAsync<TKey>

 Opens a multi-select list picker with optional search and clear behavior.

 Parameters

 string Title 

 Dialog title shown at the top of the picker.

 Dictionary<TKey, string> Items 

 Key-text pairs displayed in the list.

 IEnumerable<TKey> Value = null

 Current selected keys.

 Action<IEnumerable<TKey>> ValueChanged = null

 Callback invoked when the confirmed selection changes.

 bool Searchable = false

 Enables built-in search UI.

 string SearchPlaceholder = null

 Optional search box placeholder text.

 string NoResultsText = null

 Optional empty-result message.

 string CancelText = null

 Optional cancel button text.

 string OkText = null

 Optional confirm button text.

 bool AllowClear = false

 Enables clearing all selections.

 Return

 Task<bool> 

 Returns true when the confirmed selection changed.

 ShowTextPickerAsync / ShowTextAreaPickerAsync

 Opens single-line or multi-line text input pickers with optional formatting and clear behavior.

 Parameters

 string Title 

 Dialog title shown at the top of the picker.

 string Value = null

 Current text value.

 Action<string> ValueChanged = null

 Callback invoked when the text changes.

 int? MaxLength = null

 Optional maximum character count.

 string Placeholder = null

 Optional input placeholder text.

 bool Uppercase = false

 Forces uppercase input.

 bool Lowercase = false

 Forces lowercase input.

 bool NumericOnly = false

 Text picker only. Restricts input to numeric characters.

 bool Password = false

 Text picker only. Masks entered characters.

 string Mask = null

 Text picker only. Applies an input mask.

 string MaskPlaceHolder = _

 Text picker only. Placeholder character used by the mask.

 string CancelText = null

 Optional cancel button text.

 string OkText = null

 Optional confirm button text.

 bool AllowClear = false

 Enables clearing the current value.

 Return

 Task<bool> 

 Returns true when the confirmed text value changed.

 ShowNumericPickerAsync<TValue>

 Opens a numeric picker for nullable or non-nullable struct values.

 Parameters

 string Title 

 Dialog title shown at the top of the picker.

 TValue? / TValue Value 

 Current numeric value.

 Action<TValue?> / Action<TValue> ValueChanged = null

 Callback invoked when the value changes.

 TValue? MinValue = null

 Optional minimum numeric value.

 TValue? MaxValue = null

 Optional maximum numeric value.

 int Decimals = 2

 Number of decimal places shown by the picker.

 bool HideThousandsSeparator = false

 Hides thousands separators when true.

 string Placeholder = null

 Optional input placeholder text.

 CultureInfo Culture = null

 Optional culture used for numeric formatting.

 string CancelText = null

 Optional cancel button text.

 string OkText = null

 Optional confirm button text.

 bool AllowClear = false

 Nullable overload only. Enables clearing the value to null.

 Return

 Task<bool> 

 Returns true when the confirmed numeric value changed.

 ✕

 Contents
