up.Layer up.Layer.prototype.on(types, [selector], [options], listener)

Class method

Listens to a DOM event that originated on an element contained by this layer.

This will ignore events emitted on elements in descendant overlays, even if the descendant overlay's element is nested into the DOM tree of this layer.

The arguments for this function are the same as for up.on().

Example

let rootLayer = up.layer.root
let overlay = await up.layer.open()

rootLayer.on('foo', (event) => console.log('Listener called'))

rootLayer.emit('foo') // logs "Listener called"
overlay.emit('foo')   // listener is not called

Most Unpoly events have a layer reference

Whenever possible Unpoly will emit its events on associated layers instead of document. This way you can listen to events on one layer without receiving events from other layers.

E.g. to listen to all requests originating from a given layer:

let rootLayer = up.layer.root
let rootLink = rootLayer.affix('a[href=/foo]')

let overlay = await up.layer.open()
let overlayLink = overlay.affix('a[href=/bar]')

rootLayer.on('up:request:load', (event) => console.log('Listener called'))

up.follow(rootLink)    // logs "Listener called"
up.follow(overlayLink) // listener is not called