Carte des classements

Tableau de ligue affichant les points, la différence de buts, la forme et les lignes de qualification pour les équipes fournies par l’hôte.

Les classements de ligue fournis apparaissent avec les records, points, forme récente, zones de qualification et favoris, à travers des groupes rotatifs et vues d’angle. Primetime introduit des ressorts de rangées décalées, des accents cyan pour les états normaux, et un arrière-plan lent de podium et classement. La relégation et les défaites utilisent l’ambre, tandis que des crochets d’équipement sportif partagé marquent le leader de la zone de titre fournie. Un petit indice marque les mises à jour passées du flux existant, les changements de groupe et les transferts d’angle de cinq secondes. Classement, sélection de colonne, épinglage de favori et pagination conservent leurs règles existantes. Un tableau de plus de quatorze rangées se divise en pages équilibrées qui tournent avec les groupes, quelques équipes remplissent l’écran en plus grand, chaque nom partage une taille et se replie aux mots, et un flux d’un jour antérieur montre son jour et signale son âge. En mode mouvement réduit, une image fixe composée est affichée.

Carte en direct

Cette carte est dessinée dans votre navigateur par le même code que les lecteurs, avec des données d’exemple.

Catégorie : Sports. Étiquettes : Classements et positions, Sports d'équipe, Écoles et campus.

Mises en page

Cette carte plein écran occupe tout l’écran en mode paysage ou portrait et n’est pas placée en coin, puce ou bande.

Mises en page : pleine. Formes : paysage, portrait.

Mises en page, thèmes et publication des cartes. Parcourir les cartes.

Données et confidentialité

Flux : screenrig.standings/v1.

Les documents du flux portent une attribution de source. Le Player fournit le flux à la carte.

Propriétés

Pour le thème, l’arrière-plan, l’accent et la position, voir Propriétés communes.

Définissez les propriétés statiques dans les params de la carte lorsque vous la créez. Son document de données ne contient que des propriétés dynamiques. Les lignes imbriquées décrivent le contenu de leur propriété parente.

Propriétés statiques

NomTypePar défautValeurs et limitesDescription
titlestring""maxLength : 40Vide utilise le nom de la ligue.
countinteger10minimum : 1 ; maximum : 24Équipes affichées depuis le haut du tableau ; un favori sous la coupure prend la dernière place.
groupstring""maxLength : 40Le nom d’un groupe (une conférence, une division). Pages vides parcourant chaque groupe.
favouritestring""maxLength : 8Le code court d’une équipe ; sa ligne est mise en surbrillance et son groupe reste à l’écran.
showFormbooleantrueAfficher les derniers résultats de chaque équipe.
pageSecondsinteger12minimum : 5 ; maximum : 60Secondes pendant lesquelles chaque groupe reste affiché lors du défilement.
sportstring"other""hockey", "soccer", "basketball", "football", "baseball", "other"
hour12booleanfalse
timeZonechaîne, nulnull
backgroundColorchaîne, nulnullmotif : "^#[0-9A-Fa-f]{6}([0-9A-Fa-f]{2})?$"Remplace le fond et la plaque de la carte par une couleur plate ordonnée en CSS. #RRGGBBAA fournit l’opacité. background none a la priorité.
textColorchaîne, nulnullmotif : "^#[0-9A-Fa-f]{6}([0-9A-Fa-f]{2})?$"Remplace les couleurs du texte principal et secondaire. Les couleurs d’accentuation et de statut sémantique conservent leur rôle.

Propriétés dynamiques

