BracketMatch
A single match card inside a tournament bracket, showing two competitor rows with optional meta header (status, schedule, watch link) and score columns.
Structure
Anatomy
Visual breakdown of the component's internal structure with BEM class call-outs.
<origam-bracket-match> — 5 parts: root card, meta header, body, competitor rows (A / B) and divider.- 1.origam-bracket-match
- Root card element. Flex column with border, rounded corners and optional box-shadow. role="group".
- 2.origam-bracket-match__meta
- Meta header bar. Visible only when match.scheduledAt or a resolved status is present. Contains status badge, watch link and schedule time.
- 3.origam-bracket-match__row (side A)
- Competitor A row — an OrigamBracketCompetitor with isWinner/isLoser derived from match.winnerId.
- 4.origam-bracket-match__row (side B)
- Competitor B row — same as A but for the second participant.
- 5.origam-bracket-match__divider
- OrigamDivider separator between the two competitor rows.
API
Props
All props accepted by this component, with their type, default value and description.
- matchrequiredIBracketMatch
- Match payload containing competitorA, competitorB, scoreA, scoreB, winnerId, status, scheduledAt and advantage data.
- statusTBracketMatchStatus
- Overrides match.status. Accepted values: "pending", "live", "completed", "forfeited".
- tostring
- URL for the "Watch live" link shown when status is "live".
- isFinalbooleanfalse
- When true applies the --final visual treatment (elevated shadow, larger card, rounded corners).
- showScoresbooleantrue
- Forwarded to OrigamBracketCompetitor to toggle the score column.
- showSeedbooleanfalse
- Forwarded to OrigamBracketCompetitor to toggle the seed prefix.
- interactivebooleantrue
- When true the card and its competitor rows advertise interactivity (hover, cursor, role="button").
- idstring
- classstring | Array<string> | object
- stylestring | Array<string> | object | StyleValue
- tagstring'div'
- HTML element rendered as the match card root.
- Intent color forwarded to competitor rows. Drives the winner tint and the auto-contrast text color.
- bgColor
- Background color of the match card.
- hoverboolean | IStateEffectConfig
- hoverClassstring
- activeboolean | IStateEffectConfig
- activeClassstring
- Border-radius override for the match card.
- roundedTopRightboolean | number | string
- roundedTopLeftboolean | number | string
- roundedBottomLeftboolean | number | string
- roundedBottomRightboolean | number | string
- roundedStartStartboolean | number | string
- roundedStartEndboolean | number | string
- roundedEndStartboolean | number | string
- roundedEndEndboolean | number | string
- elevationTElevation
- Box-shadow elevation override for the match card.
- borderboolean | number | string | TDirectionBoth | Array<TDirectionBoth>
- borderColorstring
- borderTopboolean | number | string
- borderLeftboolean | number | string
- borderBottomboolean | number | string
- borderRightboolean | number | string
- borderBlockboolean | number | string
- borderInlineboolean | number | string
- borderBlockStartboolean | number | string
- borderBlockEndboolean | number | string
- borderStylestring
- borderTopColorTColor
- borderRightColorTColor
- borderBottomColorTColor
- borderLeftColorTColor
- borderBlockStartColorTColor
- borderBlockEndColorTColor
- density
- Controls card and competitor row padding. compact: 56px min-height, comfortable: 88px.
- heightnumber | string
- maxHeightnumber | string
- maxWidthnumber | string
- minHeightnumber | string
- minWidthnumber | string
- widthnumber | string
- paddingboolean | number | string
- paddingTopboolean | number | string
- paddingLeftboolean | number | string
- paddingBottomboolean | number | string
- paddingRightboolean | number | string
- paddingBlockboolean | number | string
- paddingInlineboolean | number | string
- paddingInlineStartboolean | number | string
- paddingInlineEndboolean | number | string
- paddingBlockStartboolean | number | string
- paddingBlockEndboolean | number | string
- marginboolean | number | string
- marginTopboolean | number | string
- marginLeftboolean | number | string
- marginBottomboolean | number | string
- marginRightboolean | number | string
- marginBlockboolean | number | string
- marginInlineboolean | number | string
- marginInlineStartboolean | number | string
- marginInlineEndboolean | number | string
- marginBlockStartboolean | number | string
- marginBlockEndboolean | number | string
API
Slots
Content slots exposed by this component.
- #competitor
- Override the rendering of each competitor row. Used twice (side A and B). Receives competitor data, the match, winner flag and side identifier.
API
Emits
Events emitted by this component.
- @clickIBracketMatch, MouseEvent
- Fired on card click (not inside a competitor row). Receives the match payload and the native event.
- @competitor-clickIBracketCompetitor, IBracketMatch, 'A' | 'B', MouseEvent | KeyboardEvent
- Fired when a competitor row is clicked. Receives the competitor, match, side ("A" or "B") and the event.
- @winner-clickIBracketCompetitor, IBracketMatch, MouseEvent | KeyboardEvent
- Fired additionally when the clicked competitor is the winner of the match.
- @update:activeany
- @update:hoverboolean
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.
- Default width of the match card.
- Minimum card height. compact: 56px, comfortable: 88px.
- Card border-radius.
- Card border color.
- Card surface background color.
- Transition duration for background-color, border-color and box-shadow on hover.
Inclusion
Accessibility
ARIA roles, keyboard navigation and focus management. Sourced from the real component template.
ARIA roles
Keyboard interactions
| Key | Action |
|---|---|
| Tab | Moves focus into the match card and through each competitor row. |
Notes
- The root has aria-label="Match: A versus B" computed from competitor names.
- The "Watch live" link opens in a new tab with rel="noopener noreferrer" for security.
- Status badges (LIVE, Completed…) are preceded by a colored dot using ::before — no alt text needed as the text label is present.
- LIVE badge animation (blink + ping) is disabled under prefers-reduced-motion: reduce.
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.
Basic match card
Live match with watch link
Ecosystem
Family
Components from the same folder that share conventions and often compose together.