BracketCompetitor

Data Display
stable

A single competitor row inside a bracket match card, showing seed, avatar, name, advantage badge, forfeit indicator and score.

Preview

Rendering the live preview…

default

Rendering the live preview…

winner

Rendering the live preview…

loser

Structure

Anatomy

Visual breakdown of the component's internal structure with BEM class call-outs.

Anatomy of OrigamBracketCompetitorSchematic of the BracketCompetitor row with 5 numbered parts. seed avatar Team Name +2 3 1 2 3 4 5 6
Anatomy of <origam-bracket-competitor> — 6 internal parts: root row, seed, avatar, name, advantage badge and score.
1.origam-bracket-competitor
Root element. Flex row with gap. role="button" and tabindex when interactive=true.
2.origam-bracket-competitor__seed
Seed number prefix. Visible only when showSeed=true and competitor.seed != null.
3.origam-bracket-competitor__avatar
Competitor avatar image. Visible only when competitor.avatar is set.
4.origam-bracket-competitor__name
Competitor name. flex: 1 auto with overflow ellipsis. Shows "TBD" when competitor is null.
5.origam-bracket-competitor__advantage
Advantage badge (+N rounds head start). Visible only when advantageRounds > 0.
6.origam-bracket-competitor__score
Score cell. Right-aligned. Visible only when showScore=true. Shows "—" when score is undefined.

API

Props

All props accepted by this component, with their type, default value and description.

competitor
required
IBracketCompetitor | null
Competitor data payload. null renders a "TBD" placeholder when the participant is not yet determined.
score
number | string
Score for this competitor. Accepts a number or a string for non-numeric markers. Shows "—" when undefined.
isWinner
boolean
false
Applies the --winner modifier: bolder text and intent-tinted background to highlight the winning side.
isLoser
boolean
false
Applies the --loser modifier: reduced opacity to de-emphasize the losing side after a completed match.
showScore
boolean
true
Toggles visibility of the score column.
showSeed
boolean
false
Toggles visibility of the seed number prefix.
interactive
boolean
true
When true: cursor:pointer, hover background, role="button", tabindex, keyboard support (Enter/Space emits click).
advantageRounds
number
Head-start rounds carried into the match. When > 0 a +N badge is rendered next to the name.
forfeit
boolean
false
Marks this competitor as forfeited: name is struck through and a "forfeit" tag is shown.
id
string
class
string | Array<string> | object
style
string | Array<string> | object | StyleValue
tag
string
'div'
HTML element rendered as the competitor row root.
color
Foreground text/icon color applied to the row.
bgColor
Background color of the row.
hover
boolean | IStateEffectConfig
hoverClass
string
active
boolean | IStateEffectConfig
activeClass
string
rounded
boolean | number | string | TRounded | null | undefined
roundedTopRight
boolean | number | string
roundedTopLeft
boolean | number | string
roundedBottomLeft
boolean | number | string
roundedBottomRight
boolean | number | string
roundedStartStart
boolean | number | string
roundedStartEnd
boolean | number | string
roundedEndStart
boolean | number | string
roundedEndEnd
boolean | number | string
elevation
TElevation
border
boolean | number | string | TDirectionBoth | Array<TDirectionBoth>
borderTop
boolean | number | string
borderLeft
boolean | number | string
borderBottom
boolean | number | string
borderRight
boolean | number | string
borderBlock
boolean | number | string
borderInline
boolean | number | string
borderInlineStart
boolean | number | string
borderInlineEnd
boolean | number | string
borderBlockStart
boolean | number | string
borderBlockEnd
boolean | number | string
borderColor
string
borderStyle
string
borderTopColor
TColor
borderRightColor
TColor
borderBottomColor
TColor
borderLeftColor
TColor
borderInlineStartColor
TColor
borderInlineEndColor
TColor
borderBlockStartColor
TColor
borderBlockEndColor
TColor
density
Controls row height and padding. compact: 28px, default: 36px, comfortable: 44px.
height
number | string
maxHeight
number | string
maxWidth
number | string
minHeight
number | string
minWidth
number | string
width
number | string
padding
boolean | number | string
paddingTop
boolean | number | string
paddingLeft
boolean | number | string
paddingBottom
boolean | number | string
paddingRight
boolean | number | string
paddingBlock
boolean | number | string
paddingInline
boolean | number | string
paddingInlineStart
boolean | number | string
paddingInlineEnd
boolean | number | string
paddingBlockStart
boolean | number | string
paddingBlockEnd
boolean | number | string
margin
boolean | number | string
marginTop
boolean | number | string
marginLeft
boolean | number | string
marginBottom
boolean | number | string
marginRight
boolean | number | string
marginBlock
boolean | number | string
marginInline
boolean | number | string
marginInlineStart
boolean | number | string
marginInlineEnd
boolean | number | string
marginBlockStart
boolean | number | string
marginBlockEnd
boolean | number | string
fontSize
TFontSize
fontWeight
TFontWeight

API

Emits

Events emitted by this component.

@click
MouseEvent | KeyboardEvent
Fired on click (interactive=true) or keyboard Enter/Space. Not fired when interactive=false.
@update:active
any
@update:hover
boolean

API

Exposed members

Properties and methods accessible via template ref (defineExpose). Use them for programmatic control.

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

Customisation

CSS variables

CSS custom properties exposed by this component. Override them to customise the component without losing theme compatibility.

Minimum row height. compact: 28px, comfortable: 44px.
Vertical padding. compact: 2px, comfortable: 8px.
Horizontal padding of the row.
Gap between seed, avatar, name, advantage and score.
Row font size. compact: 0.8125rem.
Row text color.
Row background color.
Background tint applied when isWinner=true.
Minimum width of the score column.
Width and height of the competitor avatar.

Inclusion

Accessibility

ARIA roles, keyboard navigation and focus management. Sourced from the real component template.

ARIA roles

button

Keyboard interactions

Keyboard interactions
KeyAction
Enter / SpaceEmits the click event when interactive=true.
TabMoves focus to the next interactive element.

Notes

  • Dynamic aria-label is computed: "name, score N, winner" — screen readers announce the full match context.
  • When competitor is null, aria-label becomes "To be determined".
  • The advantage badge has its own aria-label: "N-round head start".
  • focus-visible outline: 2px solid primary color with -2px offset when interactive=true.

Interactive

Playground

Edit props live and see the component update in real time. The generated code snippet updates as you change values.

This is an internal sub-part: it is injected by its parent component and cannot render on its own. See the parent component page for a live example.

Rendering the live preview…

Usage

Examples

Ready-to-paste code snippets for your templates.

Standalone competitor row

vue

TBD placeholder

vue

With advantage badge

vue

Ecosystem

Family

Components from the same folder that share conventions and often compose together.