Javascript / Events References

This guide describes how to make further modifications to the Main Widget using Javascript. This may require a listening event to ensure JS is properly run after the Widget has loaded.

In This Guide

• Adding The Listening Event Code

Listening for Events

Events are dispatched on document. Attach listeners to document:

function addEventListenerStamped(el, eventName, handler) {
   if (el.addEventListener) { el.addEventListener(eventName, handler); }
   else { el.attachEvent('on' + eventName, function () { handler.call(el); }); }
}
// Example: listen for the reviews widget loaded event
addEventListenerStamped(document, 'stamped:reviews:loaded', function(e) {
  console.log(e);
});

You can also use the built-in helper:

StampedFn.on('stamped:reviews:loaded', function(e) {
  console.log(e);
});

Events

Reviews & Questions

Photos / UGC submission

UGC / Photo Modal (Lightbox)

Initialisation

Loyalty Launcher Events - ownership decision needed

The bundle dispatches these events, but they belong to the rewards/loyalty launcher.

JS Methods

Methods are split into two groups: developer-facing methods that are safe to call directly (with examples), and UI-triggered handlers that the widget calls via its own rendered markup and generally should not be called by hand.

Group 1 - Developer-facing methods (safe to call directly)

Group 2 - UI-triggered handlers (called by the widget, not usually by hand)

These methods are wired to the widget's own rendered controls (via inline onclick) and generally should not be called directly. Where an argument is shown, it is the DOM element that triggered the action.