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
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
| Nome | Tipo | Predefinito | Valori e limiti | Descrizione |
|---|---|---|---|---|
title | string | "" | maxLength: 40 | Vuoto usa il nome della lega. |
count | integer | 10 | minimo: 1; massimo: 24 | Squadre mostrate dall’alto della classifica; una favorita sotto la soglia prende l’ultimo posto. |
group | string | "" | maxLength: 40 | Il nome di un gruppo (una conferenza, una divisione). Pagine vuote scorrono ogni gruppo. |
favourite | string | "" | maxLength: 8 | Il codice breve di una squadra; la sua riga è evidenziata e il suo gruppo resta sullo schermo. |
showForm | boolean | true | Mostra gli ultimi risultati di ogni squadra. | |
pageSeconds | integer | 12 | minimo: 5; massimo: 60 | Secondi in cui ogni gruppo rimane visibile durante la paginazione. |
sport | string | "other" | "hockey", "soccer", "basketball", "football", "baseball", "other" | |
hour12 | boolean | false | ||
timeZone | stringa, nullo | null | ||
backgroundColor | stringa, nullo | null | modello: "^#[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. |
textColor | stringa, nullo | null | modello: "^#[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
| Nome | Tipo | Predefinito | Valori e limiti | Descrizione |
|---|---|---|---|---|
league | oggetto, null | null | additionalProperties: false | La competizione a cui si riferisce la classifica; il suo nome è il titolo quando title è vuoto. Prevale quella del feed. |
league.name | string | maxLength: 60; Obbligatorio | ||
season | string | "" | maxLength: 20 | La stagione, ad esempio 2026–27; prevale quella del feed. |
zones | array | [] | minItems: 0; maxItems: 4 | Nomi per la legenda delle barre colorate, uno per tipo; prevalgono quelli del feed. |
zones[].kind | string | "champion", "qualify", "playoff", "relegation"; Obbligatorio | ||
zones[].label | string | maxLength: 40 | ||
groups | array | [] | minItems: 0; maxItems: 20 | Le classifiche, gli stessi gruppi del feed screenrig.standings/v1 groups. Un feed prevale se presente; altrimenti il data store fornisce le stesse righe. |
groups[].name | string | maxLength: 40 | Una conferenza, una divisione o un gruppo. Un nome uguale a quello della lega non viene mostrato. | |
groups[].rows | array | minItems: 0; maxItems: 40; Obbligatorio | ||
groups[].rows[].rank | integer | minimo: 1; massimo: 999 | La posizione nel gruppo; le righe che non ne hanno una mantengono il proprio ordine. | |
groups[].rows[].team | object | additionalProperties: false; Obbligatorio | ||
groups[].rows[].team.name | string | maxLength: 60; Obbligatorio | ||
groups[].rows[].team.short | string | maxLength: 8 | Il codice breve della squadra, con cui viene confrontata la squadra preferita della scheda. Senza codice la scheda prende tre lettere dal nome. | |
groups[].rows[].played | integer | minimo: 0; massimo: 999 | Partite giocate; se non indicato, la somma dei risultati. | |
groups[].rows[].won | integer | minimo: 0; massimo: 999 | ||
groups[].rows[].wonOt | integer | minimo: 0; massimo: 999 | Vittorie ai supplementari o ai rigori, conteggiate con won nella colonna W. | |
groups[].rows[].drawn | integer | minimo: 0; massimo: 999 | Pareggi, o tie (la colonna T del football americano). | |
groups[].rows[].lost | integer | minimo: 0; massimo: 999 | ||
groups[].rows[].otl | integer | minimo: 0; massimo: 999 | Sconfitte ai supplementari o ai rigori. | |
groups[].rows[].diff | integer | minimo: -9999; massimo: 9999 | Differenza reti o punti. | |
groups[].rows[].points | number | minimo: -999; massimo: 9999 | Punti; una penalizzazione può portare una squadra sotto 0. | |
groups[].rows[].pct | number | minimo: 0; massimo: 1 | La quota di partite vinte, da 0 a 1, disegnata come .732. La sua colonna compare quando nessuna riga ha punti. | |
groups[].rows[].form | stringa o array | anyOf: [{"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[].zone | string | "champion", "qualify", "playoff", "relegation" | Colora la barra della riga: champion, qualify, playoff o relegation. | |
updatedAt | string | "" | maxLength: 40 | Quando è 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":""}}'