AnimatedTournamentBracket<T> class

A premium, highly customizable generic tournament bracket widget supporting any match model T.

Inheritance

Constructors

AnimatedTournamentBracket({Key? key, required List<List<T>> branch1Rounds, T? grandFinal, T? thirdPlaceMatch, required Widget itemBuilder(BuildContext context, T match), List<String>? roundTitles, Widget tabBuilder(BuildContext context, int index, bool isSelected)?, Widget tabBarBuilder(BuildContext context, double pageOffset, int activeRound, void onTabTap(int index))?, bool hasWinner(T match)?, String getWinnerName(T match)?, String getPlayer1Name(T match)?, String getPlayer2Name(T match)?, Color primaryColor = const Color(0xFF0066FF), Color secondaryColor = const Color(0xFF00E5FF), Color? backgroundColor = const Color(0xFF070B19), Gradient? backgroundGradient, bool useGradientBackground = true, Color surfaceColor = const Color(0xFF131A30), Color accentColor = const Color(0xFFFFB300), Color defaultLineColor = const Color(0x33FFFFFF), double connectorRadius = 8.0, double? cardWidth, double? cardHeight, double? horizontalGap, double verticalGap = 16.0, double topOffset = 25.0, double lineThickness = 2.0, double activeLineThickness = 3.0, double activeGlowWidth = 8.0, double activeGlowOpacity = 0.15, ConnectorStyle connectorStyle = ConnectorStyle.curved, ConnectorLineType lineType = ConnectorLineType.solid, double dashLength = 12.0, double dashGap = 8.0, double dashSpeedMultiplier = 1.0, String? searchHighlightQuery, bool pulseGlow = true, Duration pulseDuration = const Duration(seconds: 2), bool useLineGradients = true, Widget roundHeaderBuilder(BuildContext context, int roundIndex)?, Color? tabBarBorderColor, Color? tabBarBackgroundColor, double tabBarBorderRadius = 12.0, Decoration? tabBarIndicatorDecoration, double tabBarHeight = 42.0, BracketViewMode defaultViewMode = BracketViewMode.swipe, bool showViewModeToggle = true, MatchStatus getMatchStatus(T match)?, Color disputeColor = const Color(0xFFFF3366), double tabBarTopPadding = 12.0})
const

Properties

accentColor → Color
final
activeGlowOpacity → double
final
activeGlowWidth → double
final
activeLineThickness → double
final
backgroundColor → Color?
final
backgroundGradient → Gradient?
final
branch1Rounds → List<List<T>>
Rounds list for the first branch (Upper).
final
cardHeight → double?
final
cardWidth → double?
Optional custom layout parameters.
final
connectorRadius → double
The radius for connection line corners. Defaults to 8.0 (subtle).
final
connectorStyle → ConnectorStyle
final
dashGap → double
Gap between active dashes in flowing lines. Defaults to 8.0.
final
dashLength → double
Length of active dashes in flowing lines. Defaults to 12.0.
final
dashSpeedMultiplier → double
Speed multiplier for the flowing animation. Defaults to 1.0.
final
defaultLineColor → Color
final
defaultViewMode → BracketViewMode
Default view mode: swipe carousel or 2D Interactive Zoom & Pan
final
disputeColor → Color
Color used for disputed match connection lines
final
getMatchStatus → MatchStatus Function(T match)?
Optional callback to retrieve the status of a match
final
getPlayer1Name → String Function(T match)?
final
getPlayer2Name → String Function(T match)?
final
getWinnerName → String Function(T match)?
final
grandFinal → T?
The final championship match that connects the branch winners.
final
hashCode → int
The hash code for this object.
no setterinherited
hasWinner → bool Function(T match)?
Optional connection line highlighting callbacks.
final
horizontalGap → double?
final
itemBuilder → Widget Function(BuildContext context, T match)
Custom Card layout builder. EXTREMELY powerful for complete custom interfaces.
final
key → Key?
Controls how one widget replaces another widget in the tree.
finalinherited
lineThickness → double
Custom connection line styling properties.
final
lineType → ConnectorLineType
Style of connection lines (solid, flowing dashed pattern).
final
primaryColor → Color
Design system theme colors
final
pulseDuration → Duration
Duration/speed of the pulsing glow animation.
final
pulseGlow → bool
Whether to pulse/glow the active connection paths.
final
roundHeaderBuilder → Widget Function(BuildContext context, int roundIndex)?
Optional builder to draw headers directly above each round column in the canvas.
final
roundTitles → List<String>?
Optional custom round titles.
final
runtimeType → Type
A representation of the runtime type of the object.
no setterinherited
searchHighlightQuery → String?
Player or competitor name to trace and highlight gold.
final
secondaryColor → Color
final
showViewModeToggle → bool
Whether to show the floating action button to toggle view modes
final
surfaceColor → Color
final
tabBarBackgroundColor → Color?
final
tabBarBorderColor → Color?
Custom Tab Bar styling properties.
final
tabBarBorderRadius → double
final
tabBarBuilder → Widget Function(BuildContext context, double pageOffset, int activeRound, void onTabTap(int index))?
A builder callback to fully override and customize the entire Round Tab Bar. Receives:
final
tabBarHeight → double
final
tabBarIndicatorDecoration → Decoration?
final
tabBarTopPadding → double
Custom top padding above the tab bar. Defaults to 12.0.
final
tabBuilder → Widget Function(BuildContext context, int index, bool isSelected)?
Custom Tab item builder. Allows developers to fully customize the round tab labels!
final
thirdPlaceMatch → T?
Optional third-place match card
final
topOffset → double
final
useGradientBackground → bool
final
useLineGradients → bool
Whether to draw gradient connection lines from source to destination matches.
final
verticalGap → double
final

Methods

createElement() → StatefulElement
Creates a StatefulElement to manage this widget's location in the tree.
inherited
createState() → State<AnimatedTournamentBracket<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
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