Events and Listeners

Default/Standard Events:

Songbird augments the standard DOM events you can attach listeners to via document.addEventListener().  Specifically, Songbird handles the following additional events.

¹ Note: These get called even when the new track is the same as the last track played

² Note: This is in Songbird 0.6 and higher only.

 Example:

var currentTrack;
var handleEvent = function(event) {
    if (event.type == "beforetrackchange") {
      alert("Ah... " + event.item.getProperty('http://songbirdnest.com/data/1.0#artistName') +
            ".  Weren’t they a one hit wonder?”);
    } else if (event.type == "trackchange") {
      alert(“Where’d you find “ +
            event.item.getProperty('http://songbirdnest.com/data/1.0#trackName') +
            “?  I thought they burned all the copies of that.”);
      // cache the track for further look-up if you like
      currentTrack = event.item;
    }
}

document.addEventListener("beforetrackchange", handleEvent, false);
document.addEventListener("trackchange", handleEvent, false);

Custom/Command Events:

For every command you define (via songbird.commands.addCommand()), you can define custom events to be fired when that command is initiated.  For example, to define your own command and associate code to be executed when the command is fired:

var onMyCommand = function onMyCommand(event) {
    if (event.type == "my-command") {
        alert("Yay.  My command event fired.");
    }
}

document.addEventListener( "my-command", onMyCommand, true );

songbird.commands.addCommand("action", "my-command",
    "My Command", "Execute my whizzy command");