Skip to Content
EmbedsLift list

Lift list

<ullr-lift-list> is the lift equivalent of the trail list: every lift with its current status, type, carrier capacity and vertical, sortable by whichever columns you allow.

The Ullr lift list embed
The lift list showing status, name, type and capacity.

Install

<script type="module" src="https://widget.ullr.ski/web-components/ullr-lift-list.js"></script> <ullr-lift-list apiKey="1a2b3c4d5e6f.yourPublishableKey" areaId="your-area-id" sport="SNOW" visibleColumns="status,name,liftType,carrierCapacity" ></ullr-lift-list>

Required scopes

lifts:read and resorts:read.

Lift data comes from Ullr’s GIS module, so the area’s subscription must include GIS. A key with lifts:read at an area without the GIS module gets a 403.

Columns

KeyShows
statusRunning / on hold / closed indicator
nameLift name
liftTypeLift type — labelled Type in the dashboard
carrierCapacityPeople per carrier — labelled Capacity
verticalVertical rise

The dashboard turns on status,name,liftType,carrierCapacity and leaves vertical off.

Attributes

Lift list options

visibleColumnsstringOptional
Comma-separated list of columns to show, in the order given. Valid values: status, name, liftType, carrierCapacity, vertical. The dashboard labels the last three Type, Capacity and Vertical.
Default: all columns, in the order above
sortableColumnsstringOptional
Comma-separated subset of the same column keys that a visitor may click to re-sort.
Default: every visible column
sortColumnsstringOptional
Initial sort, as comma-separated column:direction pairs, e.g. status:asc,name:asc. Anything other than desc is treated as ascending.
Default: status:asc,name:asc
autoScrollbooleanOptional
Loop-scroll the lift list continuously. Built for TVs and kiosks where nobody is there to scroll.
Default: false
autoScrollSpeednumberOptional
Scroll speed in pixels per second. Values of zero or less fall back to the default. Only used when autoScroll is on.
Default: 30
autoScrollPageDurationnumberOptional
How long to pause on each screenful, in milliseconds, before scrolling on. Values of zero or less fall back to the default. Only used when autoScroll is on.
Default: 10000
scalenumberOptional
Visual zoom multiplier for the whole list. Use 2 or 3 on a large display so the text is readable from across the room.
Default: 1
enableEventsLiftSelectionbooleanOptional
Emit and listen for cross-element ullr-lift-select events, so two Ullr embeds on the same page stay in sync when a lift is selected.
Default: false

Common attributes

Shared by all four embeds.

apiKeystringRequired
Your publishable API key, in the form {id}.{secret}. Sent as the api-key header on every request the element makes. Without it the element logs an error and renders nothing.
areaIdstringRequired
The area (resort) to display. Without it the element logs an error and renders nothing.
sportSNOW | BIKEOptional
Which sport’s data to show. Also selects the default colour palette — blue for snow, green for bike.
Default: SNOW
themestringOptional
Primary colour as a hex value, e.g. #6B8CF9. Three- or six-digit hex only; anything else is ignored and the sport default is used. The secondary colour is derived automatically.
Default: #6B8CF9 (snow) / #50A162 (bike)
timestampnumberOptional
Show the hill as it was at this moment, in milliseconds since the Unix epoch, instead of live. Ignored unless your key holds the matching history scope.
ullrKeystringOptional
Legacy alias for apiKey, kept so older snippets keep working. Only read when apiKey is absent. Use apiKey in new code.

Notes

  • There is no units attribute on the lift list. Vertical always renders in feet. The trail list’s units does not apply here.
  • Auto-scroll, scroll speed, page duration and scale behave exactly as they do on the trail list, which makes a paired trail-and-lift board on one TV straightforward.