Tableau de phase finale
Le tableau d’une phase à élimination directe, de la phase choisie (par exemple les 1/8 de finale)
jusqu’à la finale : une colonne par tour, chaque paire d’oppositions reliée à celle du tour suivant
qu’elle alimente. Chaque opposition montre ses deux équipes et leur score à chaque match (aller puis
retour, ou le seul match de la finale), les tirs au but entre parenthèses ; le qualifié est en gras,
l’éliminé en gris, et une équipe pas encore connue s’affiche « À déterminer ». La petite finale
(phase thirdPlace de /v1/seasons/{id}) n’est pas un tour du tableau. Football.
Le widget montre quatre tours de front à partir de 960 px de large, deux à partir de 640 px, un seul en dessous ; les flèches du bandeau des tours, ou un glissement du doigt, font défiler les autres.
<div data-idalgo-component="Bracket" data-idalgo-param-season="362903" data-idalgo-param-phase="585203"></div><script src="https://delivery.idalgo.live/sdk/v1.js" async></script>Paramètres
Section intitulée « Paramètres »| Paramètre | Obligatoire | Description | Exemple |
|---|---|---|---|
season |
Oui | Saison (currentSeason.id de /v1/competitions) |
362903 |
phase |
Oui | Premier tour du tableau : une phase format: knockout de /v1/seasons/{id} |
585203 |
density |
Non | compact : cartes resserrées et toujours deux tours de front, pour une colonne latérale ; par défaut, regular |
compact |
lang |
Non | Langue des noms (défaut fr) ; l’interface reste en français (voir Langue) |
en |
mode |
Non | Mode : light (défaut), dark ou auto, qui suit le réglage de l’appareil du lecteur ; par défaut, celui de votre thème (voir Mode sombre) |
dark |
live |
Non | false : coupe le direct de ce widget ; par défaut, celui de votre offre |
false |
Liens vers les matchs
Section intitulée « Liens vers les matchs »Avec un gabarit de lien contest (voir Liens vers vos pages),
toute la carte d’une opposition mène à la page d’un de ses matchs : celui qui se joue, sinon le
prochain à jouer, sinon le dernier (le match retour, ou la finale).
En direct
Section intitulée « En direct »Le tableau se met à jour seul, sans recharger la page : scores, cumuls, tirs au but et qualifiés, y compris l’équipe qui rejoint le tour suivant. Il commence à se relire 90 minutes avant le prochain coup d’envoi (s’il a lieu dans les 24 heures), au rythme indiqué par l’API (toutes les 10 secondes pendant un match de football, toutes les minutes tant qu’il reste des matchs à venir), et s’arrête quand tous les matchs du tableau sont terminés. Un onglet de navigateur caché ne relit rien ; il se remet à jour dès qu’il redevient visible.
Sans direct, selon votre offre ou avec live=false, le widget reste tel qu’affiché ; un match en
cours le signale, avec l’heure des données et un bouton « Actualiser » (voir Direct).
Erreurs et états
Section intitulée « Erreurs et états »En erreur, le widget n’est pas rendu : le SDK affiche « Impossible de charger le widget », avec un
bouton « Réessayer » si l’erreur est passagère (réseau, serveur), ou appelle votre onError (voir
SDK) ; en intégration côté serveur,
la réponse porte le statut, un message et un code stable { "error": "…", "code": "…" }.
| Statut | Cas | Code de l’API |
|---|---|---|
400 |
season ou phase absent ou non numérique ; lang ou mode invalide |
invalid-request |
404 |
Saison inconnue | season-not-found |
404 |
Phase absente de la saison | phase-not-found |
404 |
Phase qui n’est pas à élimination, ou sport sans tableau | bracket-unavailable |
502 |
API iDalgo injoignable ou réponse non conforme | — |
Un tableau sans aucun tour affiche « Le tableau n’est pas encore connu. ».
En direct, une relecture en échec est retentée 30 secondes plus tard, et le widget garde les dernières données affichées.
Le widget lit le module GET /modules/bracket/v1,
puis, pendant les matchs, sa route live
GET /modules/bracket/v1/live : les mêmes
données sont disponibles en JSON pour vos propres interfaces.