Selection topic

Selection

Chips in a SheenChipRow, a SheenSegmentedControl, a SheenDateRangePicker (any first day of the week), a SheenRangeHistogram, choice lists and sheets, a SheenPullDownLink and a glass menu (showSheenMenu).

Classes

SheenChip

A filter or sort chip: a 36-point capsule. Selected, it is inverted (text-coloured fill); unselected, it is glass. It can lead with a glyph, end with one (trailingIcon) and show a menu chevron (menu).

SheenChipRow

A row of chips that scrolls sideways and never wraps, its edges fading into the page only where more chips wait.

SheenChoice<T>

One choice of a SheenChoiceList: its value, how it reads, and a short tag before it (a currency's code).

SheenChoiceList<T>

A list of choices with the current one ticked, as showSheenChoiceSheet shows it; usable on its own in a page.

SheenDateRangeCalendar

One month of a date-range picker: past days off, today in the accent, the range ends on prominent glass and the days between them on a band.

SheenDateRangePicker

A date-range picker: a month header with previous and next arrows over a SheenDateRangeCalendar, a sideways swipe to change the month, and the usual range logic (pick): the first tap starts a range, a later day ends it, an earlier one starts again.

SheenMenuItem<T>

One item of a showSheenMenu menu.

SheenPullDownLink

A pull-down link: a short label in the accent colour with a chevron, such as "USD ▾" next to a list of prices, that opens a choice (usually showSheenChoiceSheet). A 44-point target.

SheenRange

A range of values, from start to end, for SheenRangeHistogram.

SheenRangeHistogram

A range filter over a histogram, such as a price filter: bars show how the items spread over the values, and two knobs on their baseline pick a range; bars inside it are lit.

SheenSegment

One segment of a SheenSegmentedControl, with an optional count line under the label (for example "Visa-free" over "126").

SheenSegmentedControl

A segmented control on glass: 2 to 4 segments, the selected one on a lens that slides on the snappy spring.

Functions

showSheenChoiceSheet<T>(BuildContext context, {required String title, required List<SheenChoice<T>> choices, T? current, List<T> suggested = const [], String? suggestedLabel, String? allLabel, String? note, bool useRootNavigator = false}) → Future<T?>

Opens a sheet with a SheenChoiceList and returns the picked value, or null when the sheet is closed.

showSheenMenu<T>(BuildContext context, {required List<SheenMenuItem<T>> items, GlobalKey<State<StatefulWidget>>? anchorKey, Rect? anchorRect, double width = 250}) → Future<T?>

Opens a glass pull-down menu next to an anchor and returns the chosen item's value, or null when it is dismissed (a tap outside, Escape, the back gesture).