BracketRound

Data Display
stable

Renders a single round column (horizontal mode) or row (vertical mode) of a tournament bracket, containing its OrigamBracketMatch cards.

Structure

Anatomie

Décomposition visuelle de la structure interne du composant avec les appels de classes BEM.

Anatomy of OrigamBracketRoundSchematic of the BracketRound column with 3 numbered parts. SEMI-FINALS Match card 1 Match card 2 1 2 3
Anatomy of <origam-bracket-round> — 3 parts: root column, round title heading and match list.
1.origam-bracket-round
Root flex column container. role="group" with aria-labelledby pointing to the title. Direction modifier switches to row for vertical mode.
2.origam-bracket-round__title
Round title

. Visible only when showRoundTitle=true. Gets a computed id for aria-labelledby.

3.origam-bracket-round__matches
Flex column container for match cards. justify-content: space-around distributes matches evenly. Gap driven by --origam-bracket-round---match-gap.

API

Props

Toutes les props acceptées par ce composant, avec leur type, valeur par défaut et description.

round
requis
IBracketRound
Round payload containing id, title, matches array and optional side (winner/loser for double-elimination).
index
requis
number
Zero-based index of this round within the bracket. Used to compute isFinalRound.
totalRounds
requis
number
Total number of rounds in the bracket. Used together with index to flag the last round as the final.
showRoundTitle
boolean
true
Toggles the round title <h3> heading above the match list.
showScores
boolean
true
Forwarded to OrigamBracketMatch to toggle the score column.
showSeed
boolean
false
Forwarded to OrigamBracketMatch to toggle the seed prefix.
interactive
boolean
true
Forwarded to OrigamBracketMatch to toggle match-card interactivity.
color
'primary'
Intent color forwarded to OrigamBracketMatch cards.
id
string
class
string | Array<string> | object
style
string | Array<string> | object | StyleValue
tag
string
'div'
HTML element rendered as the round container root.
direction
'horizontal'
Layout direction. horizontal = column of matches (single-elimination); vertical = row of matches.
fontSize
TFontSize
fontWeight
TFontWeight
letterSpacing
TLetterSpacing

API

Slots

Emplacements de contenu exposés par ce composant.

#round-title
Override the round title content. Receives the round data and its index.
#match
Override the rendering of each match. Receives match data, round and isFinal flag.
#competitor

API

Emits

Événements émis par ce composant.

@match-click
IBracketMatch, MouseEvent
Bubbled from OrigamBracketMatch when the match card is clicked (not inside a competitor row).
@competitor-click
IBracketCompetitor, IBracketMatch, 'A' | 'B', MouseEvent | KeyboardEvent
Bubbled from OrigamBracketMatch when a competitor row is clicked.
@winner-click
IBracketCompetitor, IBracketMatch, MouseEvent | KeyboardEvent
Bubbled from OrigamBracketMatch when the winner competitor row is clicked.

API

Membres exposés

Propriétés et méthodes accessibles via ref template (defineExpose). Utilisés pour le contrôle programmatique.

<T extends object>(props: T, exclude?: string[]) => Partial<T>
Utility to forward a filtered subset of props to a child component.

Personnalisation

Variables CSS

Propriétés CSS personnalisées exposées par ce composant. Surchargez-les pour personnaliser sans perdre la compatibilité avec le thème.

Bottom margin below the round title.
Font size of the round title.
Font weight of the round title.
Letter spacing of the round title.
Text transform of the round title. Default uppercase.
Gap between match cards in the round.

Inclusion

Accessibilité

Rôles ARIA, navigation clavier et gestion du focus. Sourcé depuis le template réel du composant.

Rôles ARIA

group

Interactions clavier

Interactions clavier
ToucheAction
TabMoves focus through each match card within the round.

Notes

  • The round container has aria-labelledby pointing to the title element id when showRoundTitle=true, giving screen readers the round name context.
  • The final round (last in the bracket) receives the --final modifier class. Consumers can use this for additional ARIA live-region announcements.

Interactif

Playground

Modifiez les props en direct et observez le composant se mettre à jour. Le snippet de code généré suit vos changements.

Sous-partie interne : elle est injectée par son composant parent et ne peut pas se rendre seule. Voir la fiche du composant parent pour un exemple vivant.

Rendu de l’aperçu en cours…

Usage

Exemples

Extraits de code prêts à coller dans vos templates.

Standalone round

vue

Écosystème

Famille

Composants du même dossier qui partagent les conventions et se composent souvent ensemble.