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.

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 nothing else — the list reads the lifts endpoint and never asks for the area itself.

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

Key	Shows
`status`	Running / on hold / closed indicator
`name`	Lift name
`liftType`	Lift type — labelled Type in the dashboard
`carrierCapacity`	People per carrier — labelled Capacity
`vertical`	Vertical rise

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

Attributes

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. Setting it switches this element onto the history endpoints, so the key needs lifts:readHistory. The live scope is not enough on its own: without the history scope the request is refused and the embed renders empty, with no error shown to your visitors.

ullrKeystringOptional

Legacy alias for apiKey, kept so older snippets keep working. Only read when apiKey is absent. Use apiKey in new code.

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

Take part in cross-element selection — emit and listen for ullr-lift-selected, so embeds on the same page stay in sync when a lift is selected. Switches on both directions at once.

Default: false

Events

Set enableEventsLiftSelection="true" and the list joins the page-wide selection channel — it announces what a visitor tapped, and highlights whatever another embed selects. The one attribute switches on both directions. Lift selections travel on their own event name, so they never disturb a trail list sitting alongside. See syncing embeds with events for the protocol and worked examples.

Emitted

ullr-lift-selecteddetail: { liftId: string, senderId: string }

A visitor tapped a row. Requires enableEventsLiftSelection.

Listened for

ullr-lift-selecteddetail: { liftId: string, senderId: string }

Highlights that lift’s row and scrolls it to the middle of the list, unless it is already in view. Skipped while an autoScroll animation is running.

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.