NomTypePar défautValeurs et limitesDescription
leagueobjet, nulnulladditionalProperties : falseLa compétition à laquelle se rapporte le tableau ; son nom sert de titre lorsque title est vide. Celle du flux l’emporte.
league.namestringmaxLength : 60 ; Obligatoire
seasonstring""maxLength : 20La saison, par exemple 2026–27 ; celle du flux l’emporte.
zonesarray[]minItems : 0 ; maxItems : 4Noms de la légende des barres colorées, un par type ; ceux du flux l’emportent.
zones[].kindstring"champion", "qualify", "playoff", "relegation" ; Obligatoire
zones[].labelstringmaxLength : 40
groupsarray[]minItems : 0 ; maxItems : 20Les tableaux, les mêmes groupes que groups du flux screenrig.standings/v1. Un flux l’emporte lorsqu’il est présent ; le magasin de données fournit les mêmes lignes sinon.
groups[].namestringmaxLength : 40Une conférence, une division ou un groupe. Un nom identique à celui de la ligue n’est pas affiché.
groups[].rowsarrayminItems : 0 ; maxItems : 40 ; Obligatoire
groups[].rows[].rankintegerminimum : 1 ; maximum : 999La place dans le groupe ; les lignes qui n’en ont pas conservent leur ordre.
groups[].rows[].teamobjectadditionalProperties : false ; requis
groups[].rows[].team.namestringmaxLength : 60 ; Obligatoire
groups[].rows[].team.shortstringmaxLength : 8Le code court de l’équipe, auquel correspond le favori de la carte. Sans code, la carte prend trois lettres du nom.
groups[].rows[].playedintegerminimum : 0 ; maximum : 999Matchs joués ; la somme des résultats si omis.
groups[].rows[].wonintegerminimum : 0 ; maximum : 999
groups[].rows[].wonOtintegerminimum : 0 ; maximum : 999Victoires en prolongation ou en tirs de barrage, comptées avec won dans la colonne W.
groups[].rows[].drawnintegerminimum : 0 ; maximum : 999Matchs nuls, ou égalités (la colonne T du football).
groups[].rows[].lostintegerminimum : 0 ; maximum : 999
groups[].rows[].otlintegerminimum : 0 ; maximum : 999Défaites en prolongation ou en tirs de barrage.
groups[].rows[].diffintegerminimum : -9999 ; maximum : 9999Différence de buts ou de points.
groups[].rows[].pointsnumberminimum : -999 ; maximum : 9999Points ; une déduction peut faire passer une équipe sous 0.
groups[].rows[].pctnumberminimum : 0 ; maximum : 1La proportion de matchs gagnés, de 0 à 1, affichée sous la forme .732. Sa colonne s’affiche lorsqu’aucune ligne n’a de points.
groups[].rows[].formchaîne ou tableauanyOf : [{"type":"string","maxLength":20},{"type":"array","maxItems":20,"items":{"enum":["W","D","L"]}}]Les derniers résultats, du plus ancien au plus récent, cinq affichés : une chaîne comme WWDLW (les autres lettres sont ignorées) ou une liste de W, D et L.
groups[].rows[].zonestring"champion", "qualify", "playoff", "relegation"Colore la barre de la ligne : champion, qualify, playoff ou relegation.
updatedAtstring""maxLength : 40Moment où le tableau a été récupéré, ISO 8601 (magasin de données seulement ; un flux porte fetchedAt).

Exemple de canevas

Enregistrez les propriétés statiques comme params.json et créez la carte. Le résultat contient son identifiant crd_.

{
  "theme": "neomustard"
}
screenrig card create --type standings --major 1 --file params.json

Ajoutez cet élément aux primitives d’une page de liste de lecture, en remplaçant l’identifiant de l’exemple par celui de votre carte. Publiez la liste de lecture et assignez un écran.

{
  "id": "standings",
  "primitive": "card",
  "card": "crd_01EXAMPLECARD000000000",
  "layout": "full",
  "content_fit": "fill"
}

Écrire des données en direct

Écrivez le document dans la carte après l’avoir créée, puis remplacez-le pour mettre à jour l’écran sans republier. La carte vérifie chaque écriture par rapport à ses propriétés dynamiques et refuse un document qu’elle rejette. Utilisez le même projet que la liste de lecture.

Enregistrez le document sous card-data.json. La CLI lit le document lui-même, sans enveloppe :

{
  "league": null,
  "season": "",
  "zones": [],
  "groups": [],
  "updatedAt": ""
}
screenrig card data put crd_01EXAMPLECARD000000000 --file card-data.json

Ou appelez directement l’API. L’API enveloppe le même document dans un champ document. Un jeton agent nomme déjà son projet, donc aucun en-tête de projet n’est envoyé ; si vous envoyez ScreenRig-Project, il doit correspondre au projet du jeton. Fournissez votre autorisation API via l’environnement ; voir Authentification API.

curl --request PUT "https://api.screenrig.ai/api/cards/crd_01EXAMPLECARD000000000/data" \
  --header "Authorization: Bearer $SCREENRIG_TOKEN" \
  --header "Content-Type: application/json" \
  --data '{"document":{"league":null,"season":"","zones":[],"groups":[],"updatedAt":""}}'