BeuiSelect class
A dropdown select whose panel unfolds out of the trigger — the Flutter port
of beUI's select (the gooey/accordion variant), built on BeuiOverlay and
anchored to the trigger with a LayerLink + CompositedTransformFollower,
the same overlay pattern as BeuiTooltip.
Open choreography: one source-derived unfold progress controls the full-size panel's near-edge clip, its 8px pull-away gap and corners, and the chevron. Rows reveal together from y=-4 in 120ms; they fade out in 80ms on close, without blur or stagger. The trigger remains laid out at full size; only paint/transform properties animate. The panel flips above the trigger when there isn't room below.
Controlled or uncontrolled: pass value + onChanged to control it, or omit value and seed defaultValue for internal state. Keyboard: Enter / Space / ArrowDown open it; Up/Down move the highlight; Enter commits; Esc closes. Reduced motion keeps static panel geometry with a short opacity fade and no row transform.
- Inheritance
-
- Object
- DiagnosticableTree
- Widget
- StatefulWidget
- BeuiSelect
Constructors
-
BeuiSelect({required List<
BeuiSelectOption> options, String? value, String? defaultValue, ValueChanged<String> ? onChanged, bool? open, bool defaultOpen = false, ValueChanged<bool> ? onOpenChange, String placeholder = 'Select', bool enabled = true, BeuiSelectVariant variant = BeuiSelectVariant.standard, Key? key}) -
Creates a select over
options.const
Properties
- defaultOpen → bool
-
Initial visibility for an uncontrolled select.
final
- defaultValue → String?
-
Uncontrolled initial value (used only when value is null).
final
- enabled → bool
-
Whether the trigger is interactive.
final
- hashCode → int
-
The hash code for this object.
no setterinherited
- key → Key?
-
Controls how one widget replaces another widget in the tree.
finalinherited
-
onChanged
→ ValueChanged<
String> ? -
Called with the chosen option's value.
final
-
onOpenChange
→ ValueChanged<
bool> ? -
Called whenever an interaction requests a visibility change.
final
- open → bool?
-
Controlled panel visibility. When null, BeuiSelect owns open state.
final
-
options
→ List<
BeuiSelectOption> -
The options to choose from.
final
- placeholder → String
-
Shown in the trigger until a value is selected.
final
- runtimeType → Type
-
A representation of the runtime type of the object.
no setterinherited
- value → String?
-
Controlled selected value. When null the select owns its state.
final
- variant → BeuiSelectVariant
-
The trigger style. Defaults to BeuiSelectVariant.standard.
final
Methods
-
createElement(
) → StatefulElement -
Creates a StatefulElement to manage this widget's location in the tree.
inherited
-
createState(
) → State< BeuiSelect> -
Creates the mutable state for this widget at a given location in the tree.
override
-
debugDescribeChildren(
) → List< DiagnosticsNode> -
Returns a list of DiagnosticsNode objects describing this node's
children.
inherited
-
debugFillProperties(
DiagnosticPropertiesBuilder properties) → void -
Add additional properties associated with the node.
inherited
-
noSuchMethod(
Invocation invocation) → dynamic -
Invoked when a nonexistent method or property is accessed.
inherited
-
toDiagnosticsNode(
{String? name, DiagnosticsTreeStyle? style}) → DiagnosticsNode -
Returns a debug representation of the object that is used by debugging
tools and by DiagnosticsNode.toStringDeep.
inherited
-
toString(
{DiagnosticLevel minLevel = DiagnosticLevel.info}) → String -
A string representation of this object.
inherited
-
toStringDeep(
{String prefixLineOne = '', String? prefixOtherLines, DiagnosticLevel minLevel = DiagnosticLevel.debug, int wrapWidth = 65}) → String -
Returns a string representation of this node and its descendants.
inherited
-
toStringShallow(
{String joiner = ', ', DiagnosticLevel minLevel = DiagnosticLevel.debug}) → String -
Returns a one-line detailed description of the object.
inherited
-
toStringShort(
) → String -
A short, textual description of this widget.
inherited
Operators
-
operator ==(
Object other) → bool -
The equality operator.
inherited