Aller au contenu

Direct

Quatre widgets suivent les matchs en direct, sans recharger la page : la feuille de match, la liste de matchs, le Score Center et le tableau de phase finale. Les autres widgets affichent les données de leur rendu.

Un widget commence à se relire 90 minutes avant le coup d’envoi (heure de publication des compositions), puis au rythme que donne l’API : toutes les minutes avant le match, toutes les 10 secondes pendant un match de football (voir Cache et fraîcheur). Il s’arrête de lui-même quand ses matchs sont terminés. Un onglet de navigateur caché ne relit rien ; il se remet à jour dès qu’il redevient visible. Une relecture en échec est retentée 30 secondes plus tard, et le widget garde les dernières données affichées.

Le direct est actif quand votre offre l’inclut, pour tous ces widgets ou pour certains d’entre eux. Il est rattaché à votre identifiant client : sans identifiant, le direct est actif.

Pour le couper sur un widget, passez live à false :

<div
data-idalgo-component="MatchSheet"
data-idalgo-param-contest="54732603"
data-idalgo-param-live="false"
></div>

En JavaScript, params: { live: "false" } ; en intégration côté serveur, live=false dans la query string. live=true ne donne pas le direct sans votre offre.

Le widget reste tel qu’il a été affiché. Quand un de ses matchs se joue :

  • le badge du match dit « EN COURS » au lieu de « EN DIRECT » (feuille de match, liste de matchs, Score Center) ;
  • un bandeau donne l’heure à laquelle le widget a été affiché, « Mis à jour à 21:14 », et un bouton « Actualiser ».

Avec le SDK, « Actualiser » relit le widget à sa place, sans recharger la page. En intégration côté serveur, le bouton émet l’événement DOM idalgo:refresh, qui remonte depuis le widget : interceptez-le pour relire le fragment vous-même, sinon la page se recharge.

document.addEventListener("idalgo:refresh", (event) => {
event.preventDefault(); // la page ne se recharge pas
const widget = event.target.closest("[data-component]");
// relire /render/<Widget> et remplacer le fragment
});