CAP alert card

The screen shows emergency and public alerts in the sender's own words, most severe first, with each long alert shown in parts so nothing is cut off. It fills the whole screen, sits in the middle, tucks into a corner, runs as one line in a corner, or stretches as a band along an edge. You set your alert sources, the screen's location, the severities to show, your preferred languages, whether the card stays up with a calm status when no alert applies, and how long each alert stays up.

Live card

This card is drawn in your browser by the same code the Players run, with sample data.

Category: Public information. Tags: Alerts and status, Schools and campuses, Offices and workplaces, Lobbies and reception.

Layouts

This core card fits every layout: full screen, center, corner, chip, strip, or any free rectangle.

Layouts: full, center, corner, chip, strip. Forms: landscape, portrait, square, strip.

Card layouts, themes and publishing. Browse the cards.

Data and privacy

Feed: screenrig.cap/v1.

Feed documents carry source attribution. The Player supplies the feed to the card.

Properties

For theme, background, accent and position, see Common properties.

Set static properties in params. Bind data to a project card data key for live values; that document holds only dynamic properties. Without a data key, put the complete configuration in params. Nested rows describe the contents of their parent property.

Static properties

Name	Type	Default	Values and limits	Description
`title`	string	`""`	maxLength: `60`	Names the card when it keeps a calm status. Empty reads "Alerts".
`presence`	string	`"active"`	`"active"`, `"always"`	`active` shows the card only while an alert applies. `always` keeps a calm status when none does: no active alerts, not updated since, no alert source.
`sources`	array	`[]`	maxItems: `5`	CAP sources: an http or https URL (port 80 or 443) of a CAP 1.0 to 1.2 alert, or of an ATOM or RSS index of alerts. Each URL is fetched once a minute for every screen that names it. Empty reads the public alert feeds that cover `location` (NWS, Canada NAAD, and MeteoAlarm for a location with area codes).
`publicAlerts`	boolean, null	`null`		Also read the public feeds that cover `location`. Null is true without `sources` and false with them.
`location`	object		additionalProperties: `false`	Where the screen is. Alerts whose area is a polygon or circle show when it holds this point; alerts told by area code show when `geocodes` shares a code. Without it every alert of the sources shows.
`location.name`	string		maxLength: `40`
`location.latitude`	number		minimum: `-90`; maximum: `90`; Required
`location.longitude`	number		minimum: `-180`; maximum: `180`; Required
`location.geocodes`	array	`[]`	maxItems: `40`	Area codes of the place, matched against alerts that name their area by code: [{"name": "UGC", "value": "WAC033"}].
`location.geocodes[].name`	string		minLength: `1`; maxLength: `40`; Required	The code system: SAME, UGC, NUTS3, EMMA_ID.
`location.geocodes[].value`	string		minLength: `1`; maxLength: `120`; Required
`minSeverity`	string		`"minor"`, `"moderate"`, `"severe"`, `"extreme"`	Hide alerts below this severity. Unset shows every severity.
`maxSeverity`	string		`"minor"`, `"moderate"`, `"severe"`, `"extreme"`	Hide alerts above this severity: a corner or strip for lesser alerts leaves the severe ones to a full-screen placement.
`minUrgency`	string		`"past"`, `"future"`, `"expected"`, `"immediate"`
`minCertainty`	string		`"unlikely"`, `"possible"`, `"likely"`, `"observed"`
`events`	array		maxItems: `30`	Only these events (case-insensitive; * matches any run of characters).
`excludeEvents`	array		maxItems: `30`
`senders`	array		maxItems: `30`	Only alerts from these senders (case-insensitive; * allowed).
`statuses`	array		maxItems: `4`	Which CAP statuses show. Unset is Actual only: tests and exercises show only when listed.
`scopes`	array		maxItems: `3`	Which CAP scopes show. Unset is Public.
`languages`	array		maxItems: `30`	Language preference, first wins (fr, fr-CA, en). The alert's text in the first language it has is shown; an alert in none of them shows its first language.
`areaUnknown`	string	`"hide"`	`"hide"`, `"show"`	An alert told only by area codes the location has none of: hide it, or show it.
`hourCycle`	string	`"24"`	`"12"`, `"24"`, `"military"`	12: 2:05 PM. 24: 14:05. military: 1405 HRS.
`timeZone`	string, null	`null`		IANA zone; null uses the screen's zone.
`pageSeconds`	integer	`12`	minimum: `6`; maximum: `60`	How long each alert, and each part of a long one, stays up before the next.
`staleMinutes`	integer	`30`	minimum: `10`; maximum: `1440`	A document not refreshed for this long reads as not updated, whatever its state says.

Dynamic properties

This card has no dynamic properties.

Canvas example

Add this item to a playlist page’s primitives. Publish the playlist and assign a screen.

{
  "id": "cap-alert",
  "primitive": "card",
  "card": "cap-alert",
  "major": 1,
  "params": {
    "theme": "neomustard",
    "location": {
      "name": "Vancouver",
      "latitude": 49.25,
      "longitude": -123.0
    }
  },
  "rect": {
    "x": 0,
    "y": 0,
    "width": 1920,
    "height": 1080
  },
  "layer": 0,
  "content_fit": "fill"
}