Scheda classifiche

Classifica che mostra punti, differenza reti, forma e linee di qualificazione per le squadre fornite dall’host.

Le classifiche di lega fornite appaiono con record, punti, forma recente, zone di qualificazione e favoriti, attraverso gruppi rotanti e viste d’angolo. Primetime introduce molle a righe sfalsate, accenti ciano per stati normali e uno sfondo lento con podio e classifica. La retrocessione e le sconfitte usano l’ambra, mentre parentesi condivise con kit sportivo segnano il leader della zona titolo fornita. Un piccolo segnale indica aggiornamenti passati del feed, cambi di gruppo e passaggi d’angolo a cinque secondi. Classifica, selezione colonne, fissaggio favoriti e paginazione mantengono le regole esistenti. Una tabella oltre quattordici righe si divide in pagine bilanciate che si alternano con i gruppi, alcune squadre riempiono lo schermo a dimensione maggiore, ogni nome condivide una dimensione e va a capo sulle parole, e un feed di un giorno precedente mostra il suo giorno e segnala la sua età. Con movimento ridotto, si mostra un fermo composto.

Live card

Questa scheda viene disegnata nel browser con lo stesso codice usato dai Player, con dati di esempio.

Categoria: Sport. Tag: Classifiche e posizioni, Sport di squadra, Scuole e campus.

Layout

Questa scheda a schermo intero riempie tutto lo schermo in orizzontale o verticale e non è posizionata come angolo, chip o striscia.

Layout: pieno. Moduli: orizzontale, verticale.

Layout, temi e pubblicazione delle schede. Esplora le schede.

Dati e privacy

Feed: screenrig.standings/v1.

I documenti del feed riportano l’attribuzione della fonte. Il Player fornisce il feed alla scheda.

Proprietà

Per tema, sfondo, accento e posizione, vedi Proprietà comuni.

Imposta le proprietà statiche nei params della scheda quando la crei. Il suo documento dati contiene solo proprietà dinamiche. Le righe annidate descrivono il contenuto della proprietà genitore.

Proprietà statiche

NomeTipoPredefinitoValori e limitiDescrizione
titlestring""maxLength: 40Vuoto usa il nome della lega.
countinteger10minimo: 1; massimo: 24Squadre mostrate dall’alto della classifica; una favorita sotto la soglia prende l’ultimo posto.
groupstring""maxLength: 40Il nome di un gruppo (una conferenza, una divisione). Pagine vuote scorrono ogni gruppo.
favouritestring""maxLength: 8Il codice breve di una squadra; la sua riga è evidenziata e il suo gruppo resta sullo schermo.
showFormbooleantrueMostra gli ultimi risultati di ogni squadra.
pageSecondsinteger12minimo: 5; massimo: 60Secondi in cui ogni gruppo rimane visibile durante la paginazione.
sportstring"other""hockey", "soccer", "basketball", "football", "baseball", "other"
hour12booleanfalse
timeZonestringa, nullonull
backgroundColorstringa, nullonullmodello: "^#[0-9A-Fa-f]{6}([0-9A-Fa-f]{2})?$"Sovrascrive il colore di sfondo e della piastra della scheda con un colore piatto ordinato in CSS. #RRGGBBAA fornisce l’opacità. background none ha la precedenza.
textColorstringa, nullonullmodello: "^#[0-9A-Fa-f]{6}([0-9A-Fa-f]{2})?$"Sovrascrive i colori del testo principale e secondario. I colori di accento e di stato semantico mantengono i loro ruoli.

Proprietà dinamiche

