Events
Display JavaScript API emits custom events that can be listened to on the document root
The Display JavaScript API emits custom events to the document root so that you can keep track of changes to the Display API instance.
This event is emitted when the Display JavaScript API has successfully instantiated and populates the global scope with the
iPaperDisplayApi
object. At this point of time, all magic commands for the Display JavaScript API is accessible.document.addEventListener('iPaperDisplayApiReady', function () {
// At this point in time, window.iPaperDisplayApi is available in the global scope
window.iPaperDisplayApi.show();
});
This event is emitted when the Display JavaScript API has successfully loaded a Display instance and the instsance is now visible and ready to be interacted with. At this point, the user should be able to interact (scroll, click, etc.) with the Display instance shown on the side.
document.addEventListener('iPaperDisplayInstanceReady', function () {
// At this point in time, the Display Instance is ready to be interacted with
});
Note:
Due to the nature of the UI/UX of Display, the
iPaperDisplayInstanceReady
event is only fired if your user is originating from a desktop or tablet device. Mobile devices are redirected to the actual URL of the Display, where interaction with the API is not possible.