TRadio<T> class
A radio button input with validation and theming support.
TRadio provides a customizable radio button with:
- Optional label text
- Validation support
- Custom colors and sizes
- Disabled state
- Value binding with ValueNotifier
Basic Usage
TRadio<String>(
value: 'option1',
groupValue: selectedValue,
label: 'Option 1',
onValueChanged: (value) => print('Selected: $value'),
)
See also:
- TRadioGroup for multiple radio buttons
- TCheckbox for multiple selection
- Inheritance
- Mixed-in types
- Available extensions
Constructors
-
TRadio({Key? key, required T radioValue, T? value, ValueNotifier<
T?> ? valueNotifier, ValueChanged<T?> ? onValueChanged, FocusNode? focusNode, String? label, bool isRequired = false, List<String? Function(T?)> ? rules, Duration? validationDebounce, bool autoFocus = false, bool disabled = false, Color? color, TInputSize? size = TInputSize.md}) -
Creates a radio button input.
const
Properties
- autoFocus → bool
-
Whether the radio button should auto-focus.
final
- color → Color?
-
Custom color for the radio button.
final
- disabled → bool
-
Whether the radio button is disabled.
final
- focusNode → FocusNode?
-
Custom focus node.
final
- hashCode → int
-
The hash code for this object.
no setterinherited
- isRequired → bool
-
Whether this radio button is required.
final
- key → Key?
-
Controls how one widget replaces another widget in the tree.
finalinherited
- label → String?
-
Label text displayed next to the radio button.
final
-
onValueChanged
→ ValueChanged<
T?> ? -
Callback fired when the value changes.
final
- radioValue → T
-
The value this radio button represents.
final
-
rules
→ List<
String? Function(T?)> ? -
Validation rules for the radio value.
final
- runtimeType → Type
-
A representation of the runtime type of the object.
no setterinherited
- size → TInputSize?
-
The size of the radio button.
final
- validationDebounce → Duration?
-
Debounce duration for validation.
final
- value → T?
-
The currently selected value in the group.
final
-
valueNotifier
→ ValueNotifier<
T?> ? -
A ValueNotifier for two-way binding.
final
Methods
-
box(
{double minW = 0.0, double minH = 0.0, double maxW = double.infinity, double maxH = double.infinity}) → Widget -
Available on Widget, provided by the WidgetX extension
Wraps this widget in a ConstrainedBox to apply layout constraints. -
center(
{bool when = true}) → Widget -
Available on Widget, provided by the WidgetX extension
Wraps this widget in a Center widget. -
createElement(
) → StatefulElement -
Creates a StatefulElement to manage this widget's location in the tree.
inherited
-
createState(
) → State< TRadio< 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.
inherited
-
expanded(
{int flex = 1}) → Widget -
Available on Widget, provided by the WidgetX extension
Wraps this widget in an Expanded widget. -
noSuchMethod(
Invocation invocation) → dynamic -
Invoked when a nonexistent method or property is accessed.
inherited
-
padding(
[double left = 0.0, double top = 0.0, double right = 0.0, double bottom = 0.0]) → Widget -
Available on Widget, provided by the WidgetX extension
Wraps this widget in a Padding with flexible edge control. -
paddingSymmetric(
{double h = 0.0, double v = 0.0}) → Widget -
Available on Widget, provided by the WidgetX extension
Wraps this widget in a Padding with symmetric horizontal and vertical spacing. -
size(
{double? w, double? h}) → Widget -
Available on Widget, provided by the WidgetX extension
Wraps this widget in a SizedBox to apply fixed width and/or height. -
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
-
validateValue(
T? value) → List< String> -
Validates the given value against the rules.
inherited
-
visible(
bool visible, {bool maintainState = false}) → Widget -
Available on Widget, provided by the WidgetX extension
Wraps this widget in a Visibility widget. -
when(
bool condition) → Widget -
Available on Widget, provided by the WidgetX extension
Returns this widget ifconditionis true, otherwise returns SizedBox.shrink(). Usage: Text('Hello').when(isVisible)
Operators
-
operator ==(
Object other) → bool -
The equality operator.
inherited