BracketRound
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.
<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.
- roundrequisIBracketRound
- Round payload containing id, title, matches array and optional side (winner/loser for double-elimination).
- indexrequisnumber
- Zero-based index of this round within the bracket. Used to compute isFinalRound.
- totalRoundsrequisnumber
- Total number of rounds in the bracket. Used together with index to flag the last round as the final.
- showRoundTitlebooleantrue
- Toggles the round title <h3> heading above the match list.
- showScoresbooleantrue
- Forwarded to OrigamBracketMatch to toggle the score column.
- showSeedbooleanfalse
- Forwarded to OrigamBracketMatch to toggle the seed prefix.
- interactivebooleantrue
- Forwarded to OrigamBracketMatch to toggle match-card interactivity.
- Intent color forwarded to OrigamBracketMatch cards.
- idstring
- classstring | Array<string> | object
- stylestring | Array<string> | object | StyleValue
- tagstring'div'
- HTML element rendered as the round container root.
- Layout direction. horizontal = column of matches (single-elimination); vertical = row of matches.
- fontSizeTFontSize
- fontWeightTFontWeight
- letterSpacingTLetterSpacing
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-clickIBracketMatch, MouseEvent
- Bubbled from OrigamBracketMatch when the match card is clicked (not inside a competitor row).
- @competitor-clickIBracketCompetitor, IBracketMatch, 'A' | 'B', MouseEvent | KeyboardEvent
- Bubbled from OrigamBracketMatch when a competitor row is clicked.
- @winner-clickIBracketCompetitor, 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
Interactions clavier
| Touche | Action |
|---|---|
| Tab | Moves 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
Écosystème
Famille
Composants du même dossier qui partagent les conventions et se composent souvent ensemble.