VTextList class

A widget that displays a list of text items with optional separators.

VTextList renders a horizontal list of text items with customizable separators between them. Items are displayed in a Wrap widget that automatically handles text wrapping and line breaks when space is insufficient.

The widget is useful for displaying tags, breadcrumbs, filters, or any comma-separated style lists of text items.

Parameters:

  • items: Required list of text strings to display
  • separator: Optional separator between items. Can be:
    • null: No separator (default)
    • Widget: Custom widget to use as separator (e.g., Icon, Text, Divider)
    • String: Text string that will be converted to a Text widget

Example with string separator:

VTextList(
  items: ['Flutter', 'Dart', 'Firebase'],
  separator: ', ',
)
// Output: Flutter, Dart, Firebase

Example with widget separator:

VTextList(
  items: ['Tag1', 'Tag2', 'Tag3'],
  separator: const Icon(Icons.close, size: 14),
)

Example without separator:

VTextList(
  items: ['Item1', 'Item2', 'Item3'],
)

The widget returns an empty SizedBox if the items list is empty.

Inheritance

Constructors

VTextList({Key? key, required List<String> items, dynamic separator})
const

Properties

hashCode int
The hash code for this object.
no setterinherited
items List<String>
final
key Key?
Controls how one widget replaces another widget in the tree.
finalinherited
runtimeType Type
A representation of the runtime type of the object.
no setterinherited
separator → dynamic
final

Methods

build(BuildContext context) Widget
Describes the part of the user interface represented by this widget.
override
createElement() StatelessElement
Creates a StatelessElement to manage this widget's location in the tree.
inherited
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