I traguardi forniti appaiono come una roadmap, storia datata o fasi di progetto disegnate in scala. Pochi traguardi usano un carattere più grande e molti lo stringono, il prossimo traguardo è evidenziato con Oggi segnato accanto, e una pagina di vari traguardi adatta le parole alla pagina. Primetime aggiunge un conteggio in su, una linea che si disegna e ingressi sfalsati dei traguardi, accenti ciano sulla timeline, uno sfondo lento con treppiede da rilevatore e segnali silenziosi a mezzanotte locale ai confini datati. La precisione della data esistente, i flag di completamento forniti, il progresso di fase e le regole di paginazione restano invariati.
Live card
Categoria: Eventi. Tag: Programmazioni, Conti alla rovescia e timer, Uffici e luoghi di lavoro, Hall e reception.
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
Questa scheda usa le proprietà configurate e i dati live della 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 | Un’intestazione. |
mode | string | "roadmap" | "roadmap", "history", "phases" | roadmap: fatto, oggi e prossimo. history: gli anni, grandi. phases: barre in scala con il progresso del progetto. |
showNow | boolean | true | Un indicatore Oggi su una tabella di marcia. | |
pageSeconds | integer | 12 | minimo: 4; massimo: 60 | Quanto dura ogni pagina di traguardi quando ce ne sono più di quanti ne entrano. |
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 |
|---|---|---|---|---|
items | array | [{"date":"2026-03-02","title":"Kickoff","detail":"Team, scope and budget agreed."},{"date":"2026-05-18","title":"Design complete","detail":"Screens signed off by operations."},{"date":"2026-07-27","title":"Alpha","detail":"Internal pilot on two floors."},{"date":"2026-09-14","title":"Pilot opens","detail":"Three sites go live."},{"date":"2026-11-06","title":"Beta launch","detail":"Every site, with the new dashboard."},{"date":"2027-01-18","title":"General availability","detail":"Open to all customers."},{"date":"2027-03-29","title":"Integrations","detail":"Calendar and payroll connect."},{"date":"2027-06-14","title":"Version 2","detail":"Mobile and an open API."}] | minItems: 0; maxItems: 24 | Traguardi (o, in modalità fasi, fasi con una fine). Una data è AAAA, YYYY-MM o YYYY-MM-DD. |
items[].date | string | maxLength: 10; Obbligatorio | ||
items[].end | stringa, nullo | null | maxLength: 10 | Modalità fasi: l’ultimo giorno della fase. |
items[].title | string | minLength: 1; maxLength: 48; Obbligatorio | ||
items[].detail | string | "" | maxLength: 120 | |
items[].icon | null, stringa | null | null, "activity-01", "air-vent", "airplane-01", "alert-01", "alert-02", "american-football", "analytics-up", "apple", "arrow-down-01", "arrow-down-right-01", "arrow-up-01", "arrow-up-right-01", "award-01", "baseball", "basketball-01", "battery-full", "bell-ring", "bicycle", "birthday-cake", "bitcoin", "bus-01", "calendar-03", "calendar-04", "calendar-add-01", "calendar-check", "call-02", "camera-01", "cancel-circle", "car-01", "champion", "chart-decrease", "chart-increase", "checkmark-circle-02", "clock-01", "clock-02", "cloud", "cloud-angled-rain", "cloud-angled-zap", "cloud-big-rain", "cloud-drizzle", "cloud-fog", "cloud-hailstone", "cloud-snow", "coffee-01", "coffee-02", "contact-01", "container-truck-01", "cricket-bat", "crown", "delivery-truck-01", "dices", "discord", "discount-tag-01", "dollar-02", "door-closed-locked", "door-open", "drink", "droplet", "ethereum", "euro", "exchange-01", "facebook-01", "factory", "fast-wind", "favourite", "ferry-boat", "fire", "fire-02", "first-aid-kit", "flag-01", "flag-02", "flash", "flower-01", "football", "gauge", "gift", "git-branch", "globe-02", "google", "hand-prayer", "heart", "help-circle", "home-01", "hourglass", "humidity", "ice-hockey", "information-circle", "instagram", "lamp-01", "lantern", "leaf-01", "leaf-02", "lightbulb", "link-01", "linkedin-01", "litecoin", "location-01", "location-04", "mail-01", "medal-first-place", "medical-mask", "meeting-room", "megaphone-01", "message-01", "money-exchange-02", "moon-02", "moon-cloud", "moon-star", "music-note-01", "navigation-03", "new-releases", "new-twitter", "news", "news-01", "noodles", "package-delivered", "parking-area-square", "party", "party-popper", "pause-circle", "percent-circle", "pinterest", "pizza-01", "play-circle", "play-store", "podium", "pound", "pumpkin", "qr-code", "qr-code-01", "queue-01", "quote-down", "quote-up", "ranking", "restaurant-01", "rocket-01", "rss", "running-shoes", "sale-tag-01", "security-check", "shop-sign", "shopping-bag-01", "siren", "smart-phone-01", "snapchat", "snowflake", "sparkles", "spotify", "star", "star-half", "star-off", "stop-circle", "store-01", "sun-03", "sun-cloud-02", "sunrise", "sunset", "swimming", "tag-01", "target-02", "temperature", "tennis-ball", "thermometer", "thermometer-cold", "thermometer-warm", "threads", "ticket-01", "tiktok", "time-quarter-pass", "timer-01", "tornado-02", "train-01", "tram", "trophy", "tropical-storm", "tsunami", "user-02", "user-group", "user-love-01", "vegetarian-food", "volleyball", "volume-high", "vote", "walking", "warehouse", "waves", "whatsapp", "wheat-off", "wifi-01", "wifi-full-signal", "wifi-lock", "wrench-01", "yen", "youtube" | |
items[].done | boolean | false | Segna un traguardo completato indipendentemente dalla data. |
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 timeline --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": "timeline",
"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:
{
"items": [
{
"date": "2026-03-02",
"title": "Kickoff",
"detail": "Team, scope and budget agreed."
},
{
"date": "2026-05-18",
"title": "Design complete",
"detail": "Screens signed off by operations."
},
{
"date": "2026-07-27",
"title": "Alpha",
"detail": "Internal pilot on two floors."
},
{
"date": "2026-09-14",
"title": "Pilot opens",
"detail": "Three sites go live."
},
{
"date": "2026-11-06",
"title": "Beta launch",
"detail": "Every site, with the new dashboard."
},
{
"date": "2027-01-18",
"title": "General availability",
"detail": "Open to all customers."
},
{
"date": "2027-03-29",
"title": "Integrations",
"detail": "Calendar and payroll connect."
},
{
"date": "2027-06-14",
"title": "Version 2",
"detail": "Mobile and an open API."
}
]
}
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":{"items":[{"date":"2026-03-02","title":"Kickoff","detail":"Team, scope and budget agreed."},{"date":"2026-05-18","title":"Design complete","detail":"Screens signed off by operations."},{"date":"2026-07-27","title":"Alpha","detail":"Internal pilot on two floors."},{"date":"2026-09-14","title":"Pilot opens","detail":"Three sites go live."},{"date":"2026-11-06","title":"Beta launch","detail":"Every site, with the new dashboard."},{"date":"2027-01-18","title":"General availability","detail":"Open to all customers."},{"date":"2027-03-29","title":"Integrations","detail":"Calendar and payroll connect."},{"date":"2027-06-14","title":"Version 2","detail":"Mobile and an open API."}]}}'