FSelectMenuTile<T> class
A tile that, when triggered, displays a list of options for the user to pick from.
A FSelectMenuTile is internally a FormField, therefore it can be used in a Form.
For desktop, a FSelectGroup is generally recommended over this.
See:
- https://forui.dev/docs/tile/select-menu-tile for working examples.
- FSelectTile for a single select tile.
- FSelectMenuTileStyle for customizing a select group's appearance.
- Inheritance
-
- Object
- DiagnosticableTree
- Widget
- StatefulWidget
- FormField<
Set< T> > - FSelectMenuTile
- Mixed-in types
Constructors
-
FSelectMenuTile({required FSelectGroupController<
T> groupController, required Widget title, FPopoverController? popoverController, FSelectMenuTileStyle? style, FTileDivider divider = FTileDivider.full, Alignment tileAnchor = Alignment.bottomRight, Offset shift(Size, FPortalTarget, FPortalFollower) = FPortalFollowerShift.flip, bool hideOnTapOutside = true, bool ignoreDirectionalPadding = true, bool autoHide = false, Widget? label, Widget? description, Widget errorBuilder(BuildContext, String) = _errorBuilder, String? semanticLabel, bool autofocus = false, FocusNode? focusNode, ValueChanged<bool> ? onFocusChange, Widget? prefixIcon, Widget? subtitle, Widget? details, Widget? suffixIcon, FormFieldSetter<Set< ? onSaved, FormFieldValidator<T> >Set< ? validator, Set<T> >T> ? initialValue, String? forceErrorText, bool enabled = true, AutovalidateMode? autovalidateMode, String? restorationId, Key? key}) - Creates a FSelectMenuTile.
Properties
- autofocus → bool
-
True if the menu will be selected as the initial focus when no other node in its scope is currently focused.
final
- autoHide → bool
-
True if the menu should be automatically hidden after a menu option is selected. Defaults to false.
final
- autovalidateMode → AutovalidateMode
-
Used to enable/disable this form field auto validation and update its
error text.
finalinherited
-
builder
→ FormFieldBuilder<
Set< T> > -
Function that returns the widget representing this form field. It is
passed the form field state as input, containing the current value and
validation state of this field.
finalinherited
- description → Widget?
-
The description displayed below the group.
final
- details → Widget?
-
The details.
final
- divider → FTileDivider
-
The divider between select tiles. Defaults to FTileDivider.indented.
final
- enabled → bool
-
Whether the form is able to receive user input.
finalinherited
- errorBuilder → Widget Function(BuildContext, String)
-
The builder for errors displayed below the description. Defaults to displaying the error message.
final
- focusNode → FocusNode?
-
An optional focus node to use as the focus node for the menu.
final
- forceErrorText → String?
-
An optional property that forces the FormFieldState into an error state
by directly setting the FormFieldState.errorText property without
running the validator function.
finalinherited
-
groupController
→ FSelectGroupController<
T> -
The controller that controls the selected tiles.
final
- hashCode → int
-
The hash code for this object.
no setterinherited
- hideOnTapOutside → bool
-
True if the popover is hidden when tapped outside of it. Defaults to true.
final
- ignoreDirectionalPadding → bool
-
True if the menu should ignore the cross-axis padding of the anchor when aligning to it. Defaults to true.
final
-
initialValue
→ Set<
T> ? -
An optional value to initialize the form field to, or null otherwise.
finalinherited
- key → Key?
-
Controls how one widget replaces another widget in the tree.
finalinherited
- label → Widget?
-
The label displayed next to the select group.
final
-
The menu.
final
-
The anchor of the menu to which the tileAnchor is aligned to.
final
-
onFocusChange
→ ValueChanged<
bool> ? -
Handler called when the focus changes.
final
-
onSaved
→ FormFieldSetter<
Set< ?T> > -
An optional method to call with the final value when the form is saved via
FormState.save.
finalinherited
- popoverController → FPopoverController?
-
The controller that shows and hides the menu. It initially hides the menu.
final
- prefixIcon → Widget?
-
The prefix icon.
final
- restorationId → String?
-
Restoration ID to save and restore the state of the form field.
finalinherited
- runtimeType → Type
-
A representation of the runtime type of the object.
no setterinherited
- semanticLabel → String?
-
The menu's semantic label used by accessibility frameworks.
final
- shift → Offset Function(Size, FPortalTarget, FPortalFollower)
-
The shifting strategy used to shift a menu when it overflows out of the viewport. Defaults to
FPortalFollowerShift.flip.
final
- style → FSelectMenuTileStyle?
-
The style.
final
- subtitle → Widget?
-
The subtitle.
final
- suffixIcon → Widget?
-
The suffix icon. Defaults to
FAssets.icons.chevronsUpDown
.final - tileAnchor → Alignment
-
The anchor of the child to which the menuAnchor is aligned to.
final
- title → Widget
-
The title.
final
-
validator
→ FormFieldValidator<
Set< ?T> > -
An optional method that validates an input. Returns an error string to
display if the input is invalid, or null otherwise.
finalinherited
Methods
-
createElement(
) → StatefulElement -
Creates a StatefulElement to manage this widget's location in the tree.
inherited
-
createState(
) → FormFieldState< Set< T> > -
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.
override
-
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}) → 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