NomeTipoPredefinitoValori e limitiDescrizione
leagueoggetto, nullnulladditionalProperties: falseLa competizione a cui si riferisce la classifica; il suo nome è il titolo quando title è vuoto. Prevale quella del feed.
league.namestringmaxLength: 60; Obbligatorio
seasonstring""maxLength: 20La stagione, ad esempio 2026–27; prevale quella del feed.
zonesarray[]minItems: 0; maxItems: 4Nomi per la legenda delle barre colorate, uno per tipo; prevalgono quelli del feed.
zones[].kindstring"champion", "qualify", "playoff", "relegation"; Obbligatorio
zones[].labelstringmaxLength: 40
groupsarray[]minItems: 0; maxItems: 20Le classifiche, gli stessi gruppi del feed screenrig.standings/v1 groups. Un feed prevale se presente; altrimenti il data store fornisce le stesse righe.
groups[].namestringmaxLength: 40Una conferenza, una divisione o un gruppo. Un nome uguale a quello della lega non viene mostrato.
groups[].rowsarrayminItems: 0; maxItems: 40; Obbligatorio
groups[].rows[].rankintegerminimo: 1; massimo: 999La posizione nel gruppo; le righe che non ne hanno una mantengono il proprio ordine.
groups[].rows[].teamobjectadditionalProperties: false; Obbligatorio
groups[].rows[].team.namestringmaxLength: 60; Obbligatorio
groups[].rows[].team.shortstringmaxLength: 8Il codice breve della squadra, con cui viene confrontata la squadra preferita della scheda. Senza codice la scheda prende tre lettere dal nome.
groups[].rows[].playedintegerminimo: 0; massimo: 999Partite giocate; se non indicato, la somma dei risultati.
groups[].rows[].wonintegerminimo: 0; massimo: 999
groups[].rows[].wonOtintegerminimo: 0; massimo: 999Vittorie ai supplementari o ai rigori, conteggiate con won nella colonna W.
groups[].rows[].drawnintegerminimo: 0; massimo: 999Pareggi, o tie (la colonna T del football americano).
groups[].rows[].lostintegerminimo: 0; massimo: 999
groups[].rows[].otlintegerminimo: 0; massimo: 999Sconfitte ai supplementari o ai rigori.
groups[].rows[].diffintegerminimo: -9999; massimo: 9999Differenza reti o punti.
groups[].rows[].pointsnumberminimo: -999; massimo: 9999Punti; una penalizzazione può portare una squadra sotto 0.
groups[].rows[].pctnumberminimo: 0; massimo: 1La quota di partite vinte, da 0 a 1, disegnata come .732. La sua colonna compare quando nessuna riga ha punti.
groups[].rows[].formstringa o arrayanyOf: [{"type":"string","maxLength":20},{"type":"array","maxItems":20,"items":{"enum":["W","D","L"]}}]Gli ultimi risultati, dal meno recente, ne vengono mostrati cinque: una stringa come WWDLW (le altre lettere vengono ignorate) o un elenco di W, D e L.
groups[].rows[].zonestring"champion", "qualify", "playoff", "relegation"Colora la barra della riga: champion, qualify, playoff o relegation.
updatedAtstring""maxLength: 40Quando è stata recuperata la classifica, ISO 8601 (solo data store; un feed riporta fetchedAt).

Esempio di canvas

Salva le proprietà statiche come params.json e crea la scheda. Il risultato contiene il suo ID crd_.

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

Aggiungi questo elemento ai primitives di una pagina playlist, con quell’ID al posto di quello dell’esempio. Pubblica la playlist e assegna uno schermo.

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

Scrivere dati live

Scrivi il documento nella scheda dopo averla creata, poi sostituiscilo per aggiornare lo schermo senza ripubblicare. La scheda controlla ogni scrittura rispetto alle sue proprietà dinamiche e rifiuta un documento che non accetta. Usa lo stesso progetto della playlist.

Salva il documento come card-data.json. Il CLI legge il documento stesso, senza wrapper:

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

Oppure chiamare direttamente l’API. L’API incapsula lo stesso documento in un campo document. Un token agente nomina già il suo progetto, quindi non viene inviato un header progetto; se invii ScreenRig-Project, deve corrispondere al progetto del token. Fornisci l’autorizzazione API tramite l’ambiente; vedi Autenticazione 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":""}}'